Skip to main content

Documentation Index

Fetch the complete documentation index at: https://staging-docs.orderly.network/llms.txt

Use this file to discover all available pages before exploring further.

Single order lookup by order_id. Searches both live and archived orders, and populates algo-order fields (trigger_price etc.) when applicable. Weight: 5

​
Request

{
  "type": "orderStatus",
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "order_id": 123456789
}
FieldTypeRequiredDefaultNotes
addressstringYes—Required — narrows the lookup to one user; omitting it makes the query much slower
order_idint64Yes—Order identifier; MISSING_PARAM if absent
broker_idstringNo—Optional
account_idstringNo—Optional

​
Response

FieldTypeNotes
statusstringPENDING_NEW / NEW / PARTIAL_FILLED / FILLED / PENDING_CANCEL / CANCELLED / REJECTED / REPLACED
average_executed_pricestring | nullLive: always null. Archive: decimal
total_fee, fee_assetstring | nullLive: null. Archive: decimal / string
trigger_pricestring | nullPresent only for algo orders

​
Notes

  • Throws ORDER_NOT_FOUND (404) if the order is in neither live nor archive
  • This endpoint does not paginate (single row)
{
  "success": true,
  "data": {
    "order_id": "123456789",
    "symbol": "PERP_ETH_USDC",
    "side": "BUY",
    "type": "LIMIT",
    "price": "2500.00",
    "quantity": "1.5",
    "total_executed_quantity": "1.5",
    "average_executed_price": "2499.50",
    "trigger_price": null,
    "status": "FILLED",
    "total_fee": "0.002",
    "fee_asset": "USDC",
    "realized_pnl": "100.50",
    "reduce_only": false,
    "created_time": 1714900000000,
    "updated_time": 1714901000000
  },
  "ts": 1779269143700
}