Get 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.

Query Parameters

Parameter	Type	Required	Description
`chain`	string	✅	Blockchain to query (e.g., `ethereum-mainnet`).
`contractAddress`	string	✅	The smart contract address of the token.
`basePair`	string	❌	Target fiat asset (default: `EUR`).

Example Query Parameters:

Parameter	Example Value
chain	ethereum-mainnet
contractAddress	0xdac17f958d2ee523a2206206994597c13d831ec7
basePair	EUR

Example Request

curl --location '<https://api.tatum.io/v4/exchange-rate/contract/ethereum-mainnet/0xdAC17F958D2ee523a2206206994597C13D831ec7/EUR'>  
--header 'x-api-key: {YOUR_API_KEY}'

Example Response

{  
  "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.