Get All Balances

Every ledger account you hold, across all three wallet types, plus deposits that have been seen on the blockchain but are not credited yet.

Permission: READ_BALANCE | Parameters: none. Any query string is ignored.

Reading the response

Field	Notes
`balances[].walletType`	`SPOT`, `ASSET` or `FUTURE`, in uppercase
`balances[].availableBalance`	String. What you can spend right now
`balances[].lockedBalance`	String. Reserved by open orders or withdrawals
`balances[].version`	An internal optimistic-lock counter. It is not a balance and not a count
`pending`	An object keyed by `tokenId`, where the key is a string. Not an array
`pending.<tokenId>.pendingAmountBaseUnits`	String, in base units (satoshi, wei), not a human decimal

Three things that catch people out

pending is not part of availableBalance. Do not add them together and show the sum as spendable, because it is not.

pendingAmountBaseUnits uses base units while every other amount here is a decimal string. Convert it with the asset's decimals before displaying.

Only coins you have an account for appear. A newly verified account with no deposits returns {"balances": [], "pending": {}}. That is a valid empty answer, not an error. A coin can appear in pending with no matching row in balances.

If you are building a trading client, GET /v1/transfers/balances is usually the easier shape to work with.

Errors: the authentication set, plus 500 INTERNAL. There is no 400 because there is nothing to validate, and no 404.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Bodyapplication/json

Example

{
  "balances": [
    {
      "id": "clw8n2k4x0001abcdefghij",
      "userId": "clw8n1a2b0000abcdefghij",
      "tokenId": 1,
      "walletType": "SPOT",
      "coin": "USDT",
      "name": "Tether",
      "availableBalance": "1500.25",
      "lockedBalance": "200",
      "version": 42,
      "updatedAt": "2026-08-18T09:20:43.000Z"
    },
    {
      "id": "clw8n2k4x0002abcdefghij",
      "userId": "clw8n1a2b0000abcdefghij",
      "tokenId": 2,
      "walletType": "ASSET",
      "coin": "BTC",
      "name": "Bitcoin",
      "availableBalance": "0.051",
      "lockedBalance": "0",
      "version": 7,
      "updatedAt": "2026-08-18T08:11:02.000Z"
    }
  ],
  "pending": {
    "2": {
      "coin": "BTC",
      "pendingAmountBaseUnits": "150000",
      "count": 1,
      "oldestDetectedAt": "2026-08-18T09:05:00.000Z"
    }
  }
}

Reading the response#

Three things that catch people out#

Request

Request Code Samples

Responses

Reading the response

Three things that catch people out