Get Order Fill Details
Speed limit is 10 times/s for average users. Frequency limit imposed according to user ID
Description
Get order fill details
HTTP Request
- GET /api/v2/mix/order/fills
Request Example
curl "https://api.bitget.com/api/v2/mix/order/fills?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 |
symbol | String | No | Trading pair, e.g. ETHUSDT |
productType | String | Yes | Product typeUSDT-FUTURES USDT professional futuresCOIN-FUTURES Mixed futuresUSDC-FUTURES USDC professional futuresSUSDT-FUTURES USDT professional futures demoSCOIN-FUTURES Mixed futures demoSUSDC-FUTURES USDC professional futures demo |
idLessThan | String | No | Requests the content on the page before the tradeId (older data). |
startTime | String | No | Start time (time stamp in milliseconds) (The maximum time span supported is three months. The default end time is three months 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 time (time stamp in milliseconds) (The maximum time span supported is three months. The default start time is three months ago if no value is set for the start time. ) |
limit | String | No | Number of queries: Default: 100, maximum: 100 |
Response Example
{
"code": "00000",
"data": {
"fillList": [
{
"tradeId": "123",
"symbol": "ethusdt",
"orderId": "121212",
"price": "1900",
"baseVolume": "1",
"feeDetail": [
{
"deduction": "yes",
"feeCoin": "BGB",
"totalDeductionFee": "-0.017118519726",
"totalFee": "-0.017118519726"
}
],
"side": "buy",
"quoteVolume": "1902",
"profit": "102",
"enterPointSource": "api",
"tradeSide": "close",
"posMode": "hedge_mode",
"tradeScope": "taker",
"cTime": "1627293509612"
}
],
"endId": "123"
},
"msg": "success",
"requestTime": 1627293504612
}
Response Parameters
Parameter | Type | Description |
---|---|---|
fillList | List<Object> | Transaction details |
>tradeId | String | Transaction id |
>symbol | String | Trading pair |
>orderId | String | Order no. |
>price | String | Order 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 | Type of transaction buy: Buy sell: Sell |
>quoteVolume | String | Trading amount in quote currency |
>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 positionhedge_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. |
endId | String | The final Transaction ID. This is used when idLessThan/idGreaterThan is set as a range. |