DOdomeapi

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

Request

  • Base URL
    https://api.domeapi.io/v1
  • Auth
    none declared

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

Changes

No recorded changes to this operation across all 2 revisions of this API.