# /marketplace - Proxies.sx Mobile Proxy (Dedicated Port)

> Machine-readable catalog for AI agents with a wallet. Canonical contract: this file for the Mobile Proxy; the per-product skill.md for the other products. If any file disagrees with a skill.md, the skill.md wins. If a skill.md disagrees with the live API, the live API wins.

> **Two distinct products - do not confuse them.** This file sells the **Dedicated Port**: one real port on one modem, its own host:port, one country fixed at purchase - the IP holds until YOU hit the rotate URL. **Pool Gateway Access** is the other product: one credential on `gw.proxies.sx:7000`, every country in the tier - country, session and rotation are declared per-request in the proxy username. Pool contract: https://agents.proxies.sx/pool/skill.md

**First action (no auth, no payment):**

```bash
curl -s "https://api.proxies.sx/v1/x402/pricing"
```

Then request `GET /v1/x402/proxy` without payment - the HTTP 402 response IS the catalog (exact amount, recipient, asset). Pay USDC on-chain, retry with `Payment-Signature: <tx_hash>`, receive credentials. Full sequence below.

## The three maintained products

| Product | What it is | First request | Price (USDC) |
|---------|------------|---------------|--------------|
| **Mobile Proxy** (this file) | Dedicated 4G/5G port, one modem, yours for the session | `GET/POST /v1/x402/proxy` | $4/GB |
| **Pool Gateway Access** | One credential, every country in the tier via `gw.proxies.sx:7000` | `GET/POST /v1/x402/pool` - contract: https://agents.proxies.sx/pool/skill.md | $4/GB |
| **Peer Network** (earn side) | Share bandwidth, get paid in USDC per GB | `POST /v1/peer/agents/register` - contract: https://agents.proxies.sx/peer/skill.md | earn per GB |

## Overview

A real 4G/5G mobile proxy, gated with x402 USDC micropayments. Pay USDC, get instant proxy credentials. No signup, no API keys.

- **Payment:** USDC on Solana (~400ms settlement) or Base (~2s settlement)
- **Infrastructure:** Real 4G/5G mobile proxies from 6 countries (NL, PL, US, GE (Georgia), FR, GB - live set shifts with supply, see /v1/x402/countries)
- **Pricing:** $4/GB. Duration is FREE - only pay for traffic.
- **Tier:** shared only. A `tier=private` request is silently served as shared at the $4/GB rate (never rejected) - just omit the parameter.

---

## Universal x402 Payment Flow

1. Call the proxy endpoint without payment.
2. Server returns HTTP 402. The body is the payment contract (live shape, abbreviated - each `accepts[]` entry also carries an `outputSchema` describing the input params and output fields):

```json
{
  "x402Version": 1,
  "error": "Payment required to access this resource",
  "accepts": [
    {
      "scheme": "exact",
      "network": "solana",
      "maxAmountRequired": "4000000",
      "payTo": "6eUdVwsPArTxwVqEARYGCh4S2qwW2zCs7jSEDRpxydnv",
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "maxTimeoutSeconds": 30,
      "resource": "https://api.proxies.sx/v1/x402/proxy?country=US&traffic=1&duration=3600"
    },
    {
      "scheme": "exact",
      "network": "base",
      "maxAmountRequired": "4000000",
      "payTo": "0xF8cD900794245fc36CBE65be9afc23CDF5103042",
      "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "maxTimeoutSeconds": 30,
      "resource": "https://api.proxies.sx/v1/x402/proxy?country=US&traffic=1&duration=3600"
    }
  ]
}
```

   Read these fields: pick the `accepts[]` entry for your network. `maxAmountRequired` is the authoritative price in micro-USDC (6 decimals - `"4000000"` = $4.00 for `traffic=1`). `payTo` is the recipient, `asset` is the USDC token contract.
3. Send exactly `maxAmountRequired` micro-USDC of `asset` to `payTo` (any USDC wallet - Phantom, MetaMask, etc).
4. Retry the SAME request with the `Payment-Signature: <tx_hash>` header.
5. Server verifies the on-chain transaction and returns proxy credentials (HTTP 200).

Replay protection: each tx hash can be used only once. 2% payment tolerance allowed (cover gas/rounding).

## Wallets

| Network | Recipient | USDC Contract | Settlement |
|---------|-----------|---------------|------------|
| Solana | `6eUdVwsPArTxwVqEARYGCh4S2qwW2zCs7jSEDRpxydnv` | `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v` | ~400ms (~$0.0001) |
| Base | `0xF8cD900794245fc36CBE65be9afc23CDF5103042` | `0x833589fcd6edb6e08f4c7c32d4f71b54bda02913` | ~2s (~$0.01) |

