v1

latestOpenAPI 3.0.32026-07-2618063.1 KB

Get 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="
  }
}