Sign each request with a fresh HMAC signature. The cURL and HTTP header values in these pages are placeholders, not reusable credentials. For runnable signing code, use request signing examples.
/v2/polymarket surface serves Polymarket wallet and market analytics under a single Data API credential (analytics.read). Every route is fixed to the Polymarket venue — there is no venue parameter to pass.
Response conventions
These hold across every endpoint on this surface:- Numbers are exact decimal strings, never floating-point — USD amounts, prices and PnL as decimal strings, ratios (ROI, win rate) as
0–1decimals — so precision survives transit. - Timestamps are unix seconds (
computed_at,first_trade_at,last_trade_at, …). - Unknown is
null, never a fake0. A metric the source cannot compute isnull. In particularfees_paidisnullon the day windows andfees_refundedisnullon every window — this surface has no per-window fee split — so anullfee means unknown, not zero. - Cursor pagination. List endpoints return
pagination.pagination_key; pass it back as thepagination_keyquery parameter to get the next page.pagination.has_moretells you when to stop.
Endpoints
GET /v2/polymarket/leaderboard— wallets ranked for a window.GET /v2/polymarket/wallet/{wallet}— one wallet’s four-window profile.GET /v2/polymarket/wallets/profiles— a batch of wallet profiles.GET /v2/polymarket/markets/smart-activity— per-market smart-cohort aggregates.GET /v2/polymarket/positions— positions across every indexed wallet (documented alongside the canonical positions endpoint).