Skip to main content
GET
/
v1
/
networks
/
{network_id}
/
addresses
/
{address_id}
/
balance_history
/
{asset_id}
Get address balance history for asset
curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v1/networks/{network_id}/addresses/{address_id}/balance_history/{asset_id} \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "amount": "12345678",
      "block_hash": "0x53e11e94ebb2438d6ddcfa07dabc9b551d2f440f8363fea941083bc397a86a42",
      "block_height": "12345",
      "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

Blockchain network identifier.

​
address_id
string
required

Blockchain address hash (Note that EVM chain address hash should be lowered cased).

​
asset_id
string
required

The symbol of the asset to fetch the historical balance for.

Query Parameters

​
limit
integer

A limit on the number of objects to be returned. The default value is 10. The maximum value is 100, and values supplied over this will be coerced to the maximum.

​
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 length: 5000

Response

Success response

​
data
object[]
required

The balance of an asset onchain at a particular block

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