Skip to content

Get Historical Token Owners

This endpoint returns all Accounts that own a given token at a given timestamp, identified by a contract address and ordered by owner address (supports pagination). Supported chains: ethereum, polygon, arbitrum, optimism, base, avalanche, nova.


Parameter Description Type
chain_id A keyword (i.e. "ethereum") or CAIP-2 identifier specifying the blockchain to query. string
contract_address required The contract address of the token to retrieve owners for. string
timestamp The timestamp time at which you wish to fetch the token owners at (in seconds since the Unix epoch or ISO-8601 format). date-time
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.