Skip to main content
GET
/
orders
Get user orders
curl --request GET \
  --url https://clob.polymarket.com/orders \
  --header 'POLY_ADDRESS: <api-key>' \
  --header 'POLY_API_KEY: <api-key>' \
  --header 'POLY_PASSPHRASE: <api-key>' \
  --header 'POLY_SIGNATURE: <api-key>' \
  --header 'POLY_TIMESTAMP: <api-key>'
{
  "limit": 100,
  "next_cursor": "MTAw",
  "count": 2,
  "data": [
    {
      "id": "0xabcdef1234567890abcdef1234567890abcdef12",
      "status": "ORDER_STATUS_LIVE",
      "owner": "f4f247b7-4ac7-ff29-a152-04fda0a8755a",
      "maker_address": "0x1234567890123456789012345678901234567890",
      "market": "0x0000000000000000000000000000000000000000000000000000000000000001",
      "asset_id": "0xabc123def456...",
      "side": "BUY",
      "original_size": "100000000",
      "size_matched": "0",
      "price": "0.5",
      "outcome": "YES",
      "expiration": "1735689600",
      "order_type": "GTC",
      "associate_trades": [],
      "created_at": 1700000000
    },
    {
      "id": "0xfedcba0987654321fedcba0987654321fedcba09",
      "status": "ORDER_STATUS_LIVE",
      "owner": "f4f247b7-4ac7-ff29-a152-04fda0a8755a",
      "maker_address": "0x1234567890123456789012345678901234567890",
      "market": "0x0000000000000000000000000000000000000000000000000000000000000002",
      "asset_id": "0xdef456abc789...",
      "side": "SELL",
      "original_size": "200000000",
      "size_matched": "50000000",
      "price": "0.75",
      "outcome": "NO",
      "expiration": "1735689600",
      "order_type": "GTC",
      "associate_trades": [
        "trade-123"
      ],
      "created_at": 1700000001
    }
  ]
}

Authorizations

​
POLY_API_KEY
string
header
required

Your API key

​
POLY_ADDRESS
string
header
required

Ethereum address associated with the API key

​
POLY_SIGNATURE
string
header
required

HMAC signature of the request

​
POLY_PASSPHRASE
string
header
required

API key passphrase

​
POLY_TIMESTAMP
string
header
required

Unix timestamp of the request

Query Parameters

​
id
string

Order ID (hash) to filter by specific order

​
market
string

Market (condition ID) to filter orders

​
asset_id
string

Asset ID (token ID) to filter orders

​
next_cursor
string

Cursor for pagination (base64 encoded offset)

Response

Successfully retrieved orders

​
limit
integer
required

Maximum number of results per page

Example:

100

​
next_cursor
string
required

Cursor for pagination (base64 encoded offset). Empty if no more results.

Example:

"MTAw"

​
count
integer
required

Number of orders in this response

Example:

2

​
data
object[]
required

Array of open orders