Sign in

v1

latestOpenAPI 3.1.02026-07-243035381.4 MB
Token API

Get information about collection or token

/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
get/v4/data/tokens

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
Example:ethereum-mainnet

The blockchain to work with.

tokenAddressstring required

Contract address of the token.

Example:0xba30E5F9Bb24caa003E9f2f0497Ad287FDF95623

The blockchain address of the token (NFT collection or any fungible token) or 'native' keyword to get information about the native currency of the chain.

tokenIdstring uint256

ID of the token.

Example:3

The ID of a specific NFT token.

Response

OK

OR
OR
OR
OR
OR
OR

Example response

{
  "name": "USD Coin",
  "symbol": "USDC",
  "tokenType": "fungible",
  "supply": "48699269596631307",
  "decimals": 6,
  "logo": "https://blockchains.tatum.io/assets/token-logos/ethereum-mainnet/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.png"
}