Programmatic SOCKS5 proxies built for autonomous AI agents. No dashboards. No humans. Just an API, a payment address, and instant proxy credentials.
No accounts to create, no dashboards to navigate. Your agent can provision a residential proxy in under 60 seconds.
POST /agents — get your API key instantly. No signups, no forms, no humans.
GET /packages — browse bandwidth packages with transparent per-GB pricing.
GET /currencies then POST /orders — select your preferred cryptocurrency to receive a payment address. Send BTC, ETH, SOL, or USDT.
Poll /orders/{id}/status — once confirmed, connect via SOCKS5 with your credentials.
Pay per gigabyte. No subscriptions, no commitments. Top up anytime with the same proxy credentials.
1 GB bandwidth
$10 / GB
5 GB bandwidth
$10 / GB
10 GB bandwidth
$10 / GB
Base URL: https://api.proxybase.xyz
Authentication: X-API-Key header
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/agents
{
"agent_id": "6xAMqAGN",
"api_key": "pk_c8c91c8a0e5b3e2c..."
}List all available proxy bandwidth packages with transparent pricing. Returns package IDs needed for order creation.
curl https://api.proxybase.xyz/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"
}
]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/currencies \\ -H "X-API-Key: pk_YOUR_KEY"
{
"currencies": ["btc", "eth", "sol", "usdttrc20", "ltc", ...]
}Purchase a proxy package. Creates a crypto payment invoice. Once the payment confirms on-chain, your SOCKS5 proxy credentials are provisioned automatically.
| Name | Required | Description |
|---|---|---|
package_id | Yes | Package ID, e.g. "us_residential_1gb" |
pay_currency | No | Crypto to pay with (default: "usdttrc20"). Use GET /currencies for valid values |
callback_url | No | Webhook URL for status notifications |
curl -X POST https://api.proxybase.xyz/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"
}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/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"
}
}Add more bandwidth to an existing order. Your proxy credentials stay the same — only the bandwidth allowance increases. Works on active or exhausted proxies.
| Name | Required | Description |
|---|---|---|
package_id | Yes | Bandwidth package to add |
pay_currency | No | Crypto to pay with. Use GET /currencies for valid values (default: "usdttrc20") |
curl -X POST https://api.proxybase.xyz/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": "usdttrc20",
"pay_amount": 10.15,
"additional_bandwidth_bytes": 1073741824,
"additional_price_usd": 10.00,
"status": "payment_pending"
}Let your AI assistant purchase and manage proxies through natural language. Works with Claude Desktop, Cursor, and any MCP client.
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.
{
"mcpServers": {
"proxybase": {
"command": "/path/to/proxybase-mcp"
}
}
}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 7 days 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.