PROXIES.SX

Mobile proxy infrastructure for AI agents. Pay with USDC on-chain. No API keys needed.
69 endpoints
55 MCP tools
4 npm packages
6 live domains

Master Skill File: agents.proxies.sx/skill.md - everything in one read for AI agents

x402 PAYMENT PROTOCOL

HTTP 402 Payment Required for machine-to-machine USDC payments. No accounts, no API keys.

How It Works

1. Request without payment    GET /v1/x402/proxy?country=US&traffic=1
2. Receive 402 response       price, recipient wallet, supported networks
3. Send USDC on-chain         Base (~2s) or Solana (~400ms)
4. Retry with payment proof   Payment-Signature: <tx_hash>
5. Receive proxy credentials  host, port, username, password, session token

Payment Networks

NetworkSettlementGasUSDC ContractRecipient
Base (EVM)~2 sec~$0.010x833589fCD6eDb6E08f4c7C32D4f71b54bdA029130xF8cD900794245fc36CBE65be9afc23CDF5103042
Solana~400ms~$0.0001EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v6eUdVwsPArTxwVqEARYGCh4S2qwW2zCs7jSEDRpxydnv

Pricing

TypePrice/GBMin PurchaseDuration
Shared$4.000.1 GB ($0.40)Free (unlimited)

Quick Start

# 1. Request proxy (receive 402 with payment info)
curl -s https://api.proxies.sx/v1/x402/proxy?country=US&traffic=1

# 2. After sending USDC, retry with tx hash
curl -s https://api.proxies.sx/v1/x402/proxy?country=US&traffic=1 \
  -H "Payment-Signature: YOUR_TX_HASH"

# 3. Check session
curl -s https://api.proxies.sx/v1/x402/manage/session \
  -H "X-Session-Token: x402s_YOUR_TOKEN"

# 4. Replace offline port (free, max 3)
curl -s -X POST https://api.proxies.sx/v1/x402/manage/ports/replace \
  -H "X-Session-Token: x402s_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"country":"US"}'

# 5. Top up session (pay for more traffic)
curl -s -X POST https://api.proxies.sx/v1/x402/manage/session/topup \
  -H "X-Session-Token: x402s_YOUR_TOKEN" \
  -H "Payment-Signature: NEW_TX_HASH" \
  -H "Content-Type: application/json" \
  -d '{"addTrafficGB":2,"addDurationSeconds":86400}'

All x402 Endpoints

MethodPathAuthDescription
GET/v1/x402/pricing-Pricing tiers and structure
GET/v1/x402/countries-Available countries with device counts
GET/v1/x402/calculate-Calculate cost
GET/v1/x402/health-Service health
GET/v1/x402/info-Master info (pricing, countries, MCP)
GET/v1/x402/.well-known-Protocol discovery
GET/v1/x402/proxyx402Purchase mobile proxy
POST/v1/x402/proxyx402Purchase mobile proxy (POST)
GET/v1/x402/manage/sessionTokenSession details via token
GET/v1/x402/manage/session/creditTokenCheck remaining credit
GET/v1/x402/manage/portsTokenList all ports in session
GET/v1/x402/manage/ports/:portId/statusTokenPort status
POST/v1/x402/manage/ports/replaceTokenReplace offline port (free, max 3)
POST/v1/x402/manage/ports/recreateTokenRecreate deleted port with remaining credit
GET/v1/x402/manage/session/topup/calculateTokenPreview top-up cost
POST/v1/x402/manage/session/topupToken+x402Pay to extend session
GET/v1/x402/session/:id-Session by ID
GET/v1/x402/session/tx/:txHash-Session by transaction hash
GET/v1/x402/sessions/wallet/:wallet-Sessions by wallet address
POST/v1/x402/agents-Register agent
GET/v1/x402/agents/:wallet-Get agent by wallet
GET/rotate/:token-Rotate IP via public token

Token = X-Session-Token: x402s_<hex> header. x402 = Payment-Signature: <tx_hash> header.

Post-Purchase Management

Port Replacement - If proxy goes offline, POST /manage/ports/replace for free replacement. Max 3 per session.
Session Top-Up  - Add traffic ($4/GB) or duration (free). POST /manage/session/topup with Payment-Signature.
Port Recreation - If port deleted but session has credit, POST /manage/ports/recreate.
IP Rotation     - GET /rotate/:token to rotate IP without auth.

