get https://api.bring.trade/api/v1/trade/orders/history
Query detailed information on completed orders in the current account.
⏳ Limit
15 requests per 10 seconds.
🛠️ Parameters
| Field | Type | Mandatory | Description |
|---|---|---|---|
| symbol | String | N | The trading pair or asset symbol. |
| market | String | N | Market type: SPOT, PERP. |
| begin | String | N | The start time for data queries, specified in milliseconds timestamp format. |
| end | String | N | The end time for data queries, specified in milliseconds timestamp format. |
📬 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. |
| executedAvgPrice | String | The average price at which the order has been executed. |
| executedAmount | String | The total amount executed, i.e., the quantity of the quote currency that has been traded. |
| 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 |