Skip to content

Get Owners by Contract Address

This endpoint returns all Accounts that own a given token, identified by a contract address (supports pagination). Ownership and balances are only updated once the underlying transaction causing the change in ownership/balance is confirmed by the network (roughly ~10 minutes on all chains). Supported chains: ethereum, polygon, optimism, scroll, arbitrum, base, avalanche.

Looking for historical token data? Check out our historical_token_owners, historical_token_balances_by_account, and historical_native_token_balance_by_account endpoints to query balance and ownership data at a particular timestamp.

Parameters

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 (supports ENS names). string
limit The maximum number of results to retrieve (default 100). string

curl -X GET \
    'https://api.transpose.io/token/owners-by-contract-address?chain_id=ethereum&contract_address=0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2' \
    -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.