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 thetokenAddress
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
- Select Token – Provide chain and token address (or
'native'
). - Call API – Request token details or exchange rate.
- Optional NFT Info – Provide
tokenId
for specific NFT/multi-token metadata. - 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 1 day ago