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 a masked identity (an opaque tid plus middle-hidden wallet
label and name), composite skill rank, and commodity stats (P&L, win rate,
volume). Full wallet addresses live behind the authenticated API — if you
already know a wallet, look it up directly via /v1/public/trader/{address}.
Inspect one trader
curl -s "https://api.polyrank.app/v1/public/trader/0xf68A281980f8c13828e84e147e3822381d6e5B1B"Returns the wallet's skill profile: composite rank, percentiles, P&L, win rate, volume, trade/market counts. This demo wallet is a real top-2k trader — ~$667k lifetime P&L on a 23% win rate, the canonical proof that win rate isn't skill. Swap in any wallet you're curious about.
Check their calibration
curl -s "https://api.polyrank.app/v1/public/trader/0xf68A281980f8c13828e84e147e3822381d6e5B1B/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 77-metric grid is part of the authenticated API.