Exchange Rate by 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.