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.