GET
/
v2
/
evm
/
token-balances
/
{network}
/
{address}
curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/evm/token-balances/{network}/{address}
{
  "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=="
}

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
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

200
application/json

Successfully listed token balances.

The response is of type object.