Skip to main content
GET
/
v2
/
accounts
/
{accountId}
/
balances
List balances for account
curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/accounts/{accountId}/balances \
  --header 'Authorization: Bearer <token>'
{
  "balances": [
    {
      "asset": {
        "symbol": "btc",
        "type": "crypto",
        "name": "Bitcoin",
        "decimals": 8
      },
      "amount": {
        "btc": {
          "available": "2.5",
          "total": "3.0"
        },
        "usd": {
          "available": "252705.4",
          "total": "303246.48"
        }
      }
    },
    {
      "asset": {
        "symbol": "usd",
        "type": "fiat",
        "name": "United States Dollar",
        "decimals": 2
      },
      "amount": {
        "usd": {
          "available": "90",
          "total": "100"
        }
      }
    }
  ],
  "nextPageToken": "eyJsYXN0X2lkIjogImFiYzEyMyIsICJ0aW1lc3RhbXAiOiAxNzA3ODIzNzAxfQ=="
}

Authorizations

​
Authorization
string
header
required

A JWT signed using your CDP API Key Secret, encoded in base64. Refer to the Generate Bearer Token section of our Authentication docs for information on how to generate your Bearer Token.

Path Parameters

​
accountId
string
required

The unique identifier of the account.

Example:

"account_af2937b0-9846-4fe7-bfe9-ccc22d935114"

Query Parameters

​
pageSize
integer
default:20

The number of resources to return per page.

​
pageToken
string

The token for the next page of resources, if any.

Response

Successfully listed balances.

A list of balances for an account.

​
balances
object[]
required

The list of balances.

A balance of an asset.

Example:
{
  "asset": {
    "symbol": "btc",
    "type": "crypto",
    "name": "Bitcoin",
    "decimals": 8
  },
  "amount": {
    "btc": { "available": "2.5", "total": "3.0" },
    "usd": {
      "available": "252705.4",
      "total": "303246.48"
    }
  }
}
Example:
[
  {
    "asset": {
      "symbol": "btc",
      "type": "crypto",
      "name": "Bitcoin",
      "decimals": 8
    },
    "amount": {
      "btc": { "available": "2.5", "total": "3.0" },
      "usd": {
        "available": "252705.4",
        "total": "303246.48"
      }
    }
  }
]
​
nextPageToken
string

The token for the next page of items, if any.

Example:

"eyJsYXN0X2lkIjogImFiYzEyMyIsICJ0aW1lc3RhbXAiOiAxNzA3ODIzNzAxfQ=="