Trading Balance

The endpoint retrieves the trade balance by currency ticker or all balances.

Rate limit: 12000 requests/10 sec.

Errors

{
  "code": 30,
  "message": "Validation failed",
  "errors": {
    "ticker": ["Ticker field should be a string."]
  }
}

{
  "code": 30,
  "message": "Validation failed",
  "errors": {
    "ticker": ["Currency was not found."]
  }
}

{
  "code": 1,
  "message": "Inner validation failed",
  "errors": {
    "amount": ["Invalid argument."]
  }
}

POST /api/v4/trade-account/balance

Trading Balance

cURL

curl --request POST \
  --url https://whitebit.com/api/v4/trade-account/balance \
  --header 'Content-Type: application/json' \
  --header 'X-TXC-APIKEY: <api-key>' \
  --data '
{
  "ticker": "BTC",
  "request": "{{request}}",
  "nonce": "{{nonce}}"
}
'

200

{
  "BTC": {
    "available": "0.123",
    "freeze": "0.01"
  },
  "USDT": {
    "available": "1000.50",
    "freeze": "100.00"
  }
}

Authorizations

X-TXC-APIKEY · string · header · required

API Key authentication for private endpoints.

Required headers:

• X-TXC-APIKEY: API key
• X-TXC-PAYLOAD: Base64 encoded JSON payload
• X-TXC-SIGNATURE: HMAC SHA512 signature

Body

application/json

ticker · string

Currency's ticker. Example: BTC

Example:

"BTC"

request · string

Example:

"{{request}}"

nonce · string

Example:

"{{nonce}}"

Response

200

application/json

Successful response

{key} · object

Show child attributes