get https://api.bring.trade/api/v1/trade/order
Query detailed order information, including current status, trading details, execution information, etc.
This query supports all order states.
⏳ Limit
600 requests per minute.
🛠️ Parameters
| Field | Type | Mandatory | Description |
|---|---|---|---|
| orderId | String | N | Order ID |
| clientOrderId | String | N | Customer-defined order ID |
Tip: Either orderId or clientOrderId must be sent. This query supports all order states (NEW, OPEN, CANCELLED, FILLED, PARTIALLY_FILLED, REJECT, FAIL).
📬 Response
| Field | Type | Description |
|---|---|---|
| accountId | String | Account ID |
| orderId | String | Order ID |
| clientOrderId | String | Customer-defined order ID |
| orderState | String | Order state(NEW, OPEN, CANCELLED, FILLED, PARTIALLY_FILLED, REJECT, FAIL) |
| symbol | String | The trading pair or asset symbol. |
| side | String | Order side (BUY or SELL). |
| orderType | String | Order type (default LIMIT, supported types: LIMIT, MARKET). |
| market | String | Market type: SPOT, PERP. |
| orderQty | String | The quantity of the base currency (Mandatory unless spot market buy). |
| quoteOrderQty | String | Order quote quantity, only used for spot market buy orders to specify the total amount in the quote currency to spend. |
| limitPrice | String | Limit price (mandatory for limit orders). |
| timeInForce | String | Time In Force (default GTC, supported types: GTC, IOC, FOK, GTX). GTX = GTC + Post only. |
| executedQty | String | The quantity of the base currency that has been executed. |
| executedAmount | String | The total amount executed, i.e., the quantity of the quote currency that has been traded. |
| executedAvgPrice | String | The average price at which the order has been executed. |
| reason | String | If the order failed, provides information about the failure reason. |
| createTime | String | The timestamp when this portfolio record was created (in milliseconds). |
| updateTime | String | The timestamp when this portfolio record was last updated (in milliseconds). |
| fee | String | The trading fee incurred for the executed trades. |
| orderAttribute | String | DMA,SYSTEM_LIQ,SYSTEM_REDUCE,REPLACE |
| reduceOnly | String | Reduce-only order, must be true or false. Indicates whether the order should only reduce an existing position. |
| leverage | String | Leverage |
| lastExecutedQty | String | The quantity executed in the most recent fill. |
| lastExecutedPrice | String | The price at which the most recent execution occurred. |
| lastExecutedAmount | String | The amount of the quote currency involved in the most recent execution. |
| borrowAmount | String | Borrow Amount |
| borrowAsset | String | Borrow Asset |