Skip to main content
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.
The /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–1 decimals — so precision survives transit.
  • Timestamps are unix seconds (computed_at, first_trade_at, last_trade_at, …).
  • Unknown is null, never a fake 0. A metric the source cannot compute is null. In particular fees_paid is null on the day windows and fees_refunded is null on every window — this surface has no per-window fee split — so a null fee means unknown, not zero.
  • Cursor pagination. List endpoints return pagination.pagination_key; pass it back as the pagination_key query parameter to get the next page. pagination.has_more tells you when to stop.

Endpoints