Get historical token balances for address
Commonly used to fetch the historical native, fungible (ERC20), and non-fungible (ERC721 & ERC1155) tokens held by an address at a given block height or date. Response includes daily prices and other metadata.
Processing: Realtime
Supports only Ethereum, Binance Smart Chain and Polygon.
Path Parameters
The chain name eg: eth-mainnet
.
The requested address. Passing in an ENS
, RNS
, Lens Handle
, or an Unstoppable Domain
resolves automatically.
Query Parameters
The currency to convert. Supports USD
, CAD
, EUR
, SGD
, INR
, JPY
, VND
, CNY
, KRW
, RUB
, TRY
, NGN
, ARS
, AUD
, CHF
, and GBP
.
If true
, NFTs will be included in the response.
If true
, only NFTs that have been cached will be included in the response. Helpful for faster response times.
If true
, the suspected spam tokens are removed. Supports eth-mainnet
and matic-mainnet
.
If true
, the response shape is limited to a list of collections and token ids, omitting metadata and asset information. Helpful for faster response times and wallets holding a large number of NFTs.
Ending block to define a block range. Omitting this parameter defaults to the latest block height.
Ending date to define a block range (YYYY-MM-DD). Omitting this parameter defaults to the current date.
Response
The requested address.
The timestamp when the response was generated. Useful to show data staleness to users.
The requested quote currency eg: USD
.
The requested chain ID eg: 1
.
The requested chain name eg: eth-mainnet
.
List of response items.