--- title: "Get information about collection or token" method: GET path: "/v4/data/tokens" tags: ["Token API"] --- # Get information about collection or token `GET /v4/data/tokens` /v4/data/tokens **20 credit per API call** \> πŸ“˜ \*\*Note for v3 API users:\*\* > > As part of our documentation consolidation, we removed the dedicated page for GET /v3/data/tokens. Users can refer to GET /v4/data/tokens for the latest documentation, as both endpoints function the sameβ€”simply replace v4 with v3 in the API URL if using the v3 version. Get information about your favorite token! Our API lets you search for all tokens on: * Ethereum - ethereum-mainnet / ethereum-sepolia * Solana - solana-mainnet / solana-devnet * 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 * Celo - celo-mainnet / celo-testnet * Chiliz - chiliz-mainnet * Tezos - tezos-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 * XDC - xdc-mainnet / xdc-testnet * Sonic - sonic-mainnet / sonic-blaze To get started: * Provide a chain and address of any fungible token, NFT or multitoken collection. If available, our API will return information about them such as their name, symbol, supply, and more. * You can also get extra information (such as metadata) of a specific NFT or multitoken by passing `tokenId` as a query parameter. * You can also get information (such as supply, decimals) about the native currency by passing `'native'` keyword in the `tokenAddress` parameter. It is supported only for the mainnet of the following chains: * Ethereum * Polygon * Berachain * Celo * Tezos * Solana ## Query parameters - `chain` 'ethereum-mainnet' | 'ethereum-sepolia' | 'solana-mainnet' | 'solana-devnet' | 'base-mainnet' | 'base-sepolia' | 'arb-one-mainnet' | 'arb-testnet' | 'bsc-mainnet' | 'bsc-testnet' | 'polygon-mainnet' | 'optimism-mainnet' | 'optimism-testnet' | 'berachain-mainnet' | 'unichain-mainnet' | 'unichain-sepolia' | 'monad-mainnet' | 'monad-testnet' | 'celo-mainnet' | 'celo-testnet' | 'chiliz-mainnet' | 'tezos-mainnet' | 'avax-mainnet' | 'avax-testnet' | 'gno-mainnet' | 'gno-testnet' | 'zksync-mainnet' | 'zksync-testnet' | 'rsk-mainnet' | 'rsk-testnet' | 'ethereum-classic-mainnet' | 'ethereum-classic-testnet' | 'lisk-mainnet' | 'lisk-testnet' | 'xdc-mainnet' | 'xdc-testnet' | 'sonic-mainnet' | 'sonic-blaze', required - `tokenAddress` string, required β€” Contract address of the token. - `tokenId` string, uint256 β€” ID of the token. ## Response `200` OK - union β€” Information about specific collection or token (not all fields are available for every token, e.g. some multitokens do not have name and symbol). - FungibleInfo - `name` string β€” The full name of the fungible token. - `symbol` string β€” The symbol of the fungible token. - `tokenType` string β€” The type of the token (e.g., fungible). - `supply` string β€” The total supply of the fungible token. - `decimals` number β€” The number of decimal places for the fungible token. - `logo` string β€” The logo of the fungible token. - NativeInfo - `symbol` string β€” The symbol of the native currency. - `supply` string β€” The total supply of the native currency. - `decimals` number β€” The number of decimal places for the native currency. - `tokenType` string β€” The token type of the currency. - `logo` string β€” The logo of the native currency. - NftInfo - `symbol` string β€” The symbol of the NFT collection. - `name` string β€” The full name of the NFT collection. - `supply` string β€” The total supply of the NFT collection. - `tokenType` string β€” The type of the token (e.g., ERC721, ERC1155). - MultitokenInfo - `symbol` string β€” The symbol of the multitoken collection. - `name` string β€” The full name of the multitoken collection. - `tokenType` string β€” The type of the token (e.g., ERC1155). - NftTokenInfo - `symbol` string β€” The symbol of the NFT token. - `name` string β€” The name of the NFT token. - `metadata` object β€” The metadata associated with the NFT token. - `metadataURI` string β€” The URI of the metadata associated with the NFT token. - `tokenType` string β€” The type of the token (e.g., ERC721, ERC1155). - NftInfoTezos - `name` string β€” The full name of the NFT collection. - `description` string β€” The total supply of the NFT collection. - `tokenType` string β€” The type of the token (e.g., ERC721, ERC1155). - `contractMetadata` object β€” Additional information about the contract - FungibleInfoTezos - `symbol` string β€” The symbol of the fungible token. - `name` string β€” The full name of the fungible token. - `description` string β€” The describtion of the fungible token. - `supply` string β€” The total supply of the fungible token. - `decimals` number β€” The number of decimal places for the fungible token. - `tokenType` string β€” The type of the token (e.g., fungible, nft). ## Other responses - `400` β€” Bad Request - `401` β€” Unauthorized. Not valid or inactive subscription key present in the HTTP Header. - `403` β€” Forbidden. The request is authenticated, but it is not possible to perform the operation due to logical error or invalid permissions. - `404` β€” Collection or token not found. - `500` β€” Internal server error. There was an error on the server during the processing of the request. --- [API](https://skmtc.net/tatum/apis/blockchain-data.md) Β· [All operations](https://skmtc.net/tatum/apis/blockchain-data/llms.txt) Β· [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tatum/blockchain-data/revisions/8622ee4b8fae/schema)