List my orders

GET/api/v1/ordersBearer

Trading APIprice E4 · size E2 · amount E6 (integers)YES | NO

Identity is derived from the session. status accepts comma-separated values (for "still on the book" pass status=OPEN,PARTIAL). Without marketId this is a cross-partition query and minCursor is rejected with 400; supplying marketId narrows it to a single market, where minCursor is supported.

Send Authorization: Bearer <token>. The token is issued by POST /api/v1/auth/verify, and expires after 24h idle or 7d after issuance.

Query parameters

marketIdstringqueryoptional
Filter by market; supplying it narrows this endpoint to a single-market query, which does support minCursor
Example"mkt-0001"
statusstringqueryoptional
Comma-separated status filter
limitintegerqueryoptional
Maximum number of rows returned
Default100Range≥ 1Example20
minCursorstringqueryoptional
Read-your-writes continuation point (pass the cursor from the 202 place-order response verbatim). While the projection has not caught up this query returns 404, indistinguishable from "the resource does not exist" — poll with the same cursor.
Example"c1:mkt-0001:184"

Response

200List of orders

The response is an array; the fields below describe each element:

orderIdstring
Server-generated order id
Example"ord_01K5H2M3N7Q8R9S0"
marketIdstring
The market this order belongs to
Example"mkt-0001"
outcomeYES | NO
Settlement outcome
Example"YES"
sideBUY | SELL
Order side
Example"BUY"
priceE4integer
Limit price (1e-4 USD)
Example5200
sizeE2int64
Order size (1e-2 shares)
Example1000
filledE2int64
Filled size (1e-2 shares)
Example250
statusOPEN | PARTIAL | FILLED | CANCELLED
OPEN = resting; PARTIAL = partially filled; FILLED = fully filled; CANCELLED = cancelled
Example"OPEN"
reasonstringnullable
Terminal state or rejection reason (nullable)

Switch status codes in the response example to view errors. For all codes, see the Errors page.

Request

curl -X GET "$BASE_URL/api/v1/orders?limit=100" \
  -H "Authorization: Bearer $TOKEN"

Response

List of orders

[
  {
    "orderId": "ord_01K5H2M3N7Q8R9S0",
    "marketId": "mkt-0001",
    "outcome": "YES",
    "side": "BUY",
    "priceE4": 5200,
    "sizeE2": 1000,
    "filledE2": 250,
    "status": "OPEN",
    "reason": null
  }
]

Query parameters

marketIdstringqueryoptional
Filter by market; supplying it narrows this endpoint to a single-market query, which does support minCursor
Example"mkt-0001"
statusstringqueryoptional
Comma-separated status filter
limitintegerqueryoptional
Maximum number of rows returned
Default100Range≥ 1Example20
minCursorstringqueryoptional
Read-your-writes continuation point (pass the cursor from the 202 place-order response verbatim). While the projection has not caught up this query returns 404, indistinguishable from "the resource does not exist" — poll with the same cursor.
Example"c1:mkt-0001:184"

Response

200List of orders

The response is an array; the fields below describe each element:

orderIdstring
Server-generated order id
Example"ord_01K5H2M3N7Q8R9S0"
marketIdstring
The market this order belongs to
Example"mkt-0001"
outcomeYES | NO
Settlement outcome
Example"YES"
sideBUY | SELL
Order side
Example"BUY"
priceE4integer
Limit price (1e-4 USD)
Example5200
sizeE2int64
Order size (1e-2 shares)
Example1000
filledE2int64
Filled size (1e-2 shares)
Example250
statusOPEN | PARTIAL | FILLED | CANCELLED
OPEN = resting; PARTIAL = partially filled; FILLED = fully filled; CANCELLED = cancelled
Example"OPEN"
reasonstringnullable
Terminal state or rejection reason (nullable)

Switch status codes in the response example to view errors. For all codes, see the Errors page.