📈Timeseries of balances

Summary

This API gives access to balances of all the tokens for a given address at any number of points in time, in a single fast RPC. The response also includes corresponding fiat values (in USD) for popular tokens.

Tokens covered: Native, ERC-20. [ERC-721 and ERC-1155 support is coming soon].

Syntax

GET /$CHAIN/v1/address/$ADDRESS/timeseries

Ways to specify a timeseries

You can specify the Timeseries in multiple ways:

• For a list of specific blocks

• Based on timestamps

  • number of data points along with duration between the 2 points. Granularity for duration can be specified in min/h/d/w/mo/yr. For example: "30 data points spaced 1d apart".

  • for the specified timespan along with the desired number of points for that span. Timespan can again be specified in min/h/d/w/mo/yr. For example: "1w timespan with 42 data points".

  • Timeseries can be shifted to any point in the past.

Query params

You can use the following params to further refine the output. These are common to retrievals over specific block numbers and over specific timestamps.

Param	Default value	Note
details	all	"all": response includes all the details "summary": gets only a high level summary (block number, timestamp, fiat value).
allow_contract	empty	comma separated allow list of EVM addresses including “0x” only the balances for the specified contracts (i.e. tokens) are returned use "native" to specify the native currency supports only ERC20 contracts [ERC-721, ERC-1155 support coming soon] if empty, balances for all the contracts are returned do not specify both this and block_contract
block_contract	empty	comma separated block list of EVM addresses including “0x” balances for the specified contracts (i.e. tokens) are not returned use "native" to specify the native currency supports only ERC20 contracts [ERC-721, ERC-1155 support coming soon] if empty, balances for all the contracts are returned do not specify both this and allow_contract