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 type USDT-FUTURES USDT professional futures COIN-FUTURES Mixed futures USDC-FUTURES USDC professional futures It 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",
                "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
>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	Direction 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
>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.