v1

latestOpenAPI 3.1.02026-07-2657157254.1 KB
polymarket

Get Activity

Fetch activity data for a specific user.

Returns SPLIT, MERGE, REDEEM, and CONVERT events from the unified activity table.

Note on CONVERT rows: these are NegRisk position conversions (sell NO tokens on a subset of conditions, buy YES tokens on the remainder). Their condition_id field actually carries the NegRisk parent market_id, not a CTF condition_id, so the Postgres market-metadata lookup will return empty market_slug/title for them. Filtering by condition_id will not match conversions — conversions are a market-level operation, not a per-outcome one.

get/v2/polymarket/activity

Query parameters

walletstring required

Wallet address

Wallet address

start_timeinteger nullable

Unix timestamp (seconds) for start

Unix timestamp (seconds) for start

end_timeinteger nullable

Unix timestamp (seconds) for end

Unix timestamp (seconds) for end

market_slugstring nullable

Filter by market slug

Filter by market slug

condition_idstring nullable

Filter by condition ID

Filter by condition ID

sort_by'timestamp' | 'type'

Sort options for activity.

Sort by: timestamp or type

limitinteger

Number of activities to return (1-500)

Number of activities to return (1-500)

order'asc' | 'desc'

Sort order direction enum.

Sort order: asc or desc

pagination_keystring nullable

Pagination key for cursor-based pagination

Pagination key for cursor-based pagination

Response

Successful Response