Check owner of token
Changed on/v4/data/owners/address
50 credit per API call
> 📘 **Note for v3 API users:** > > As part of our documentation consolidation, we removed the dedicated page for GET /v3/data/owners/address. Users can refer to GET /v4/data/owners/address for the latest documentation, as both endpoints function the same—simply replace v4 with v3 in the API URL if using the v3 version.
Check if wallet address owns any specified token (ERC-20, ERC-721 or ERC-1155) on the following blockchains:
- Ethereum - ethereum-mainnet / ethereum-sepolia
- Base - base-mainnet / base-sepolia
- Arbitrum - arb-one-mainnet / arb-testnet
- BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet
- Polygon - polygon-mainnet
- Optimism - optimism-mainnet / optimism-testnet
- Berachain - berachain-mainnet
- Unichain - unichain-mainnet / unichain-sepolia
- Monad - monad-mainnet / monad-testnet
- Robinhood - robinhood-mainnet / robinhood-testnet
- Celo - celo-mainnet / celo-testnet
- Chiliz - chiliz-mainnet
- Avalanche - avax-mainnet / avax-testnet
- Gnosis - gno-mainnet / gno-testnet
- zkSync - zksync-mainnet / zksync-testnet
- Rootstock - rsk-mainnet / rsk-testnet
- Ethereum Classic - ethereum-classic-mainnet / ethereum-classic-testnet
- Lisk - lisk-mainnet / lisk-testnet
To get started:
- Provide a chain name, wallet address and address of any fungible token, NFT or multitoken collection. Our API will return true if provided wallet address owns them.
- If wallet address does not own the specific token, response body is false and status code is 200.
- It is also possible to check if wallet address owns a specific NFT by specifying a tokenId.
Request
- Base URLhttps://api.tatum.io
- URLhttps://api.tatum.io/v4/data/owners/address
- AuthAPI key in header x-api-key
Query parameters
The blockchain to work with.
The blockchain address of the wallet.
Contract address of the token.
The blockchain address of the token (NFT collection or any fungible token).
ID of the token.
The ID of a specific NFT token.
Response
OK
Example response
true
Changes
- info
added the new enum value
robinhood-mainnetto thequeryrequest parameterchain - info
added the new enum value
robinhood-testnetto thequeryrequest parameterchain
- info