ProxyBase — AI Infrastructure for Agents

$ curl -X POST https://api.proxybase.xyz/v1/agents

$ curl https://api.proxybase.xyz/v1/currencies \

-H "X-API-Key: pk_..."

$ curl -X POST https://api.proxybase.xyz/v1/orders \

🤖

1

Register Agent

POST /v1/agents — get your API key instantly. No signups, no forms, no humans.

📦

2

Choose Package

GET /v1/packages — browse bandwidth packages with transparent per-GB pricing.

💰

3

Pay with Crypto

GET /v1/currencies then POST /v1/orders — select your preferred cryptocurrency to receive a payment address. Send BTC, ETH, SOL, or USDT.

🔌

4

Use Your Proxy

Poll /v1/orders/{id}/status — once confirmed, connect via SOCKS5 with your credentials.

Starter

1 GB bandwidth

$10 / GB

• US residential & mobile IPs
• SOCKS5 protocol
• Real-time bandwidth tracking
• Unlimited concurrent sessions
• No expiration date

Get Started →

Most Popular

Growth

5 GB bandwidth

$10 / GB

• Everything in Starter
• Best value for testing at scale
• Top-up anytime — same credentials
• Webhook notifications at 80% & 95%
• Priority bandwidth allocation

Get Started →

Scale

10 GB bandwidth

$10 / GB

• Everything in Growth
• Designed for production AI swarms
• Bulk bandwidth for long operations
• Same simple API — just bigger quota
• Enterprise-level throughput

Get Started →

POST/v1/agents

Register Agent

Register a new AI agent and receive an API key. This is the first step — all other endpoints require authentication via X-API-Key header.

curl -X POST https://api.proxybase.xyz/v1/agents

{
  "agent_id": "6xAMqAGN",
  "api_key": "pk_c8c91c8a0e5b3e2c..."
}

GET/v1/packages

List Packages

List all available proxy bandwidth packages with transparent pricing. Returns package IDs needed for order creation.

curl https://api.proxybase.xyz/v1/packages \
  -H "X-API-Key: pk_YOUR_KEY"

[
  {
    "id": "us_residential_1gb",
    "name": "US Residential 1GB",
    "bandwidth_bytes": 1073741824,
    "price_usd": 10.00,
    "proxy_type": "residential",
    "country": "US"
  }
]

GET/v1/currencies

List Currencies

List all available payment currencies (cryptocurrencies) that can be used for the pay_currency field when creating an order or topping up. Call this before creating an order to know which values are valid.

curl https://api.proxybase.xyz/v1/currencies \\
  -H "X-API-Key: pk_YOUR_KEY"

{
  "currencies": ["btc", "eth", "sol", "usdcsol", "ltc", ...]
}

POST/v1/orders

Create Order

Purchase a proxy package. Creates a crypto payment invoice. Once the payment confirms on-chain, your SOCKS5 proxy credentials are provisioned automatically.

curl -X POST https://api.proxybase.xyz/v1/orders \
  -H "X-API-Key: pk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"package_id":"us_residential_1gb","pay_currency":"sol"}'

{
  "order_id": "kQx7p3Wn",
  "payment_id": "5832461907",
  "pay_address": "TXyz...",
  "pay_currency": "sol",
  "pay_amount": 0.058,
  "price_usd": 10.00,
  "status": "payment_pending"
}

GET/v1/orders/{order_id}/status

Check Order Status

Poll the order status. Once status is "proxy_active", the response includes your SOCKS5 credentials (host, port, username, password). Status progression: payment_pending → confirming → paid → proxy_active → bandwidth_exhausted.

curl https://api.proxybase.xyz/v1/orders/kQx7p3Wn/status \
  -H "X-API-Key: pk_YOUR_KEY"

{
  "order_id": "kQx7p3Wn",
  "status": "proxy_active",
  "bandwidth_bytes": 1073741824,
  "used_bytes": 52428800,
  "remaining_bytes": 1021313024,
  "usage_percentage": 4.88,
  "proxy": {
    "host": "api.proxybase.xyz",
    "port": 1080,
    "username": "pb_a1b2c3d4e5f6g7h8",
    "password": "9f8e7d6c5b4a3210"
  }
}

POST/v1/orders/{order_id}/topup

Top Up Order

Add more bandwidth to an existing order. Your proxy credentials stay the same — only the bandwidth allowance increases. Works on active or exhausted proxies.

curl -X POST https://api.proxybase.xyz/v1/orders/kQx7p3Wn/topup \
  -H "X-API-Key: pk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"package_id":"us_residential_1gb"}'

{
  "order_id": "kQx7p3Wn",
  "topup_payment_id": "5832461999",
  "pay_address": "TXyz...",
  "pay_currency": "usdcsol",
  "pay_amount": 10.15,
  "additional_bandwidth_bytes": 1073741824,
  "additional_price_usd": 10.00,
  "status": "payment_pending"
}

POST/v1/orders/{order_id}/rotate

Rotate Proxy

Rotate the proxy to get a fresh IP address. Calls the upstream partner to invalidate the current session. Only works on orders with proxy_active status. Your next SOCKS5 connection will use a new IP.

curl -X POST https://api.proxybase.xyz/v1/orders/kQx7p3Wn/rotate \
  -H "X-API-Key: pk_YOUR_KEY"

{
  "order_id": "kQx7p3Wn",
  "message": "Proxy rotated successfully. You will receive a fresh IP on your next connection.",
  "rotated": true
}

One Binary, Seven Tools

The ProxyBase MCP server exposes the entire proxy lifecycle as tools. Download the binary, point it at your MCP client, and your AI can provision SOCKS5 proxies autonomously.

• register_agent — Get an API key instantly
• list_packages — Browse available bandwidth packages
• list_currencies — See valid payment currencies
• create_order — Generate a crypto payment invoice
• check_order_status — Poll until proxy is active
• topup_order — Add bandwidth without new credentials
• rotate_proxy — Get a fresh IP on your next connection

★ Get MCP Server from GitHub

ProxyBase is built exclusively for autonomous AI agents and M2M workflows. There's no web dashboard, no manual IP whitelisting, no human interaction required. Everything is automated through our REST API and MCP server. Your AI agent can register, purchase, and use proxies entirely programmatically.

We offer US residential and mobile SOCKS5 proxies. Our hybrid supply chain combines a proprietary B2C mobile fleet with aggregated B2B partner networks, giving you access to highly trusted residential IPs that are difficult to detect and block.

We accept cryptocurrency payments (USDC, USDT and many more) via Crypto. When you create an order, you receive a payment address. Once the blockchain confirms your transaction, your proxy credentials are provisioned automatically. No invoices, no manual approval.

No. Your proxy never expires based on time. It remains active until your purchased bandwidth is fully consumed. You can top up anytime to extend your bandwidth — the same proxy credentials continue working.

Yes. Each agent can create multiple orders and maintain multiple active proxies simultaneously. There's no limit on concurrent proxy sessions — perfect for AI swarms and parallel scraping operations.

If you send less than the required amount (partial payment), the system waits for the remainder within the 10 minutes time window. If you overpay, the excess is handled by our payment processor according to their standard policies.

Bandwidth is tracked in real-time at the byte level. The backend counts every byte passing through the SOCKS5 proxy. You can poll the order status endpoint at any time to see exact usage. If you provided a callback URL, you'll receive webhook notifications at 80% and 95% usage.

MCP (Model Context Protocol) is an open standard that lets AI assistants like Claude and Cursor interact with external tools. Our MCP server lets your AI purchase and manage proxies through natural language — no code needed. Just install the binary and your AI handles the rest.