Skip to main content
GET
GET /v2/trade/perps/orders: Orders
Sign each request with a fresh HMAC signature. The cURL and HTTP header values below are placeholders, not reusable credentials. For runnable signing code, use request signing examples.
Two reads: the user’s open orders, or one order. Scope perps.read.

List open orders

Open orders only. A past order is read by id, below.

Query Parameters

integer
Only orders on this instrument.
open, client_order_id and cursor are not supported here, and are refused with 400 INVALID_BODY.

Example

Get one order

Path Parameters

string
required
One of:
  • the venue order_id;
  • coid:<32 hex>;
  • ik:<Idempotency-Key>, the key you placed the order with;
  • the intent_id of a 202 pending_confirmation.

Response

A read of a placed order returns the venue’s view, with status and venue_status as on the 201. Its client_order_id is the order’s coid rather than your label, so keep your own map from label to order_id. After a 202 pending_confirmation, poll by intent_id after retry_after_ms until status is open or terminal. An order that never reached the venue ends as rejected with venue_status: "not_placed". After a 504, look the order up at GET /v2/trade/perps/orders/ik:<your key> first. While it answers pending_confirmation, keep polling; rejected with venue_status: "not_placed" means nothing was placed.

Errors

Example