Historical Balances | Docs | The Graph

⌘ K

GET/historical/balances/evm/{address}

Provides historical ERC-20 & Native balances by wallet address.

Path Parameters

Parameter Description Value

address

string

Filter by address

Required

Query Parameters

Parameter	Description	Value
`network_id` string	The Graph Network ID for EVM networks https://thegraph.com/networks Default value: `mainnet` Accepted values: `arbitrum-one`, `avalanche`, `base`, `bsc`, `mainnet`, `matic`, `optimism`, `unichain`	Required mainnet
`interval`	The interval for which to aggregate price data (hourly, 4-hours, daily or weekly).
`contracts` array	Default value:
`startTime` integer	UNIX timestamp in seconds. Minimum value: `-9007199254740991` Maximum value: `9007199254740991`
`endTime` integer	UNIX timestamp in seconds. Default value: `9999999999` Minimum value: `-9007199254740991` Maximum value: `9007199254740991`
`limit` integer	The maximum number of items returned in a single request. Default value: `10` Minimum value: `1` Maximum value: `1000`
`page` integer	The page number of the results to return. Default value: `1` Minimum value: `1` Maximum value: `767465558638`

Potential Responses

Status	Description
200	Successful Response
400	Client side error
401	Authentication failed
403	Forbidden
404	Not found
500	Server side error

Test this endpoint

1curl --request GET \2  --url 'https://token-api.thegraph.com/historical/balances/evm/{address}?network_id=mainnet&startTime=0&endTime=9999999999&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'

1{2  "data": [3    {4      "datetime": "2025-05-29 00:00:00",5      "contract": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",6      "name": "Native",7      "symbol": "ETH",8      "decimals": 18,9      "open": 237.63774262699187,10      "high": 237.6377453469919,11      "low": 0.10533323067535896,12      "close": 0.15438623067535898,13      "network_id": "mainnet"14    }15  ]16}