GET
/
v2
/
evm
/
token-balances
/
{network}
/
{address}
List EVM token balances
curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/evm/token-balances/{network}/{address} \
  --header 'Authorization: Bearer <token>'
{
  "balances": [
    {
      "amount": {
        "amount": "1250000000000000000",
        "decimals": 18
      },
      "token": {
        "network": "base",
        "symbol": "ETH",
        "name": "ether",
        "contractAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"
      }
    },
    {
      "amount": {
        "amount": "123456",
        "decimals": 6
      },
      "token": {
        "network": "base",
        "symbol": "USDC",
        "name": "USD Coin",
        "contractAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
      }
    }
  ],
  "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

​
address
string
required

The 0x-prefixed EVM address to get balances for. The address does not need to be checksummed.

​
network
enum<string>
required

The human-readable network name to get the balances for.

Available options:
base,
base-sepolia,
ethereum
Example:

"base"

Query Parameters

​
pageSize
integer
default:20

The number of balances to return per page.

​
pageToken
string

The token for the next page of balances. Will be empty if there are no more balances to fetch.

Response

Successfully listed token balances.

​
balances
object[]
required

The list of EVM token balances.

Example:
[
  {
    "amount": {
      "amount": "1250000000000000000",
      "decimals": 18
    },
    "token": {
      "network": "base",
      "symbol": "ETH",
      "name": "ether",
      "contractAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"
    }
  },
  {
    "amount": { "amount": "123456", "decimals": 6 },
    "token": {
      "network": "base",
      "symbol": "USDC",
      "name": "USD Coin",
      "contractAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
    }
  }
]
​
nextPageToken
string

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

Example:

"eyJsYXN0X2lkIjogImFiYzEyMyIsICJ0aW1lc3RhbXAiOiAxNzA3ODIzNzAxfQ=="