Skip to main content

Get User's Account Flow Information

Type GET

Description: /future/user/v1/balance/bills

Parameters

NameTypeMandatoryDefaultDescription
symbolstringYesN/ATrading pairs (queries all if not passed)
directionstringNoNEXTDirection (PREV: Previous page; NEXT: Next page)
idintegerNoN/ARecord ID
limitintegerNo10Limit
startTimeintegerNoN/AStart time
endTimeintegerNoN/AEnd time

Limit Flow Rules

200/s/apikey

Request Example

Request
curl -G "https://fapi.xt.com/future/user/v1/balance/bills" \ 
-H "validate-appkey: $APPKEY" \ # Required
-H "validate-timestamp: $TIMESTAMP" \ # Required
-H "validate-singature: $SINGATURE" \ # Required
-H "Content-Type: application/x-www-form-urlencoded" \ # Required
-d "symbol=btc_usdt" \ # Required
-d "limit=10"

Response Example

Response
{
"error": {
"code": "",
"msg": ""
},
"msgInfo": "",
"result": {
"hasNext": false, // Is there a next page
"hasPrev": false, // Is there a previous page
"items": [
// Datasheets
{
"afterAmount": 0, // Balance after change
"amount": 0, // Quantity
"coin": "", // Currency
"createdTime": 0, // Time
"id": 0, // ID
"side": "", // ADD: transfer in; SUB: transfer out
"symbol": "", // Trading pair
"type": "" // EXCHANGE: transfer; CLOSE_POSITION: Offset PnL; TAKE_OVER: position takeover; QIANG_PING_MANAGER: Liquidation management fee; FUND: Fund fee; FEE: Fee (open position, liquidation, forced liquidation); ADL: Auto-deleveraging; MERGE: Position merge
}
]
},
"returnCode": 0
}

Error code

Error codeDesc
invalid_coinCoin does not exist
invalid_symbolSymbol does not exist