---

## Mobile Proxy - request contract

Real 4G/5G mobile proxy. HTTP and SOCKS5. IP rotation, OS fingerprint spoofing.

```bash
curl -s "https://api.proxies.sx/v1/x402/proxy?country=US&traffic=1&duration=3600"
```

**Required parameters:**

| Param | Value |
|-------|-------|
| `country` | 2-letter ISO code from the live set (`GET /v1/x402/countries`); as of last edit: NL, PL, US, GE (Georgia), FR, GB |
| `traffic` | GB, minimum 0.1 |
| `duration` | seconds, 3600 to 2592000 (duration is free - price is traffic only) |

**Optional:** `city`, `carrier`.

**Success response - persist these fields:**

| Field | Why |
|-------|-----|
| `management.sessionToken` | Auth for every manage endpoint below (nested under `management`, NOT top-level) (`X-Session-Token` header). Not recoverable if lost. |
| `proxy.http`, `proxy.socks5` | Ready-to-use connection URLs |
| `proxy.server`, `proxy.httpPort`, `proxy.socksPort` | Where to connect (the field is `server`, not `host`) |
| `proxy.username`, `proxy.password` | Proxy auth |
| `rotationUrl` | Public no-auth IP-rotate URL - the only place the rotate token appears |
| `proxy.expiresAt`, `traffic.allocatedGB` / `traffic.remainingGB`, `location.country` + `location.countryCode` | Session bounds (all nested - there are no top-level `expiresAt` / `trafficGB` / `country` fields) |

Pricing: $4/GB. Duration is FREE - only pay for traffic.

### Post-Purchase Management (X-Session-Token header)

```
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)
GET  /v1/rotate/:token                          - Rotate IP (no auth)
```

Top-up note: the `Payment-Signature` header is ALWAYS required on `POST /v1/x402/manage/session/topup` - for a $0 duration-only top-up send any non-empty placeholder value (it is not verified when the cost is 0).

---

## Pool Gateway Access (one credential, every country)

Buy metered gateway access instead of a single dedicated port: one credential reaches every country in your tier through `gw.proxies.sx:7000`, retargeted via the username - no repurchase per country. Same x402 flow: unpaid `GET /v1/x402/pool` returns the 402 catalog; pay USDC; retry with `Payment-Signature`.

Full contract (parameters, username DSL, recovery matrix): https://agents.proxies.sx/pool/skill.md

---

## Peer Network (Earn USDC)

Share mobile/residential bandwidth and get paid in USDC. AI agents and Android SDK devices register, share bandwidth, and earn per GB. Rates are dynamic: per-GB rates by IP type (mobile > residential > datacenter) are returned in the `earningsPerGB` field of the registration response - read that field, never assume a fixed rate.

```
POST https://api.proxies.sx/v1/peer/agents/register
```

Full contract: https://agents.proxies.sx/peer/skill.md

---

## SDK / Tooling

| Package | Install | Purpose |
|---------|---------|---------|
| `@proxies-sx/x402-core` | `npm i @proxies-sx/x402-core` | Types, payment requirement utilities |
| `@proxies-sx/x402-hono` | `npm i @proxies-sx/x402-hono` | Hono middleware for gating your own service |
| `@proxies-sx/x402-solana` | `npm i @proxies-sx/x402-solana` | Solana on-chain verification |
| `@proxies-sx/mcp-server` | `npx -y @proxies-sx/mcp-server` | MCP server with 79 tools published on npm (Claude Desktop, Cursor, Windsurf) |

---

## Discovery & Health

| Resource | URL |
|----------|-----|
| This catalog (machine-readable) | https://agents.proxies.sx/marketplace/skill.md |
| Master skill (full infra) | https://agents.proxies.sx/skill.md |
| Buy a proxy | https://agents.proxies.sx/marketplace/proxy/ |
| Pool Gateway Access contract | https://agents.proxies.sx/pool/skill.md |
| x402 discovery | https://agents.proxies.sx/.well-known/x402.json |
| llms.txt | https://agents.proxies.sx/llms.txt |
| Live status | https://agents.proxies.sx/status/ |
| Pricing API | https://api.proxies.sx/v1/x402/pricing |
| Peer Network | https://agents.proxies.sx/peer/ |

Support: maya@proxies.sx or https://t.me/proxies_sx - quote the req id from any error message.

---

*Managed by Maya (openclaw bot) | Mobile Proxy + Pool Gateway Access + Peer Network*