Get Order

Fetch a single order by id.

GET /orders/{orderId}

Auth: Authorization: Bearer <access_token>.

Path Parameters

Parameter	Description
`orderId`	Order id returned by `POST /orders`

Query Parameters (alternative)

Look up by your own idempotency key instead of the venue id:

GET /orders?client_order_id={client_order_id}

Exactly one of {orderId} or client_order_id must be supplied.

Example

curl https://api.godarkdex.com/api/v1/orders/ord_01HXYZ12345 \
  -H "Authorization: Bearer $TOKEN"

Response

{
  "code": 0,
  "data": {
    "order_id": "ord_01HXYZ12345",
    "client_order_id": "my-order-001",
    "symbol": "BTC-USDC-PERP",
    "side": "buy",
    "type": "limit",
    "peg_reference": null,
    "quantity": 0.1,
    "price": 95000,
    "time_in_force": "GTC",
    "expiry_time": null,
    "aon": false,
    "min_fill_size": null,
    "status": "PARTIALLY_FILLED",
    "filled_quantity": 0.03,
    "remaining_quantity": 0.07,
    "average_fill_price": 94998.5,
    "created_at": "2026-04-20T10:30:00.123Z",
    "updated_at": "2026-04-20T10:31:15.456Z"
  },
  "timestamp": "2026-04-20T10:32:00.789Z",
  "request_id": "req_01HXYZ..."
}

Field Reference

Field	Type	Description
`order_id`	string	Venue-assigned id
`client_order_id`	string \| null	Idempotency key supplied on placement, if any
`symbol`	string	Instrument id
`side`	string	`buy` or `sell`
`type`	string	`market`, `limit`, or `peg`
`peg_reference`	string \| null	`mid`, `bid`, or `ask` when `type=peg`, else `null`
`quantity`	number	Original order quantity
`price`	number \| null	Limit price, or `null` for `peg` / unpriced `market`
`time_in_force`	string	`GTC`, `GTT`, `IOC`, or `FOK`
`expiry_time`	integer \| null	Nanosecond epoch; set for `GTT`
`aon`	boolean	All-or-None flag
`min_fill_size`	number \| null	Minimum per-execution fill size, if set
`status`	string	`NEW`, `PARTIALLY_FILLED`, `FILLED`, `CANCELLED`, `REJECTED`
`filled_quantity`	number	Total filled so far
`remaining_quantity`	number	Unfilled remainder
`average_fill_price`	number \| null	Volume-weighted average fill price
`created_at`	string	Creation timestamp (RFC 3339)
`updated_at`	string	Last update timestamp (RFC 3339)

Streaming Alternative

For live updates on all your orders — including fills, cancels, and rejects — subscribe to the Orders Channel over WebSocket rather than polling GET /orders/{orderId}.

Errors

Code	Meaning
`1400`	Order not found
`1401`	Order belongs to a different account
`1403`	Neither `orderId` nor `client_order_id` supplied