TAtatum
Token API

Get Exchange Rate History by Symbol

Changed on

/v4/data/rate/history

50 credits per API call

Retrieves token prices, FDV, and liquidity at any block or timestamp, including percentage change for specified lookback periods.

Supported blockchains:

  • Ethereum - ethereum-mainnet
  • Base - base-mainnet
get/v4/data/rate/history

Request

  • Base URL
    https://api.tatum.io
  • URL
    https://api.tatum.io/v4/data/rate/history
  • Auth
    API key in header x-api-key

Query parameters

chain'ethereum-mainnet' | 'base-mainnet' required

Chains supported by the tokens and wallets endpoints.

The blockchain to work with.

contractAddressstring
Example:0x2260fac5e5542a773aa44fbcfedf7c193bc2c599

Contract address of token. Mutually exclusive with symbol.

blockNumbernumber
Example:16499510
timestampstring date-time
Example:2025-09-25T16:00:01Z

Date-time UTC timestamp in format YYYY-MM-DDTHH:mm:ssZ (ignored if blockNumber is present)

symbolstring

The fiat or crypto asset to exchange.

Example:BTC

The fiat or crypto asset to exchange. Mutually exclusive with contractAddress.

basePair'USD' | 'BTC' | 'ETH' required
Example:USD

The target asset to get the exchange rate for

lookbackMinutesstring
Example:15,30

Minutes to calculate price change over time, comparing to defined point of time in blockNumber or timestamp, comma separated

Response

OK

pricenumber required

Price of the asset in the requested basePair at the priced instant. Returns 0 when no observation is available for the request, which is not distinguishable from a genuine price of 0.

addressstring

Contract address of the priced token. Returned only when the upstream holds it for this token, and never for symbol lookups.

fdvnumber

Fully diluted valuation, in the requested basePair. Returned only when the upstream holds it for this token.

liquiditynumber

Pool liquidity for the token, in the requested basePair. Returned only when the upstream holds it for this token.

Example response

{
  "price": 84858.18087819443,
  "priceChanges": [
    {
      "minutes": 1440,
      "priceChange": "0.72%"
    }
  ],
  "address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
  "fdv": 39410377,
  "liquidity": 314135928
}

Changes

  • 1a87afa0f639Revision changes
    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      the query request parameter contractAddress became optional

    • info

      the query request parameter symbol became optional

    • info

      for the query request parameter timestamp, the type was generalized from number to string, and format from no format to date-time

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status