Skip to main content
GET
Get a single order by its exchange order ID or your client order ID

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

asset
string

Market the order is on — required for Aster, Binance, Bybit, Lighter and Robinhood, and for MEXC when looking up by clientOrderId; not used otherwise.

Minimum string length: 1
Example:

"ETH"

clientOrderId
string

Your custom order identifier, the one you passed when creating the order.

Minimum string length: 1
exchange
enum<string>
required

Supported perpetual exchange

Available options:
aster,
binance,
bybit,
extended,
gate,
hyperliquid,
lighter,
mexc,
ondo,
robinhood
orderId
string

Order identifier assigned by the exchange.

Minimum string length: 1

Response

baseSymbol
string
required
Example:

"ETH"

clientOrderId
string | null
required

Order identifier, as returned by the exchange.

createdAt
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
exchange
enum<string>
required

Perpetual exchange

Available options:
aster,
binance,
bybit,
extended,
gate,
hyperliquid,
lighter,
mexc,
ondo,
robinhood
filledSize
string | null
required

Size already executed, in base asset units. Null when the exchange does not report it, or for orders placed before the field existed.

Example:

"0.0005"

orderId
string
required
positionSide
enum<string>
required
Available options:
both,
long,
short
price
string | null
required

Limit price in quote currency, or null for market orders.

Example:

"1800.00"

quoteSymbol
string
required
Example:

"USDC"

reduceOnly
boolean | null
required

Whether the order only reduces an existing position

side
enum<string>
required
Available options:
buy,
sell
size
string
required
Example:

"0.001"

status
enum<string>
required
Available options:
canceled,
created,
error,
executed,
partiallyFilled
timeInForce
enum<string> | null
required

Time in force policy of the order. gtc — Good-Till-Cancel, ioc — Immediate-Or-Cancel, fok — Fill-Or-Kill, alo — Add Liquidity Only. Null for market, trigger, or liquidation orders where TIF is not applicable.

Available options:
gtc,
ioc,
fok,
alo
Example:

"gtc"

triggerPrice
string | null
required
Example:

"1800.00"

type
enum<string>
required
Available options:
limit,
liquidation,
market,
other,
stopLoss,
stopLossLimit,
takeProfit,
takeProfitLimit
updatedAt
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$