Parameters
Every parameter is optional, but a request must be narrow enough to answer quickly. Send at least one of:addresstoken_idstart_blockandend_block, at most 300,000 blocks apartstart_timeandend_time, at most 7 days (604,800 seconds) apart
400 MISSING_SELECTIVE_FILTER, with one exception. A request with no parameters except limit, set to 100 or less, returns the newest activity across all of Polymarket. That form returns one page only: its next_cursor can’t be followed, so add a filter to page further.
Comma-separated event types, such as
TRADE. Values are case-sensitive and match event_type in the response.Only return activity at or after this time, as an RFC 3339 timestamp such as
2026-10-01T00:00:00Z or as Unix seconds.Only return activity at or after this Polygon block. Can’t be combined with
start_time or end_time. Mixing the two returns 422 CONFLICTING_FILTERS.Rows per page, up to
1000. See pagination.Response
How the data behaves
- One trade, several rows. A fill appears once for each side. The taker’s row and each maker’s row share a
transaction_hashandtoken_id. - Amounts are plain numbers.
price,amount_shares,amount_usdc, andfeeare JSON numbers already in shares and USDC, andamount_usdc / amount_sharesequalsprice. Positions and Balances are different: they return strings in raw units of 10^6. - Timestamps are Unix seconds.
block_timestampis an integer, not an RFC 3339 string as in the wallet feeds. - Recent results can change. Responses for an open window carry
Cache-Control: public, max-age=2. A request withend_timeorend_blockcarriespublic, max-age=300.