v1
latestOpenAPI 3.0.32026-07-2618063.1 KBGet Activity
Fetches activity data with optional filtering by user, market, condition, and time range. Returns trading activity including MERGES, SPLITS, and REDEEMS. Supports efficient cursor-based pagination for large datasets.
get/polymarket/activity
Query parameters
userstring
Example:0x7c3db723f1d4d8cb9c550095203b686cb11e5c6b
User wallet address to fetch activity for. If not provided, returns activity for all users.
start_timeinteger
Example:1640995200
Filter activity from this Unix timestamp in seconds (inclusive)
end_timeinteger
Example:1672531200
Filter activity until this Unix timestamp in seconds (inclusive)
market_slugstring
Example:bitcoin-up-or-down-july-25-8pm-et
Filter activity by market slug
condition_idstring
Example:0x4567b275e6b667a6217f5cb4f06a797d3a1eaf1d0281fb5bc8c75e2046ae7e57
Filter activity by condition ID
limitinteger
Example:50
Number of activities to return (1-1000)
pagination_keystring
Example:eyJibG9ja190aW1lc3RhbXAiOiIyMDI1LTAxLTE5VDEyOjAwOjAwLjAwMFoiLCJzaWRlIjoiU1BMSVQiLCJ0eF9oYXNoIjoiMHgxMjM0NTY3ODkwYWJjZGVmIiwibG9nX2luZGV4IjoxMCwidG90YWwiOjE5ODkwMTc3Nn0=
Base64-encoded cursor for efficient pagination. Returned in the previous response's pagination object.
Response
Activity response with pagination
Example response
{
"activities": [
{
"side": "REDEEM",
"market_slug": "will-the-doj-charge-boeing",
"condition_id": "0x92e4b1b8e0621fab0537486e7d527322569d7a8fd394b3098ff4bb1d6e1c0bbd",
"shares": 187722726,
"shares_normalized": 187.722726,
"price": 1,
"block_number": 123456789,
"log_index": 42,
"tx_hash": "0x028baff23a90c10728606781d15077098ee93c991ea204aa52a0bd2869187574",
"title": "Will the DOJ charge Boeing?",
"timestamp": 1721263049,
"user": "0xfd9c3e7f8c56eb4186372f343c873cce154b3873"
}
],
"pagination": {
"limit": 50,
"count": 1250,
"has_more": true,
"pagination_key": "eyJibG9ja190aW1lc3RhbXAiOiIyMDI1LTAxLTE5VDEyOjAwOjAwLjAwMFoiLCJzaWRlIjoiU1BMSVQiLCJ0eF9oYXNoIjoiMHgxMjM0NTY3ODkwYWJjZGVmIiwibG9nX2luZGV4IjoxMCwidG90YWwiOjE5ODkwMTc3Nn0="
}
}