---
title: "Get Orders"
method: GET
path: "/polymarket/orders"
---

# Get Orders

`GET /polymarket/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.

## Query parameters

- `market_slug` string
- `condition_id` string
- `token_id` string
- `start_time` integer
- `end_time` integer
- `limit` integer
- `pagination_key` string
- `user` string

## Response `200`

Orders response with pagination

- object
  - `orders` object[]
    - `token_id` string
    - `token_label` string — Human readable label for this outcome (yes/no etc)
    - `side` 'BUY' | 'SELL'
    - `market_slug` string
    - `condition_id` string
    - `shares` number — Raw number of shares purchased (from the blockchain)
    - `shares_normalized` number — Number of shares purchased normalized (this is raw divided by 1000000)
    - `price` number — Price per share
    - `block_number` integer — Block number where the order was placed
    - `log_index` integer — Log index of the order event in the block
    - `tx_hash` string — Transaction hash of the order
    - `title` string — Market title
    - `timestamp` integer — Unix timestamp in seconds when the order was placed
    - `order_hash` string — Hash of the order
    - `user` string — Maker address of the order
    - `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
  - `pagination` object
    - `limit` integer
    - `offset` integer
    - `total` integer — Total number of orders matching the filters
    - `has_more` boolean — Whether there are more orders available
    - `pagination_key` string — Base64-encoded cursor for the next page. Only present when there are more results. Use this in the next request instead of offset.

## Other responses

- `400` — Bad Request - Invalid parameters or validation errors
- `401` — Unauthorized - Offset deprecated for large values

---

[API](https://skmtc.net/domeapi/apis/dome-api.md) · [All operations](https://skmtc.net/domeapi/apis/dome-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/domeapi/dome-api/versions/7c5d22727cce/schema)