🔍

Historical Values

Use results and backtrack to retrieve time-series data in a single call.

By default every indicator call returns one value — the most recent calculated result. The results and backtrack parameters let you retrieve a window of historical values without making multiple requests.

These parameters work on all single indicator requests and on each indicator within a bulk call. The candles endpoint also accepts results and backtrack with the same semantics.

The results parameter

Set results to an integer to receive that many consecutive values ending at the most recent candle.

Request — last 10 RSI values
GET https://v2.taapi.io/indicator/rsi
  ?exchange=binance
  &symbol=BTCUSDT
  &timeframe=1h
  &results=10
Response
{
  "value":     [61.2, 63.4, 58.9, 67.1, 62.3, 55.8, 70.2, 48.6, 59.1, 64.7],
  "timestamp": [1708243200, 1708246800, 1708250400, 1708254000, 1708257600,
                1708261200, 1708264800, 1708268400, 1708272000, 1708275600]
}
Array ordering: Results are returned in ascending order — value[0] and timestamp[0] are the oldest values, and the last element is the most recent. This is consistent across all indicator and candle endpoints.

Using max

Pass results=max to return all available historical values for this symbol/timeframe combination.

All available RSI values
GET /indicator/rsi?exchange=binance&symbol=BTCUSDT&timeframe=1h&results=max
Note: The number of values returned by results=max depends on how much historical data is cached for the given symbol and timeframe. For example, rsi on binance / BTCUSDT / 1h returns approximately 1,986 values.

The backtrack parameter

backtrack shifts the result window back in time by N candles. The default is 0 (no shift — the most recent candle is the last in the window).

A useful mental model: the API computes the indicator as if the current time were N candles ago. Combined with results, this lets you page through history without overlap.

RSI as it was 24 candles ago (on 1h, that's 24 hours back)
GET /indicator/rsi?exchange=binance&symbol=BTCUSDT&timeframe=1h&backtrack=24
Window of 10 values starting 50 candles ago
GET /indicator/rsi?exchange=binance&symbol=BTCUSDT&timeframe=1h&results=10&backtrack=50

In the second example, the result contains 10 values from 59 candles ago through 50 candles ago (the window ends at backtrack).

In bulk requests

results and backtrack can be set per-indicator inside a bulk construct:

Bulk with historical results
{
  "constructs": [
    {
      "id": "btc_1h",
      "exchange": "binance",
      "symbol": "BTCUSDT",
      "timeframe": "1h",
      "indicators": [
        { "id": "rsi_hist", "indicator": "rsi", "results": 5, "backtrack": 0 }
      ]
    }
  ]
}