Skip to content

Get Owners by Token ID

This endpoint returns all Accounts that own a given NFT, identified by a collection contract address and token ID pair (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 NFT data? Check out our historical_nft_balances_by_account and historical_nft_owners endpoints to query balance and ownership data at a particular timestamp.


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 collection to retrieve owners for (supports ENS names). string
token_id required The token ID of the NFT to retrieve owners for. integer
limit The maximum number of results to retrieve (default 100). string

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.