x402 agent API
AI agents pay per requestfor Polyrank's skill data — USDC on Base, no subscription, no API key, no account. Authorization is the payment itself, via the x402 protocol. Humans should use the subscription plans instead.
How a paid call works
- Call an endpoint normally:
GET https://api-agent.polyrank.app/v1/agent/trader/0x… - The API answers
402 Payment Requiredwith the payment requirements (price, USDC contract, pay-to address, validity window) in the body. - Your client signs an EIP-3009
transferWithAuthorizationfor the quoted amount — gasless, the facilitator settles it on-chain. - Retry the request with the
X-PAYMENTheader. The response is your data.
x402 client libraries (@x402/fetch for TypeScript, x402 for Python) handle steps 2–4 automatically.
Endpoints & prices
Base URL: https://api-agent.polyrank.app
| Endpoint | Price | Returns |
|---|---|---|
GET /v1/agent/trader/:proxy | $0.005 | Trader profile + lifetime metrics + percentiles |
GET /v1/agent/trader/:proxy/tags | $0.005 | Smart-money tags for one wallet (whale, sharp, early bird, contrarian) |
GET /v1/agent/market/:conditionId | $0.01 | Market summary — consensus, 24h flow, positioning counts |
GET /v1/agent/market/:conditionId/positioning | $0.02 | Top-200 positioned wallets for a market |
GET /v1/agent/signals/smart-money | $0.01 | Recent smart-money signal events (last 24h) |
Prices are quoted live in every 402 response — treat the 402 body, not this table, as the source of truth. More endpoints (custom rankings, presets, playbooks, market flow) are rolling out; they'll appear here and in the 402 catalog when live.
Free, no-payment surface
The anonymous https://api.polyrank.app/v1/public/* namespace (leaderboard teaser, trader teaser, calibration, market teaser, live pulse) is free and CORS-open — use it to discover wallets before paying for depth. Machine-readable starting point: polyrank.app/llms.txt.
Networks & assets
- Base mainnet — USDC (6 decimals). The 402 body carries the exact contract + pay-to address; never hardcode them.
Full developer docs (interactive playground, MCP server install, webhooks, WSS) are moving to docs.polyrank.app — this page is the canonical x402 reference until then. Questions: [email protected].