Trade History

GET

polymarket

orders

Get Orders

curl --request GET \
  --url https://api.domeapi.io/v1/polymarket/orders

{
  "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,
      "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,
    "offset": 0,
    "total": 1250,
    "has_more": true
  }
}

Query Parameters

market_slug

string

Filter orders by market slug

Example:

"bitcoin-up-or-down-july-25-8pm-et"

condition_id

string

Filter orders by condition ID

Example:

"0x4567b275e6b667a6217f5cb4f06a797d3a1eaf1d0281fb5bc8c75e2046ae7e57"

token_id

string

Filter orders by token ID

Example:

"58519484510520807142687824915233722607092670035910114837910294451210534222702"

start_time

integer

Filter orders from this Unix timestamp in seconds (inclusive)

Example:

1640995200

end_time

integer

Filter orders until this Unix timestamp in seconds (inclusive)

Example:

1672531200

limit

integer

default:100

Number of orders to return (1-1000)

Required range: 1 <= x <= 1000

Example:

50

offset

integer

default:0

Number of orders to skip for pagination

Required range: x >= 0

Example:

0

user

string

Filter orders by user (wallet address)

Example:

"0x7c3db723f1d4d8cb9c550095203b686cb11e5c6b"

Response

Orders response with pagination

orders

object[]

Show child attributes

orders.token_id

string

Example:

"58519484510520807142687824915233722607092670035910114837910294451210534222702"

orders.token_label

string

Human readable label for this outcome (yes/no etc)

Example:

"Yes"

orders.side

enum<string>

Available options:

BUY,

SELL

Example:

"BUY"

orders.market_slug

string

Example:

"bitcoin-up-or-down-july-25-8pm-et"

orders.condition_id

string

Example:

"0x4567b275e6b667a6217f5cb4f06a797d3a1eaf1d0281fb5bc8c75e2046ae7e57"

orders.shares

number

Raw number of shares purchased (from the blockchain)

Example:

4995000

orders.shares_normalized

number

Number of shares purchased normalized (this is raw divided by 1000000)

Example:

4.995

orders.price

number

Price per share

Example:

0.65

orders.tx_hash

string

Transaction hash of the order

Example:

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12"

orders.title

string

Market title

Example:

"Will Bitcoin be above $50,000 on July 25, 2025 at 8:00 PM ET?"

orders.timestamp

integer

Unix timestamp in seconds when the order was placed

Example:

1757008834

orders.order_hash

string

Hash of the order

Example:

"0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"

orders.user

string

Maker address of the order

Example:

"0x7c3db723f1d4d8cb9c550095203b686cb11e5c6b"

orders.taker

string

Taker address that was part of this trade. Note: This can often be the CTF exchange and is not always the true taker, proceed with caution using taker information

Example:

"0x8d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e"

pagination

object

Show child attributes

pagination.limit

integer

Example:

50

pagination.offset

integer

Example:

0

pagination.total

integer

Total number of orders matching the filters

Example:

1250

pagination.has_more

boolean

Whether there are more orders available

Example:

true

Orderbook HistoryFetches historical orderbook snapshots for a specific asset (**token ID**) over a specified time range. Returns snapshots of the order book including bids, asks, and market metadata in order. All timestamps are in **milliseconds**. Orderbook data has history starting from **October 14th, 2025**.

⌘I

Get Orders

curl --request GET \
  --url https://api.domeapi.io/v1/polymarket/orders

{
  "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,
      "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,
    "offset": 0,
    "total": 1250,
    "has_more": true
  }
}

Getting started

Matching Markets

Polymarket Endpoints

Kalshi Endpoints

Query Parameters

Response