Skip to main content

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

ParameterTypeRequiredDescription
orderIdStringNoOrder ID
symbolStringNoTrading pair, e.g. ETHUSDT
productTypeStringYesProduct type
USDT-FUTURES USDT professional futures
COIN-FUTURES Mixed futures
USDC-FUTURES USDC professional futures
SUSDT-FUTURES USDT professional futures demo
SCOIN-FUTURES Mixed futures demo
SUSDC-FUTURES USDC professional futures demo
idLessThanStringNoRequests the content on the page before the tradeId (older data).
startTimeStringNoStart 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)
endTimeStringNoEnd 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. )
limitStringNoNumber 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

ParameterTypeDescription
fillListList<Object>Transaction details
>tradeIdStringTransaction id
>symbolStringTrading pair
>orderIdStringOrder no.
>priceStringOrder price
>baseVolumeStringAmount of coins traded
>feeDetailStringTransaction fee
>>deductionStringWhether or not to deduct (vouchers)
>>feeCoinStringCrypto ticker
>>totalDeductionFeeStringTotal transaction fee discount
>>totalFeeStringTotal transaction fee
>sideStringType of transaction
buy: Buy
sell: Sell
>quoteVolumeStringTrading amount in quote currency
>profitStringProfit
>enterPointSourceStringOrder 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
>tradeSideStringDirection
close: Close (open and close mode)
open: Open (open and close mode)
reduce_close_long: Liquidate partial long positions for hedge position mode
reduce_close_short:Liquidate partial short positions for hedge position mode
burst_close_long:Liquidate long positions for hedge position mode
burst_close_short:Liquidate short positions for hedge position mode
offset_close_long:Liquidate partial long positions for netting for hedge position mode
offset_close_short:Liquidate partial short positions for netting for hedge position mode
delivery_close_long:Delivery long positions for hedge position mode
delivery_close_short:Delivery short positions for hedge position mode
dte_sys_adl_close_long:ADL close long position for hedge position mode
dte_sys_adl_close_short:ADL close short position for hedge position mode
buy_single:Buy, one way postion mode
sell_single:Sell, one way postion mode
reduce_buy_single:Liquidate partial positions, buy, one way position mode
reduce_sell_single:Liquidate partial positions, sell, one way position mode
burst_buy_single:Liquidate short positions, buy, one way postion mode
burst_sell_single:Liquidate partial positions, sell, one way position mode
delivery_sell_single:Delivery sell, one way position mode
delivery_buy_single:Delivery buy, one way position mode
dte_sys_adl_buy_in_single_side_mode:ADL close position, buy, one way position mode
dte_sys_adl_sell_in_single_side_mode:ADL close position, sell, one way position mode
>posModeStringPosition mode
one_way_mode: one-way position
hedge_mode: two-way position
>tradeScopeStringTrader tag
taker: Taker
maker: Maker
>cTimeStringDate of transaction
endId
String
The final order ID.
This is used when idLessThan/idGreaterThan is set as a range.
endIdStringThe final Transaction ID.
This is used when idLessThan/idGreaterThan is set as a range.

How was your Reading Experience with us?