Skip to main content

What a poll by request_id returns before the order is recorded: while it is queued, or after it was refused. Returned by GET /orders?request_id= (as the item in data) and GET /orders/{id} (as order). Once recorded, the same requests return the full OrderWithMarket. A request claim lasts 24 hours.

id
string
required

The order id this order has, or would have had: the same order_id POST /trading/orders returned.

Example:

"ord_6aedec658f3a61c2d94e07b5a1c6e2d9"

request_id
string
required

The request_id you placed the order with.

Example:

"3f1c2a9e-5b7d-4e0a-9c1d-8a6b2e4f7d10"

status
enum<string>
required

pending while the order is queued; cancelled once it was refused before being recorded, which also spends its request_id. See Order statuses.

Available options:
pending,
cancelled
Example:

"pending"

error
string

Why the order was refused: the same message the refusal sent, such as Market is not active or Exchange unavailable. Only on cancelled.

Example:

"Market is not active"