Get Order by Order ID
Retrieve the details and execution state of one order by its API-assigned order ID.
Endpoint
GET /v1/order/{order_id}
Mainnet: GET https://api.orderly.org/v1/order/{order_id}
Testnet: GET https://testnet-api.orderly.org/v1/order/{order_id}
Rate limit: 10 requests per second. Returns the details for one order. The request is signed and does not have a body.
Authentication headers
- orderly-timestamp — signed-request timestamp in milliseconds.
- orderly-account-id — PangoPerps account ID.
- orderly-key — public API key.
- orderly-signature — request signature.
Path parameter
| Parameter | Type | Required | Description |
|---|---|---|---|
| order_id | string | Yes | ID assigned to the order. Replace the path placeholder with the requested order ID. |
Example request
curl --request GET \
--url 'https://api.orderly.org/v1/order/123456789' \
--header 'orderly-account-id: <account-id>' \
--header 'orderly-key: <public-api-key>' \
--header 'orderly-signature: <signature>' \
--header 'orderly-timestamp: <timestamp-in-ms>'Successful response
HTTP 200 returns success, an order object, and the server timestamp. The order object can include order and client IDs, market, type, side, price, quantity and amount, visible quantity, execution totals and average price, status, fees, realized PnL, reduce-only setting, order tag, margin mode, and creation/update times.
{
"success": true,
"data": {
"order_id": 123456789,
"user_id": 98765,
"price": 3450.5,
"type": "LIMIT",
"quantity": 0.25,
"amount": 862.625,
"total_executed_quantity": 0.25,
"visible_quantity": 0.25,
"symbol": "PERP_ETH_USDC",
"side": "BUY",
"status": "FILLED",
"total_fee": 0.25,
"fee_asset": "USDC",
"client_order_id": "pango-demo-001",
"average_executed_price": 3450.5,
"created_time": 1702989100000,
"updated_time": 1702989200000,
"realized_pnl": 0,
"executed_quantity": 0.25,
"visible": 0.25,
"executed": 0.25,
"reduce_only": false,
"order_tag": "enum:pangoperps:example",
"margin_mode": "CROSS"
},
"timestamp": 1702989203989
}