v3
latestOpenAPI 3.0.02026-07-311784111.3 MBTrading
Private
Retrieves the current state of an order identified by its order ID. The response includes order details such as status (open, filled, cancelled), filled amount, remaining amount, price, and other order properties.
Important Note for Mass Quotes: Quote orders are order-like structures that don't fully translate to normal orders. When checking order state for quotes, the amount field represents the remaining amount, not the original order amount.
Scope: trade:read
get/private/get_order_state
Query parameters
order_idstring required
Unique order identifier
Example:ETH-100234
The order id
Response
Success response
Example response
{
"result": {
"order_id": "ETH-100234",
"starbase_order_id": 103148386170,
"instrument_name": "BTC-PERPETUAL",
"creation_timestamp": 1536569522277,
"last_update_timestamp": 1536569522277,
"starbase_last_update_timestamp": 1536569522277000000,
"block_trade": true,
"trigger_order_id": "SLIB-370",
"combo_order_id": "103148386169",
"app_name": "Example Application",
"mmp_cancelled": true,
"oto_order_ids": [
"ETH-100234"
],
"primary_order_id": "ETH-100234"
}
}