Token Details

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

Request Type: GET
Endpoint: /v4/data/token

Query Parameters:

Example Requests

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"

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"

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"

Sample Response

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

Token Exchange Rates

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

By Token Symbol

Query Parameters:

Example Request:

curl -X GET "https://api.tatum.io/v4/data/exchange-rate?symbol=BTC&basePair=EUR" \
  -H "x-api-key: YOUR_API_KEY"

Sample Response:

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

By Chain & Contract Address

Query Parameters:

Example Request:

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"

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.