Skip to content

Get Historical NFT Balances by Account

This endpoint returns the NFT Balances for an account at a given timestamp, ordered by contract address (supports pagination). Supported chains: ethereum.


Parameter Description Type
chain_id A keyword (i.e. "ethereum") or CAIP-2 identifier specifying the blockchain to query. string
account_address required The account address to retrieve a balance for (supports ENS names). string
timestamp The timestamp time at which you wish to fetch the NFT balances at (in seconds since the Unix epoch or ISO-8601 format). date-time
contract_address The contract address of the token to filter results by. string
limit The maximum number of results to retrieve (default 100). integer

curl -X GET \
    '' \
    -H 'X-API-KEY: BtRVYj7dgnYUcr1gSSfWhmrTShIb8RBG' \

Got questions? Join our Discord

Discord is the primary home of the Transpose developer community. Join us to ask questions, share your work, and get help.