Crypto Heatmaps with Price API

Crypto Price Change API (Absolute & Percentage)

Get price change data for a symbol over a specified time range or interval. This endpoint calculates the price change (both absolute and percentage) for a given symbol between two points in time. Supported symbols: We support 439+ trading pairs. The symbol parameter accepts the base currency (e.g., BTC, ETH).

Base pair: By default, the base pair is USDT. You can specify a different quote asset (e.g., ETH, USDC) using the basePair parameter.

Example Request

📘

Get Price Change by Symbol

GET /v4/data/rate/price-change
Retrieve price change data (absolute + percentage) for a symbol over a chosen time range or interval.
Explore Docs →

Get BTC → ETH Price Change (Explicit Time Range)

curl --request GET \
     --url 'https://api.tatum.io/v4/data/rate/price-change?symbol=BTC&basePair=ETH&timeFrom=2024-01-01T00%3A00%3A00Z&timeTo=2025-01-02T00%3A00%3A00Z' \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

Example Response

{
  "symbol": "BTC",
  "basePair": "ETH",
  "open": "18.53023178",
  "close": "28.14913491",
  "openTime": 1704067200000,
  "closeTime": 1735775999999,
  "absoluteChange": "9.61890313",
  "percentageChange": 51.91
}

Response Fields

Time Range Options

You must provide either:

Explicit Time Range

Provide both:

• timeFrom → ISO 8601 date-time
• timeTo → ISO 8601 date-time

Example:

timeFrom=2024-01-01T00:00:00Z
timeTo=2025-01-02T00:00:00Z

Interval-Based

Provide:

• interval → Calculates change from the last fully closed candle of that interval.

Supported intervals:

1m, 5m, 15m, 30m, 45m, 1h, 2h, 4h, 1d, 1w, 1M, 1y

Important Rules

• You must provide either (timeFrom + timeTo) OR interval.
• Do not combine explicit time range with interval.
• If no basePair is provided, default is USDT.

What Is Crypto Price Change?

Price change measures how much an asset has increased or decreased between two points in time.

There are two ways to express it:

• Absolute change → Close − Open
• Percentage change → (Close − Open) / Open × 100

This metric is commonly used in:

• Crypto heatmaps
• Market performance tracking
• Gainers/losers ranking
• Portfolio analytics
• Backtesting strategies