PRODUCTS

x402-gated mobile proxies at api.proxies.sx. Pay with USDC. Plus a Peer Network where agents and devices earn USDC by sharing bandwidth.

ProductEndpointPricePaymentStatus
Mobile Proxy GET /v1/x402/proxy $4.00/GB USDC on Base or Solana LIVE
Peer Network (earn) POST /v1/peer/agents/register earn per GB USDC payout LIVE

Mobile Proxy

Real 4G/5G proxy access from 6 countries (US, DE, GB, FR, ES, PL). HTTP and SOCKS5, city/carrier targeting, auto IP rotation. Free port replacement (max 3) and session top-up. Buy a proxy.

Pool Gateway Access

One USDC payment buys one credential that reaches every country in your tier through the shared Pool Gateway (gw.proxies.sx:7000) - no per-country repurchase. Metered and capped. v1 tier mbl (production modems), $4/GB. Buy at GET/POST /v1/x402/pool (no payment returns HTTP 402 with the tier catalog; pay USDC and retry to receive credentials). Quickstart.

Peer Network

Share mobile/residential bandwidth and earn USDC. Per-GB rates by IP type (mobile > residential > datacenter), returned in earningsPerGB at registration. Start earning.


MCP SERVER

@proxies-sx/mcp-server v2.0.0 - 73 tools for AI agents to manage proxy infrastructure via Model Context Protocol.

Install

npx -y @proxies-sx/mcp-server

Claude Desktop Config

// API Key mode (account required)
{
  "mcpServers": {
    "proxies-sx": {
      "command": "npx",
      "args": ["-y", "@proxies-sx/mcp-server"],
      "env": { "PROXIES_API_KEY": "psx_your_key" }
    }
  }
}

// x402 mode (no account needed)
{
  "mcpServers": {
    "proxies-sx": {
      "command": "npx",
      "args": ["-y", "@proxies-sx/mcp-server"],
      "env": { "AGENT_WALLET_KEY": "your_private_key", "PREFERRED_NETWORK": "base" }
    }
  }
}

Tool Categories (55 total)

CategoryCountKey Tools
Account2get_account_summary, get_account_usage
Port Mgmt7list_ports, create_port, delete_port, update_port_credentials, reconfigure_port
Port Status4get_port_status, get_port_ip, ping_port, speed_test_port
Rotation5rotate_port, configure_auto_rotation, get_rotation_history
Billing4get_pricing, calculate_price, purchase_traffic
Crypto Pay5create_crypto_payment, check_crypto_payment_status
Support5create_support_ticket, list_my_tickets, reply_to_ticket
x402 Session8get_x402_session, replace_x402_port, calculate_x402_topup, topup_x402_session
x402 Auto11x402_get_proxy, x402_wallet_balance, x402_rotate_ip, x402_extend_session
Utilities4get_proxy_connection_string, list_available_countries

PEER MARKETPLACE - EARN USDC

Share your internet bandwidth, get paid in USDC on Solana. AI agents and humans connect via WebSocket, route traffic, earn automatically.

Earnings by IP Type

IP TypeRate TierExamples
MobileHighestAT&T, Verizon, T-Mobile, Vodafone
ResidentialMidComcast, Spectrum, Cox, BT
DatacenterBaseAWS, GCP, Azure, Hetzner, VPNs

Per-GB earnings accumulate automatically. IP type determined server-side via ASN lookup. Min payout: $5 USDC.

How It Works

1. Register     POST /v1/peer/agents/register - get JWT + device ID
2. Connect      wss://relay.proxies.sx with Sec-WebSocket-Protocol: token.{JWT}
3. Tunnel       Receive tunnel_connect - open TCP to the target - stream bytes both ways
4. Earn         Earnings credited per GB. Request payout min $5 USDC to Solana wallet.

Fastest start - use a ready, tested SDK (it does the whole protocol for you): Node.js · Go · Windows · Android. Full guide at the Peer Network page. The inline snippets below are only for building your own client (and use streaming tunnel_connect, not the legacy proxy_request).

Register

curl -s -X POST https://api.proxies.sx/v1/peer/agents/register \
  -H "Content-Type: application/json" \
  -d '{
    "name":"my-agent",
    "type":"claude",
    "walletAddress":"YOUR_SOLANA_ADDRESS",
    "apiKey":"psx_YOUR_API_KEY"
  }'

