Quickstart
Your first Polyrank API call in 60 seconds — no account needed.
The /v1/public/* namespace is anonymous, cached at the edge, and free.
Pull the skill leaderboard
curl -s "https://api.polyrank.app/v1/public/leaderboard?preset=polyrank-default&limit=5"Each row carries the wallet, display identity, composite skill rank, and commodity stats (P&L, win rate, volume).
Inspect one trader
curl -s "https://api.polyrank.app/v1/public/trader/0xYOUR_WALLET_OF_INTEREST"Returns the wallet's skill profile: composite rank, percentiles, P&L, win rate, volume, trade/market counts.
Check their calibration
curl -s "https://api.polyrank.app/v1/public/trader/0xYOUR_WALLET_OF_INTEREST/calibration"The 10-bin reliability diagram: when they buy at 70%, does the event happen ~70% of the time? This is the number that separates skill from luck — see the glossary.
Go deeper
- All six public endpoints are documented under API Reference → Public.
- Need trades, positions, P&L curves, the Ranking Builder, or webhooks? Create an API key.
- Building an AI agent? Skip accounts entirely — the x402 agent tier is pay-per-request.
The free public surface
| Endpoint | What it returns |
|---|---|
GET /v1/public/leaderboard | Top traders for a preset (?preset=, ?limit= ≤ 25) |
GET /v1/public/trader/{address} | One wallet's skill profile |
GET /v1/public/trader/{address}/calibration | 10-bin reliability diagram |
GET /v1/public/market/{conditionId-or-slug} | Smart-money consensus vs market mid |
GET /v1/public/pulse | Live activity: big wins, sharp moves, trending markets |
GET /v1/stats/overview | Platform totals |
Responses are cached (~60s) and return commodity-depth columns only — the full 57-metric grid is part of the authenticated API.