GET
/
v1
/
wallets
/
{wallet_id}
/
addresses
/
{address_id}
/
balances
/
{asset_id}
Get wallet address balance by asset ID
curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v1/wallets/{wallet_id}/addresses/{address_id}/balances/{asset_id} \
  --header 'Authorization: Bearer <token>'
{
  "amount": "12345678",
  "asset": {
    "network_id": "base-sepolia",
    "asset_id": "USDC",
    "decimals": 18,
    "contract_address": "0x036CbD53842c5426634e7929541eC2318f3dCF7e"
  }
}

Authorizations

​
Authorization
string
header
required

Enter your JSON Web Token (JWT) here. Refer to the Generate JWT section of our Authentication docs for information on how to generate your Bearer Token.

Path Parameters

​
wallet_id
string
required

The ID of the wallet to fetch the balance for.

​
address_id
string
required

The onchain address of the address that is being fetched.

​
asset_id
string
required

The symbol of the asset to fetch the balance for.

Response

Success response

The balance of an asset onchain

​
amount
string
required

The amount in the atomic units of the asset

Example:

"12345678"

​
asset
object
required

An asset onchain scoped to a particular network, e.g. ETH on base-sepolia, or the USDC ERC20 Token on ethereum-mainnet.