Futures Transaction Records
Frequency limit: 1 times/1s (User ID)
Description
Futures transaction records
HTTP Request
- GET /api/v2/tax/future-record
Request Example
curl "https://api.bitget.com/api/v2/tax/future-record?startTime=1686128558000&endTime=1686214958000&limit=100" \
-H "ACCESS-KEY:*******" \
-H "ACCESS-SIGN:*" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:en-US" \
-H "Content-Type: application/json" \
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| productType | String | No | Product type default USDT-FUTURESUSDT-FUTURES USDT professional futuresCOIN-FUTURES Mixed futuresUSDC-FUTURES USDC professional futures |
| marginCoin | String | No | Default all margin coin |
| startTime | String | Yes | Start time (time stamp in milliseconds) |
| endTime | String | Yes | The maximum interval between startTime and endTime (time stamp in milliseconds) is 30 days. |
| limit | String | No | Default: 500, maximum: 500 |
| idLessThan | String | No | The last recorded ID |
Response example
{
"code": "00000",
"msg": "success",
"requestTime": 1687257612262,
"data": [
{
"id": "1",
"symbol": "TRXUSDT",
"marginCoin": "USDT",
"futureTaxType": "close_long",
"amount": "0.10545",
"fee": "-0.02134863",
"ts": "1679909309766"
}
]
}
Response parameters
| Parameter | Type | Description |
|---|---|---|
| id | String | Transaction history ID |
| symbol | String | symbol |
| marginCoin | String | margin Coin |
| futureTaxType | String | Futures transaction type |
| amount | String | Quantity |
| fee | String | Transaction fee |
| ts | String | When this record was generated, millisecond timestamp |
futureTaxType
TRANSFER_INFund transferTRANSFER_OUTFund transferORDER_DEALT_FROZEN_OUTOrder dealt fund outORDER_DEALT_INOrder dealt fund inORDER_PLF_FEE_OUThandling fee deductionEXCHANGE_SOURCE_TOKEN_USER_OUTRedeemEXCHANGE_TARGET_TOKEN_USER_INRedeemOPEN_LONGOpen longOPEN_SHORTOpen shortBUY_DEALBuySELL_DEALSellCLOSE_LONGClose longCLOSE_SHORTClose shortFORCE_CLOSE_LONGForced reduction of long positionFORCE_CLOSE_SHORTForced reduction of short positionBURST_CLOSE_LONGLiquidate long positionBURST_CLOSE_SHORTLiquidate short positionOFFSET_REDUCE_CLOSE_LONGOffset close longOFFSET_REDUCE_CLOSE_SHORTOffset close shortFORCE_BUY_SSMForced buyFORCE_SELL_SSMForced sellBURST_BUY_SSMLiquidate buyBURST_SELL_SSMLiquidate sellRISK_LIQ_USER_INUser money in due to liquidation riskRISK_LIQ_USER_OUTUser money out due to liquidation riskINTEREST_SETTLEMENT_OUTInterest deductionCONTRACT_MAIN_SETTLE_FEE_USER_INFunding fee collectionCONTRACT_MAIN_SETTLE_FEE_USER_OUTFunding Fee deduction