Guides
SupportStatusSign UpLogin

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.

Updated 9 days ago