Skip to main content

Get a list of currency assets

Description​

GET /v4/balances

Limit Rule​

  • 10 requests/second/apikey

Parameters​

NameTypeMandatoryDefaultDescriptionRanges
currenciesstringNoN/AList of currencies, comma separated, e.g. usdt,btc

Request Example​

Request
  curl --location --request GET 'https://sapi.xt.com/v4/balances' \
    --header 'accept: */*' \
    --header 'Content-Type: application/json' \
    --header 'validate-algorithms: HmacSHA256' \
    --header 'validate-recvwindow: 60000' \
    --header 'validate-appkey: xxxxxxxxxx' \
    --header 'validate-timestamp: xxxxxxxxxx' \
    --header 'validate-signature: xxxxxxxxxx' \

Response Example​

{
  "rc": 0,
  "mc": "string",
  "ma": [{}],
  "result": {
    "totalBtcAmount": 0,
    "assets": [
      {
        "currency": "string", // currency
        "currencyId": 0, // currency ID
        "frozenAmount": 0, // frozen amount
        "availableAmount": 0, // available amount
        "totalAmount": 0, // total amount
        "convertBtcAmount": 0 // converted BTC amount
      }
    ]
  }
}