First request: curl "https://api.proxies.sx/v1/x402/proxy?country=US&traffic=1&duration=3600" returns HTTP 402 with payment instructions. Pay USDC on-chain, retry with the Payment-Signature: <tx_hash> header, receive credentials. Full sequence.
Deep contract per product: Dedicated Port (this product), Pool Gateway Access, Peer Network (earn side).
Canonical contract: the per-product skill file (/marketplace/skill.md for this product, /pool/skill.md, /peer/skill.md; master: /skill.md). If this page disagrees with a skill file, the skill file wins. If a skill file disagrees with the live API, the live API wins.
One x402-gated endpoint. Request without payment, get the 402 payment requirements, pay USDC on-chain, retry with the tx hash.
# 1. Request a proxy (returns HTTP 402 with payment info)
curl "https://api.proxies.sx/v1/x402/proxy?country=US&traffic=1&duration=3600"
# 2. Send USDC to the recipient address, then retry with your tx hash
curl "https://api.proxies.sx/v1/x402/proxy?country=US&traffic=1&duration=3600" \
-H "Payment-Signature: YOUR_TX_HASH"
# Response: { proxy: { http, socks5, server, expiresAt }, traffic: { allocatedGB }, management: { sessionToken } }
# 3. Use the proxy
curl -x http://USERNAME:PASSWORD@HOST:HTTP_PORT https://api.ipify.orgcountry, traffic and duration are all required on the paid retry (a missing param returns HTTP 400, not a charge - your tx hash is not consumed by a validation error, so just retry with the same hash and the param added). Persist three things from the purchase response: the proxy credentials, the management.sessionToken (x402s_..., sent as the X-Session-Token header on every post-purchase management call - replace ports, top up, check credit), and your tx hash.
Three products, one payment protocol. Dedicated Port (/v1/x402/proxy) - your own port on one modem; buy path on this page, deep contract at /marketplace/proxy/. Pool Gateway Access (/v1/x402/pool) - one credential reaches every country in the tier via gw.proxies.sx:7000; a request without payment returns the 402 catalog; contract at /pool/. Peer Network - the earn side: register, share bandwidth, get paid per GB; contract at /peer/skill.md.
| Endpoint | Price | Description |
|---|---|---|
GET/POST /v1/x402/proxy | $4/GB | Real 4G/5G mobile proxy from 6 countries (US, GB, PL, FR, NL, GE (Georgia) - live set shifts with supply, see /v1/x402/countries). HTTP + SOCKS5, city/carrier targeting, on-demand IP rotation via the public rotate URL. Free port replacement (max 3) and session top-up. |
| Method | Endpoint | Purpose |
|---|---|---|
| GET | /v1/x402/manage/session | Session details |
| GET | /v1/x402/manage/session/credit | Remaining credit |
| POST | /v1/x402/manage/ports/replace | Replace offline port (free, max 3) |
| POST | /v1/x402/manage/ports/recreate | Recreate deleted port with remaining credit |
| GET | /v1/x402/manage/session/topup/calculate | Preview top-up cost |
| POST | /v1/x402/manage/session/topup | Add traffic ($4/GB) or duration (free; the Payment-Signature header is still required - send any placeholder value for $0 duration-only top-ups) |
| GET | /v1/rotate/:token | Rotate IP (no auth) |
| Type | Price/GB | Min Purchase |
|---|---|---|
| Shared | $4.00 | 0.1 GB ($0.40) |
Duration is always FREE - you only pay for traffic. Pay with USDC on Base (~2s, ~$0.01 gas) or Solana (~400ms, ~$0.0001 gas).
| Network | Recipient Wallet |
|---|---|
| Base (chainId 8453) | 0xF8cD900794245fc36CBE65be9afc23CDF5103042 |
| Solana | 6eUdVwsPArTxwVqEARYGCh4S2qwW2zCs7jSEDRpxydnv |
The earn side of the same network. AI agents and Android SDK devices register, share mobile/residential bandwidth, and get paid in USDC per GB. Rates depend on IP type (mobile > residential > datacenter) and are dynamic - read the earningsPerGB field returned at registration; never assume a fixed number. The full contract, protocol, and withdrawal rules live on the peer pages:
| Resource | URL |
|---|---|
| Buy a Dedicated Port | /marketplace/proxy/ |
| Pool Gateway Access | /pool/ |
| Master skill file | /skill.md |
| LLMs reference | /llms.txt |
| x402 discovery | /.well-known/x402.json |
| Peer Network | /peer/ |
| MCP server | npx -y @proxies-sx/mcp-server |
Support: maya@proxies.sx or Telegram - quote the req id from any error (CODE: message (req: uuid)).