Trading Balance

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}}"
}
'

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

Spot Trading

Trading Balance

This 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

trade-account

balance

Trading Balance

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}}"
}
'

{
  "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: Your 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

Successful response

{key}

object

Show child attributes

Query All Market Fees Create Limit Order

⌘I