GET
/
v1
/
networks
/
{network_id}
/
addresses
/
{address_id}
/
stake
/
balances
Fetch historical staking balances
curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v1/networks/{network_id}/addresses/{address_id}/stake/balances \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "address": "0x80000001677f23a227dfed6f61b132d114be83b8ad0aa5f3c5d1d77e6ee0bf5f73b0af750cc34e8f2dae73c21dc36f4a",
      "date": "2024-07-21",
      "bonded_stake": {
        "amount": "12345678",
        "asset": {
          "network_id": "base-sepolia",
          "asset_id": "USDC",
          "decimals": 18,
          "contract_address": "0x036CbD53842c5426634e7929541eC2318f3dCF7e"
        }
      },
      "unbonded_balance": {
        "amount": "12345678",
        "asset": {
          "network_id": "base-sepolia",
          "asset_id": "USDC",
          "decimals": 18,
          "contract_address": "0x036CbD53842c5426634e7929541eC2318f3dCF7e"
        }
      },
      "participant_type": "validator"
    }
  ],
  "has_more": true,
  "next_page": "<string>"
}

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.

Maximum length: 5000
​
address_id
string
required

The onchain address for which the historical staking balances are being fetched.

Maximum length: 5000

Query Parameters

​
limit
integer

A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 50.

​
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
​
asset_id
string
required

The symbol of the asset for which the historical staking balances are being fetched.

Maximum length: 5000
​
start_time
string
required

The start time of this historical staking balance period.

​
end_time
string
required

The end time of this historical staking balance period.

Response

200
application/json

The list of historical staking balances.