Introduction

Gain access to past balance records with Historical Account Balances API

This API grants users access to past balance records for detailed financial history. It is perfect for compliance, reconciliation, and auditing for finance processes. Currently, we only support ERC20 tokens on the ETH mainnet.

The Historical Account Balances API is part of the Verify bundles.

📘

Note:

We only keep 13 months of the historical data.

Authentication

You can authenticate your request by using your API Key either as a:

  • Query parameter (?apiKey=<YOUR_API_KEY>)

or

  • Header (X-API-Key: <YOUR_API_KEY>)

📘

Info:

Refer to the Authenticate Your API Requests page for more details.

Endpoint Structure

The URL structure for Historical Token Balances API endpoints is as follows.

https:/svc.blockdaemon.com/balances/{version}/{protocol}/{network}/wallet/{address}/tokenbalance

Endpoints

All data will be accessible through the following API endpoints:

Endpoint
Get a List of Current Token Balances - GET /tokenbalance
Get Current Token Balances - GET /tokenbalance/{token}
Get a List of Historical Token Balances - GET /tokenbalance/{token}/historical

👋 Need Help?

Contact us through email or our support page for any issues, bugs, or assistance you may need.