GET
/
v1
/
networks
/
{network_id}
/
addresses
/
{address_id}
/
balances
/
{asset_id}
Get address balance by asset ID
curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v1/networks/{network_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

​
network_id
string
required

The ID of the blockchain network.

​
address_id
string
required

The onchain address to fetch the balance for.

​
asset_id
string
required

The symbol of the asset to fetch the balance for.

Response

The balance of the asset in the address

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.