Skip to content

Historical Token Owners

The optimism.historical_token_owners table is a time-series of ERC20 token balances for a given owner_address every time it sends or receives a token.

Columns

Name Type Description
balance numeric The balance of the owner_address after sending/receiving at the block_number.
block_number integer The block number the owner_address sent or received the token at.
contract_address text Contract address ERC20 token.
owner_address text The owner address that sent or received the token in the block.
timestamp timestamp The block number the owner_address sent or received the token at (in ISO-8601 format).
__block_number integer An internal identifier for the indexer that updates this row. Use block_number instead when querying.
__confirmed boolean Flag indicating whether the balance has been confirmed by the network.
__last_modified timestamp The timestamp when this row was last updated.

Indexes

Index
__last_modified
__indexer_id WHERE __confirmed = false
contract_address, owner_address, timestamp
owner_address, timestamp
__indexer_id, __block_number
owner_address, contract_address, timestamp

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.