Exchange Rate by Contract Address
Get the current exchange rate for a token by blockchain and contract address.
By default, the base pair (target asset) is EUR
.
For example, querying the contract address 0xdAC17F958D2ee523a2206206994597C13D831ec7
on ethereum-mainnet
will return the amount of EUR that can be exchanged for 1 USDT.
Rates are aggregated from multiple sources for reliable and normalized pricing.
Example Request to get USDT by contract address
curl --request GET \
--url 'https://api.tatum.io/v4/data/rate/contract?chain=ethereum-mainnet&contractAddress=0xdac17f958d2ee523a2206206994597c13d831ec7&basePair=EUR' \
--header 'x-api-key: YOUR_API_KEY'
Example Response of USDT
{
"value": "0.85285664",
"basePair": "EUR",
"timestamp": 1759481315000,
"source": "Tatum",
"chain": "ethereum-mainnet",
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7"
}
Best Practices
- Cache results for frequently accessed contract addresses to reduce API calls.
- Verify the contract address before requesting rates to avoid errors.
- Use appropriate base pairs to match your application’s accounting needs.
- Refresh rates for stablecoins or volatile tokens as needed for trading or dashboards.
- Combine with other endpoints (symbol or batch rates) for a complete portfolio view.
Updated 17 days ago