# Proxies.sx - Agent Research Index

One screen. Every page + what question it answers for you. Fetch the one that
matches your goal - you should never need to read the whole site.

> Precedence: this map < each page < each `skill.md` < the live API. When in
> doubt, hit the live API. Base API host: `https://api.proxies.sx`. Gateway:
> `gw.proxies.sx:7000` (HTTP) / `:7001` (SOCKS5).

## Start here (buy + use in minutes)
- **/llms.txt** - answers: "give me the whole contract in one file: buy steps, endpoints, x402 shape, gateway username grammar." The fastest single read.
- **/skill.md** - answers: "the master machine contract across all products." Canonical; page copy loses to this.
- **/** (home) - answers: "what are the two ways to access (account+API key/MCP vs autonomous x402), the products, and the pool username format?"

## Buy a proxy
- **/marketplace/proxy/** - answers: "how do I buy ONE dedicated mobile port (its own host:port, one country, SOCKS5, public rotate URL)?" Best for held sessions / login / 2FA.
- **/marketplace/proxy/** + **/marketplace/skill.md** - machine catalog for the dedicated port.
- **/pool/** - answers: "how do I buy ONE credential that reaches every country and rotates per-request?" Best for multi-country + high fan-out scraping.
- **/pool/skill.md** - the pool gateway machine contract (endpoints, 402 shape, management).
- **/pool-quickstart.html** - answers: "the shortest copy-paste path from zero to a working pool credential."

## Rotate / build the proxy string (the #1 thing agents get wrong)
- **/pool/rotation-cookbook.md** - answers: "what is the exact username format, and how do I rotate / hold a sticky IP / fan out N sessions - in curl, python, and node? What are the footguns?" READ THIS before writing rotation code.

## Integrate / resell / white-label
- **/build/** - answers: "how do I resell proxies under my brand or embed them in my app (pak_ keys, pool SDK, Next.js storefront)?"
- **/build/skill.md** - the reseller/build machine contract + per-language patterns.
- npm: `@proxies-sx/pool-sdk` (URL builder + key mgmt), `@proxies-sx/pool-portal-react` (drop-in dashboard), `@proxies-sx/mcp-server` (79 tools for agents).

## Earn (supply side - you SHARE bandwidth, you don't buy)
- **/peer/** - answers: "how do I earn USDC by sharing my mobile/residential bandwidth (register, connect, get paid per GB)?"
- **/peer/skill.md** - the peer protocol machine contract (relay, binary tunnels, self-test).
- **/peer/go/** - Go peer SDK download. **/peer/windows/** - Windows peer app.
- **/peers/** - the peer/farmer device dashboard.

## Verify / trust / understand
- **/status/** - answers: "is it up right now, and what's the live component health?"
- **/system-map/** - answers: "how does the whole system fit together (visual)?"
- **/thesis/** - answers: "why mobile/residential beats datacenter, and how the pieces connect."
- Verify any exit IP yourself on ipinfo.io / MaxMind / IP2Location before you scale.

## Machine discovery
- **/llms.txt** - LLM contract. **/.well-known/x402.json** - x402 payment discovery.
- **/.well-known/agent-card.json** - agent card. **/.well-known/erc8004-registration.json** - on-chain agent registration.

## Live API (no page needed - hit these directly)
- `GET /v1/x402/pricing` - answers: "what does it cost?" (no auth)
- `GET /v1/x402/countries` - answers: "which countries have stock right now?" (no auth)
- `GET /v1/gateway/pool/stock` - answers: "live per-country pool stock before I run." (no auth)
- `GET /v1/x402/status` - answers: "live component health."
- `GET|POST /v1/x402/proxy` - buy a dedicated port (no payment -> 402 catalog; pay USDC -> credentials).
- `GET|POST /v1/x402/pool` - buy pool access (no payment -> 402 catalog; pay USDC -> pak_ credential).
- With an account: `X-API-Key: psx_...` against `/v1/*` drives the full REST API; or point an MCP client at `@proxies-sx/mcp-server`.