Query order status

GET/api/v1/markets/{marketId}/orders/{orderId}Bearer

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

The cursor in the 202 place-order response exists for exactly this call: ?minCursor=…. A 404 has two meanings (the projection has not caught up, or the order does not exist) and they are byte-for-byte indistinguishable — retry the first 404 with the same cursor; it is not the final answer. Someone else's order also returns 404 rather than 403, so order ownership cannot be enumerated.

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

Path parameters

marketIdstringpathrequired
Engine market id (read endpoints do not accept a slug unless that endpoint says otherwise)
Example"mkt-0001"
orderIdstringpathrequired
Server-generated order id (returned in the 202 place-order response)
Example"ord_01K5H2M3N7Q8R9S0"

Query parameters

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

200Current order state

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/markets/mkt-0001/orders/ord_01K5H2M3N7Q8R9S0" \
  -H "Authorization: Bearer $TOKEN"

Response

Current order state

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

Path parameters

marketIdstringpathrequired
Engine market id (read endpoints do not accept a slug unless that endpoint says otherwise)
Example"mkt-0001"
orderIdstringpathrequired
Server-generated order id (returned in the 202 place-order response)
Example"ord_01K5H2M3N7Q8R9S0"

Query parameters

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

200Current order state

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.