GET/data/order/{orderID}

Get single order by ID

Retrieves a specific order by its ID (order hash) for the authenticated user, including canceled or fully matched orders. Builder-authenticated clients can also use this endpoint to retrieve orders attributed to their builder account.

Base URL: https://clob.polymarket.com
Auth: L2 API credentials (key, secret, passphrase)POLY_API_KEY, POLY_ADDRESS, POLY_SIGNATURE, POLY_PASSPHRASE, POLY_TIMESTAMP
Rate limit: 9,000 req / 10s (900 per second)
Limit applies to: CLOB API general

Parameters

Name	In	Type	Required	Description
orderID	path	string	yes	Order ID (order hash)

Example

curl -X GET "https://clob.polymarket.com/data/order/<orderID>" \
  -H "POLY_API_KEY: $POLY_API_KEY" \
  -H "POLY_ADDRESS: $POLY_ADDRESS" \
  -H "POLY_SIGNATURE: $POLY_SIGNATURE" \
  -H "POLY_PASSPHRASE: $POLY_PASSPHRASE" \
  -H "POLY_TIMESTAMP: $POLY_TIMESTAMP"

L2 requests are signed with HMAC-SHA256 using your API secret, and the timestamp is part of the signature, so keep the machine's clock accurate. A missing credential or a stale signature both come back as Unauthorized/Invalid api key. The Python SDK signs for you.

Response fields

Field	Type	Description
id	string	Order ID (order hash)
status	string	Order status. CANCELED_MARKET_RESOLVED cancels the unfilled remainder when the market resolves; it does not undo settled fills.
owner	string	UUID of the order owner
maker_address	string	Ethereum address of the maker
market	string	Market (condition ID)
asset_id	string	Asset ID (token ID)
side	string	Order side
original_size	string	Original order size in shares, as a decimal string. Already normalized; do not divide by 1e6.
size_matched	string	Matched size in shares, as a decimal string. Retained after cancellation; this is not the current position balance.
price	string	Order price
outcome	string	Market outcome (YES/NO)
expiration	string	Unix timestamp when the order expires
order_type	string	Order type
associate_trades	string[]	Array of associated trade IDs
created_at	integer	Unix timestamp when the order was created

Responses

Status	Meaning
200	Successfully retrieved order
400	Bad request - Invalid order ID
401	Unauthorized - Invalid API key or authentication failed
404	Order not found
500	Internal server error

Related endpoints

GET /data/orders CLOB API
GET /data/trades CLOB API

Polymarket's API serves current state only, so it cannot show what a market's book looked like after it resolved. PolyTest records Up/Down markets while they run and keeps the snapshots. Try it free, or read the full rate limit reference.

From Polymarket's published OpenAPI spec and rate-limit tables, synced 2026-10-04.