Token Details

This guide walks you through getting the token details to show in your apps.

Token Details lets you get comprehensive information about any token, whether it's a fungible token, NFT, multi-token, or the native currency of a chain. This is useful for portfolio apps, NFT dashboards, and trading platforms.

What You Can Do

  • Fetch token information by providing a chain and token address.
  • Get NFT/multi-token metadata by passing tokenId as a query parameter.
  • Get native currency info by passing 'native' in the tokenAddress parameter (supported only on mainnets of Ethereum, Polygon, Berachain, Celo, Tezos, and Solana).
  • Retrieve details such as name, symbol, token type, total supply, decimals, and more.

API Endpoint: Get Token Details

📘

Get Tokens by Address (Popular🔥)

GET /v4/data/tokens
Retrieve all token information (metadata) for a specific token.
Explore Docs →

Example Requests to get tokens

Get information about an NFT collection:

curl -X GET "https://api.tatum.io/v4/data/token?chain=ethereum-mainnet&tokenAddress=0xba30E5F9Bb24caa003E9f2f0497Ad287FDF95623" \
  -H "x-api-key: YOUR_API_KEY"
const options = {
  method: 'GET',
  headers: {
    accept: 'application/json',
    'x-api-key': 'YOUR_API_KEY'
  }
};

fetch('https://api.tatum.io/v4/data/tokens?chain=ethereum-mainnet&tokenAddress=0xba30E5F9Bb24caa003E9f2f0497Ad287FDF95623', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Get information about a native currency (ETH on Ethereum mainnet):

curl -X GET "https://api.tatum.io/v4/data/token?chain=ethereum-mainnet&tokenAddress=native" \
  -H "x-api-key: YOUR_API_KEY"
const options = {
  method: 'GET',
  headers: {
    accept: 'application/json',
    'x-api-key': 'YOUR_API_KEY'
  }
};

fetch('https://api.tatum.io/v4/data/tokens?chain=ethereum-mainnet&tokenAddress=native', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Get metadata of a specific NFT by tokenId:

curl -X GET "https://api.tatum.io/v4/data/token?chain=ethereum-mainnet&tokenAddress=0xba30E5F9Bb24caa003E9f2f0497Ad287FDF95623&tokenId=1" \
  -H "x-api-key: YOUR_API_KEY"
const options = {
  method: 'GET',
  headers: {
    accept: 'application/json',
    'x-api-key': 'YOUR_API_KEY'
  }
};

fetch('https://api.tatum.io/v4/data/tokens?chain=ethereum-mainnet&tokenAddress=0xba30E5F9Bb24caa003E9f2f0497Ad287FDF95623&tokenId=1', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Sample Response of token details

{
  "name": "BoredApeKennelClub",
  "symbol": "BAKC",
  "tokenType": "nft",
  "supply": "9602"
}

Token Exchange Rates

You can also get current exchange rates for tokens or native currencies.

📘

Get Exchange Rate by Symbol (Popular)

GET /v4/data/rate/symbol
Fetch the current exchange rate for a single crypto or fiat asset.
Explore Docs →

By Token Symbol

Example Request to get BTC EUR

curl -X GET "https://api.tatum.io/v4/data/exchange-rate?symbol=BTC&basePair=EUR" \
  -H "x-api-key: YOUR_API_KEY"
const options = {
  method: 'GET',
  headers: {
    accept: 'application/json',
    'x-api-key': 't-66a730ccccfd17001c479705-2f597d14ad7543f289a03418'
  }
};

fetch('https://api.tatum.io/v4/data/rate/symbol?symbol=BTC&basePair=EUR', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Sample Response for BTC price in EUR

{
  "value": "100925.00000000",
  "basePair": "EUR",
  "timestamp": 1759396770560,
  "source": "CoinGecko",
  "symbol": "BTC"
}

By Chain & Contract Address

Example Request by fetching contract address

curl -X GET "https://api.tatum.io/v4/data/exchange-rate/address?chain=ethereum-mainnet&contractAddress=0xdac17f958d2ee523a2206206994597c13d831ec7&basePair=EUR" \
  -H "x-api-key: YOUR_API_KEY"
const options = {
  method: 'GET',
  headers: {
    accept: 'application/json',
    'x-api-key': 'YOUR_API_KEY'
  }
};

fetch('https://api.tatum.io/v4/data/rate/contract?chain=ethereum-mainnet&contractAddress=0xdac17f958d2ee523a2206206994597c13d831ec7&basePair=EUR', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Sample Response

{
  "value": "0.85079681",
  "basePair": "EUR",
  "timestamp": 1759396844884,
  "source": "Tatum",
  "chain": "ethereum-mainnet",
  "address": "0xdac17f958d2ee523a2206206994597C13D831ec7"
}

Usage Workflow

  1. Select Token – Provide chain and token address (or 'native').
  2. Call API – Request token details or exchange rate.
  3. Optional NFT Info – Provide tokenId for specific NFT/multi-token metadata.
  4. Display – Show token info in your app, including name, symbol, supply, and exchange value.

Best Practices

  • Always specify the correct chain for the token.
  • Use tokenId only for NFT/multi-token queries.
  • Cache responses to reduce repeated API calls for popular tokens.
  • Combine with portfolio and transaction APIs to give a full asset overview.