Get User's Account Flow Information

Type GET

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

Parameters

Name	Type	Mandatory	Default	Description
symbol	string	Yes	N/A	Trading pairs (queries all if not passed)
direction	string	No	NEXT	Direction (PREV: Previous page; NEXT: Next page)
id	integer	No	N/A	Record ID
limit	integer	No	10	Limit
startTime	integer	No	N/A	Start time
endTime	integer	No	N/A	End 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 code	Desc
invalid_coin	Coin does not exist
invalid_symbol	Symbol does not exist