orders

Get Order by ID

Retrieve a specific order using its unique identifier.

This endpoint requires authentication and is subjected to rate limiting.

get/v2/orders/{orderId}

Request

Query parameters

tradingAccountIdstring required

unique trading account ID

Example:111000000000001

Id of the trading account

Response

OK

clientOrderIdstring required

Unique numeric (i64) identifier generated on the client side expressed as a string value

orderIdstring required
symbolstring required

market symbol. E.g. BTCUSDC

pricestring required

see asset value format

averageFillPricestring required

see asset value format

stopPricestring required

see asset value format

allowBorrowboolean required

indicates if the order was allowed to borrow (does not indicate that borrowing occurred)

quantitystring required

see asset value format

quantityFilledstring required

see asset value format

quoteAmountstring required

see asset value format

baseFeestring required

see asset value format

quoteFeestring required

see asset value format

borrowedBaseQuantitystring

see asset value format

borrowedQuoteQuantitystring

see asset value format

isLiquidationboolean required

indicates if the order was executed as a liquidation order

sidestring required

order side can have the following string values "BUY", "SELL"

typestring required

order type can have the following string values "LMT", "MKT", "STOP_LIMIT", "POST_ONLY". "MKT" and "STOP_LIMIT" are not applicable for Options

timeInForcestring required

time in force can have the following string values "GTC", "FOK", "IOC", "GTX" (Good Till Crossing - for auction orders), see details

statusstring required

order status can have the following string values "OPEN", "CLOSED", "CANCELLED", "REJECTED"

statusReasonstring required

status reason, describes why the order is in a specific state

statusReasonCodestring required

status reason code, see details

createdAtDatetimestring date-time required

ISO 8601 with millisecond as string

createdAtTimestampstring string required

unsigned 64 bit integer value which is the number of milliseconds since EPOCH expressed as string

Example response

{
  "clientOrderId": "299834741023572480",
  "orderId": "297735387747975680",
  "symbol": "BTCUSDC",
  "price": "1.00000000",
  "averageFillPrice": "1.00000000",
  "stopPrice": "1.00000000",
  "quantity": "1.00000000",
  "quantityFilled": "1.00000000",
  "quoteAmount": "1.00000000",
  "baseFee": "1.00000000",
  "quoteFee": "1.00000000",
  "borrowedBaseQuantity": "1.00000000",
  "borrowedQuoteQuantity": "1.00000000",
  "side": "BUY",
  "type": "LMT",
  "timeInForce": "GTX",
  "status": "OPEN",
  "statusReason": "User cancelled",
  "statusReasonCode": "1002",
  "createdAtDatetime": "2025-05-20T01:01:01.000Z",
  "createdAtTimestamp": "1621490985000"
}

Changes

No recorded changes to this operation across all 1 revision of this API.