# Response:
# { "deviceId": "agent_abc123", "jwt": "eyJ...", "refreshToken": "a1b2...",
#   "relay": "wss://relay.proxies.sx",
#   "earningsPerGB": { "mobile": <number>, "residential": <number>, "datacenter": <number> } }
#
# Per-GB rates are set by the platform - read earningsPerGB for live values.
# Tier order: mobile > residential > datacenter. Rates can change anytime.
# Min payout: $5 (agents) / $10 (Android SDK).
# JWT expires in 1h - refresh via POST /v1/peer/agents/{id}/refresh.

Connect to Relay

const ws = new WebSocket('wss://relay.proxies.sx', [`token.${JWT}`]);

ws.onopen = () => {
  ws.send(JSON.stringify({ type: 'device_info', payload: { country: 'US' } }));
};

ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);
  if (msg.type === 'proxy_request') {
    const { requestId, method, url, headers, body } = msg.payload;
    fetch(url, { method, headers, body: body ? atob(body) : undefined })
      .then(async (res) => {
        const buf = await res.arrayBuffer();
        ws.send(JSON.stringify({
          type: 'proxy_response',
          payload: { requestId, statusCode: res.status,
                     headers: Object.fromEntries(res.headers),
                     body: btoa(String.fromCharCode(...new Uint8Array(buf))) }
        }));
      });
  }
  if (msg.type === 'heartbeat') ws.send(JSON.stringify({ type: 'heartbeat_ack' }));
};

Peer API Endpoints

MethodEndpointAuthDescription
POST/v1/peer/agents/register-Register as peer (3/min rate limit)
POST/v1/peer/agents/:id/refreshRefreshRefresh JWT (expires 1h)
GET/v1/peer/agents/:id/statusJWTPeer status
GET/v1/peer/agents/:id/earningsJWTEarnings and traffic stats
PUT/v1/peer/agents/:id/walletJWTUpdate wallet (7-day cooling period)
POST/v1/peer/agents/:id/withdrawJWTRequest payout (min $5 USDC)

Security

FeatureValue
JWT expiry1 hour
Refresh token expiry7 days
Max WebSocket connections2 per device
Message rate limit100/min per device
Registration rate limit3/min per IP
Wallet change cooling7 days
IP classificationServer-side ASN lookup (cannot spoof)

Monthly Earnings Estimates

ConnectionAlways-OnPart-Time (8h/day)
Mobile 5G (US)$50-150$15-50
Residential (US)$30-80$10-30
Datacenter VPS$5-15$2-5

Android SDK

// build.gradle
implementation("com.github.bolivian-peru:android-peer-sdk:1.3.1")

// Usage
ProxiesPeerSDK.init(context, "api-key", config)
ProxiesPeerSDK.getInstance().start()  // Start sharing
ProxiesPeerSDK.getInstance().stop()   // Stop sharing


SDK & PACKAGES

npm Packages

PackageDescription
@proxies-sx/mcp-serverMCP server - 73 tools for proxy management
@proxies-sx/x402-corex402 types, utilities, payment requirement builder
@proxies-sx/x402-honox402 Hono middleware for building paywall APIs
@proxies-sx/x402-solanaSolana transaction verification for x402

GitHub

RepositoryDescription
proxies-sx-mcp-serverMCP server source
x402-sdkx402 payment protocol SDK
android-peer-sdkAndroid SDK for peer bandwidth sharing

Framework Integrations

FrameworkIntegrationDetails
MCPnpx @proxies-sx/mcp-server73 tools for Claude, Cursor, Windsurf

x402 SDK Example

import { createPaymentRequirement } from '@proxies-sx/x402-core';
import { x402Middleware } from '@proxies-sx/x402-hono';
import { verifySolanaPayment } from '@proxies-sx/x402-solana';

const app = new Hono();
app.use('/api/*', x402Middleware({
  price: 10000,  // $0.01 in micro-units
  recipient: 'YOUR_SOLANA_WALLET',
  verify: verifySolanaPayment,
}));
app.get('/api/data', (c) => c.json({ data: 'premium content' }));


Proxies.sx - Mobile proxy infrastructure for AI agents