v1

latestOpenAPI 3.0.32026-07-2618063.1 KB

Get Orders

Fetches order data with optional filtering by market, condition, token, time range, and user. Returns orders that match either primary or secondary token IDs for markets. If no filters provided, fetches the latest trades happening in real-time. Only one of market_slug, token_id, or condition_id can be provided.

get/polymarket/orders

Query parameters

market_slugstring

Example:bitcoin-up-or-down-july-25-8pm-et

Filter orders by market slug

condition_idstring

Example:0x4567b275e6b667a6217f5cb4f06a797d3a1eaf1d0281fb5bc8c75e2046ae7e57

Filter orders by condition ID

token_idstring

Example:58519484510520807142687824915233722607092670035910114837910294451210534222702

Filter orders by token ID

start_timeinteger

Example:1640995200

Filter orders from this Unix timestamp in seconds (inclusive)

end_timeinteger

Example:1672531200

Filter orders until this Unix timestamp in seconds (inclusive)

limitinteger

Example:50

Number of orders to return (1-1000)

pagination_keystring

Example:eyJibG9ja190aW1lc3RhbXAiOiIyMDI1LTAxLTE5VDEyOjAwOjAwLjAwMFoiLCJ0eF9oYXNoIjoiMHgxMjM0NTY3ODkwYWJjZGVmIiwibG9nX2luZGV4IjoxMCwidG90YWwiOjUxMDk2MTl9

Base64-encoded cursor for efficient pagination. Returned in the previous response's pagination object.

userstring

Example:0x7c3db723f1d4d8cb9c550095203b686cb11e5c6b

Filter orders by user (wallet address)

Response

Orders response with pagination

Example response

{
  "orders": [
    {
      "token_id": "58519484510520807142687824915233722607092670035910114837910294451210534222702",
      "token_label": "Yes",
      "side": "BUY",
      "market_slug": "bitcoin-up-or-down-july-25-8pm-et",
      "condition_id": "0x4567b275e6b667a6217f5cb4f06a797d3a1eaf1d0281fb5bc8c75e2046ae7e57",
      "shares": 4995000,
      "shares_normalized": 4.995,
      "price": 0.65,
      "block_number": 123456789,
      "log_index": 42,
      "tx_hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
      "title": "Will Bitcoin be above $50,000 on July 25, 2025 at 8:00 PM ET?",
      "timestamp": 1757008834,
      "order_hash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
      "user": "0x7c3db723f1d4d8cb9c550095203b686cb11e5c6b",
      "taker": "0x8d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e"
    }
  ],
  "pagination": {
    "limit": 50,
    "total": 1250,
    "has_more": true,
    "pagination_key": "eyJibG9ja190aW1lc3RhbXAiOiIyMDI1LTAxLTE5VDEyOjAwOjAwLjAwMFoiLCJ0eF9oYXNoIjoiMHgxMjM0NTY3ODkwYWJjZGVmIiwibG9nX2luZGV4IjoxMCwidG90YWwiOjUxMDk2MTl9"
  }
}