Get Historical Transaction Details
Frequency limit: 10 times/1s (uid)
Description
Get order fill history
HTTP Request
- GET /api/v2/mix/order/fill-history
Request Example
curl "https://api.bitget.com/api/v2/mix/order/fill-history?productType=usdt-futures" \
-H "ACCESS-KEY:your apiKey" \
-H "ACCESS-SIGN:*" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:zh-CN" \
-H "Content-Type: application/json"
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| orderId | String | No | Order ID Either orderId or clientOid is required. If both are entered, orderId prevails. |
| symbol | String | No | Trading pair, e.g. ETHUSDT |
| productType | String | Yes | Product typeUSDT-FUTURES USDT professional futuresCOIN-FUTURES Mixed futuresUSDC-FUTURES USDC professional futuresIt does not support to query the data in demo trading |
| startTime | String | No | Start timestamp Unix timestamp in milliseconds format, e.g. 1597026383085 (The maximum time span supported is a week. The default end time is a week if no value is set for the end time. ) (For Managed Sub-Account, the StartTime cannot be earlier than the binding time) |
| endTime | String | No | End timestamp Unix timestamp in milliseconds format, e.g. 1597026383085 (The maximum time span supported is a week. The default start time is a week ago if no value is set for the start time. ) |
| idLessThan | String | No | Requests the content on the page before this ID (older data), the value input should be the endId of the corresponding interface. |
| limit | String | No | Number of queries: Maximum: 100, default: 100 |
Response Example
{
"code": "00000",
"msg": "success",
"requestTime": 1699267238892,
"data": {
"fillList": [
{
"tradeId": "xxxx",
"symbol": "ETHUSDT",
"marginCoin": "USDT",
"orderId": "xxxx",
"price": "1801.33",
"baseVolume": "0.02",
"feeDetail": [
{
"deduction": "no",
"feeCoin": "USDT",
"totalDeductionFee": "0",
"totalFee": "-0.02161596"
}
],
"side": "sell",
"quoteVolume": "36.0266",
"profit": "0.0252",
"enterPointSource": "ios",
"tradeSide": "sell_single",
"posMode": "one_way_mode",
"tradeScope": "taker",
"cTime": "1698730804882"
}
],
"endId": "123456789"
}
}
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| endId | String | Last query ended order ID |
| fillList | List<Object> | Order list |
| >symbol | String | Trading pair |
| >marginCoin | String | Margin Coin |
| >tradeId | String | Transaction ID |
| >orderId | String | order id |
| >price | String | deal price |
| >baseVolume | String | Amount of coins traded |
| >feeDetail | String | Transaction fee |
| >>deduction | String | Whether or not to deduct (vouchers) |
| >>feeCoin | String | Crypto ticker |
| >>totalDeductionFee | String | Total transaction fee discount |
| >>totalFee | String | Total transaction fee |
| >side | String | Direction Buy; Sell |
| >quoteVolume | String | Trading amount in quoting coin |
| >profit | String | profit |
| >enterPointSource | String | Order source WEB: Orders created on the website API: Orders created on API SYS: System managed orders, usually generated by forced liquidation logic ANDROID: Orders created on the Android app IOS: Orders created on the iOS app |
| >tradeSide | String | Directionclose: Close (open and close mode)open: Open (open and close mode)reduce_close_long: Liquidate partial long positions for hedge position modereduce_close_short:Liquidate partial short positions for hedge position modeburst_close_long:Liquidate long positions for hedge position modeburst_close_short:Liquidate short positions for hedge position modeoffset_close_long:Liquidate partial long positions for netting for hedge position modeoffset_close_short:Liquidate partial short positions for netting for hedge position modedelivery_close_long:Delivery long positions for hedge position modedelivery_close_short:Delivery short positions for hedge position modedte_sys_adl_close_long:ADL close long position for hedge position modedte_sys_adl_close_short:ADL close short position for hedge position modebuy_single:Buy, one way postion modesell_single:Sell, one way postion modereduce_buy_single:Liquidate partial positions, buy, one way position modereduce_sell_single:Liquidate partial positions, sell, one way position modeburst_buy_single:Liquidate short positions, buy, one way postion modeburst_sell_single:Liquidate partial positions, sell, one way position modedelivery_sell_single:Delivery sell, one way position modedelivery_buy_single:Delivery buy, one way position modedte_sys_adl_buy_in_single_side_mode:ADL close position, buy, one way position modedte_sys_adl_sell_in_single_side_mode:ADL close position, sell, one way position mode |
| >posMode | String | Position mode one_way_mode: one-way position hedge_mode: two-way position |
| >tradeScope | String | Trader tag taker: Taker maker: Maker |
| >cTime | String | Date of transaction endId String The final order ID. This is used when idLessThan/idGreaterThan is set as a range. |