Skip to main content
GET
/
v1
/
wallets
/
{wallet_id}
/
addresses
/
{address_id}
/
balances
List wallet address balances
curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v1/wallets/{wallet_id}/addresses/{address_id}/balances \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "amount": "12345678",
      "asset": {
        "network_id": "base-sepolia",
        "asset_id": "USDC",
        "decimals": 18,
        "contract_address": "0x036CbD53842c5426634e7929541eC2318f3dCF7e"
      }
    }
  ],
  "has_more": true,
  "next_page": "<string>",
  "total_count": 50
}

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 balances for.

​
address_id
string
required

The onchain address of the address that is being fetched.

Query Parameters

​
page
string

A cursor for pagination across multiple pages of results. Don't include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results.

Maximum string length: 5000

Response

The paginated list of balances

​
data
object[]
required
​
has_more
boolean
required

True if this list has another page of items after this one that can be fetched.

​
next_page
string
required

A token which can be provided as page token to retrieve the next page. If this field is omitted, there are no additional pages.

​
total_count
integer
required

The total number of balances for the wallet.

Example:

50