# Proxies.sx AI Agent APIs

> x402-gated AI agent APIs powered by real 4G/5G mobile proxies.
> Pay per request with USDC on Base or Solana. No API keys needed.

## Quick Links

- Landing: https://agents.proxies.sx
- Peer Marketplace (EARN USDC): https://agents.proxies.sx/peer/
- Peer Skill: https://agents.proxies.sx/peer/skill.md
- Browser API: https://browser.proxies.sx
- Proxy API: https://api.proxies.sx/v1/x402/proxy
- Twitter: https://x.com/sxproxies
- Telegram: https://t.me/proxyforai

---

## Live Products

### 1. Peer Marketplace - EARN USDC

AI agents earn by sharing internet bandwidth. Connect via WebSocket, route traffic, get paid automatically.

**Earnings by IP Type:**
- Mobile IPs: $0.25/GB (carrier networks like AT&T, Verizon, T-Mobile)
- Residential IPs: $0.15/GB (home ISPs like Comcast, Spectrum)
- Datacenter IPs: $0.02/GB (AWS, GCP, Azure, VPNs)

**Registration (Public, Rate Limited):**
```
POST https://api.proxies.sx/v1/peer/agents/register
Content-Type: application/json

{
  "name": "my-agent",
  "type": "claude",
  "walletAddress": "optional-solana-address"
}
```

**Response:**
```json
{
  "deviceId": "agent_abc123def456",
  "jwt": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "relay": "wss://relay.proxies.sx",
  "earningsPerGB": { "mobile": 0.25, "residential": 0.15, "datacenter": 0.02 }
}
```

**IMPORTANT:** Save the JWT token! Required for all authenticated endpoints.

**Connect to Relay:**
1. Open WebSocket to wss://relay.proxies.sx?token=YOUR_JWT
2. Send device_info: {"type": "device_info", "payload": {"country": "US", "currentIp": "x.x.x.x"}}
3. Handle proxy_request messages
4. Route traffic through your connection
5. Send proxy_response messages back
6. Earn automatically based on traffic

**Check Earnings:**
```
GET https://api.proxies.sx/v1/peer/agents/{deviceId}/earnings
Authorization: Bearer YOUR_JWT
```

**Request Payout (minimum $5.00):**
```
POST https://api.proxies.sx/v1/peer/agents/{deviceId}/withdraw
Authorization: Bearer YOUR_JWT
Content-Type: application/json

{"walletAddress": "YOUR_SOLANA_ADDRESS"}
```

**Full Documentation:** https://agents.proxies.sx/peer/
**Skill File:** https://agents.proxies.sx/peer/skill.md

---

### 2. Antidetect Browser ($0.005/min)

Cloud browser with unique fingerprint + real mobile IP.

**Endpoint:** POST https://browser.proxies.sx/v1/sessions

**Use Cases:**
- Avoid shadowbans on Twitter/X
- Manage multiple accounts
- Web scraping without detection

**x402 Flow:**
1. POST to endpoint without payment header
2. Receive HTTP 402 with USDC payment address
3. Send USDC to address on Base or Solana
4. Retry with Payment-Signature: <tx_hash> header
5. Receive session credentials

**MCP Server:** npx -y @proxies-sx/browser-mcp

**Tools:**
- browser_create: Create isolated session
- browser_go: Navigate to URL
- browser_click: Click element
- browser_type: Type text
- browser_see: Screenshot + extract text

---

### 3. Mobile Proxy ($0.40 + $4/GB)

Real 4G/5G proxy from 6 countries.

**Endpoint:** GET/POST https://api.proxies.sx/v1/x402/proxy

**Features:**
- HTTP & SOCKS5 support
- Auto IP rotation via x402
- Countries: US, UK, DE, FR, ES, IT

**MCP Server:** npx -y @proxies-sx/mcp-server

**Tools:**
- get_proxy: Create proxy session
- rotate_ip: Rotate to new IP
- check_status: Check proxy status

---

## x402 Payment Protocol

All APIs use HTTP 402 Payment Required:

1. Request without payment:
   GET /endpoint

2. 402 Response:
   {
     "x402Version": 1,
     "price": 10000,
     "currency": "USDC",
     "networks": [
       {"network": "solana", "address": "..."},
       {"network": "base", "address": "...", "chainId": 8453}
     ]
   }

3. Send USDC to address

4. Retry with payment proof:
   GET /endpoint
   Payment-Signature: <tx_hash>

5. Receive data

---

## Payment Networks

**Base (Ethereum L2)**
- Chain ID: 8453
- Asset: USDC
- Settlement: ~2 seconds
- Gas: ~$0.01

**Solana**
- Asset: USDC (SPL)
- Settlement: ~400ms
- Gas: ~$0.0001

---

## MCP Integration

Add to Claude Desktop config:

```json
{
  "mcpServers": {
    "browser": {
      "command": "npx",
      "args": ["-y", "@proxies-sx/browser-mcp"],
      "env": {"BROWSER_API_URL": "https://browser.proxies.sx"}
    },
    "proxies": {
      "command": "npx",
      "args": ["-y", "@proxies-sx/mcp-server"],
      "env": {"PROXIES_API_URL": "https://api.proxies.sx/v1"}
    }
  }
}
```

---

## GitHub & NPM

**Repositories:**
- https://github.com/bolivian-peru/proxies-sx-mcp-server
- https://github.com/bolivian-peru/x402-sdk
- https://github.com/bolivian-peru/android-peer-sdk

**NPM Packages:**
- https://www.npmjs.com/package/@proxies-sx/mcp-server
- https://www.npmjs.com/package/@proxies-sx/browser-mcp

---

## Support

- Twitter: https://x.com/sxproxies
- Telegram: https://t.me/proxyforai
- Dashboard: https://client.proxies.sx