public/get_tradingview_chart_data

Retrieves publicly available market data formatted for generating TradingView-compatible candle charts. The data includes open, high, low, close (OHLC) prices and volume for specified time intervals.

Use the chart_resolution parameter to specify the candle interval (e.g., 1m, 5m, 1h, 1d). This method provides the standard format used by TradingView and other charting platforms.

Try in API console

cURL

cURL

curl --request GET \
  --url https://test.deribit.com/api/v2/public/get_tradingview_chart_data \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 833,
  "method": "public/get_tradingview_chart_data",
  "params": {
    "instrument_name": "BTC-5APR19",
    "start_timestamp": 1554373800000,
    "end_timestamp": 1554376800000,
    "resolution": "30"
  }
}
'

200

{
  "jsonrpc": "2.0",
  "id": 833,
  "result": {
    "volume": [
      19.007942601,
      20.095877981
    ],
    "cost": [
      19000,
      23400
    ],
    "ticks": [
      1554373800000,
      1554375600000
    ],
    "status": "ok",
    "open": [
      4963.42,
      4986.29
    ],
    "low": [
      4728.94,
      4726.6
    ],
    "high": [
      5185.45,
      5250.87
    ],
    "close": [
      5052.95,
      5013.59
    ]
  },
  "usIn": 1554381680742493,
  "usOut": 1554381680742698,
  "usDiff": 205,
  "testnet": false
}

Query Parameters

instrument_name · string · required

Instrument name Unique instrument identifier

Example:

"BTC-PERPETUAL"

start_timestamp · integer · required

The earliest timestamp to return result from (milliseconds since the UNIX epoch) The timestamp (milliseconds since the Unix epoch)

Example:

1536569522277

end_timestamp · integer · required

The most recent timestamp to return result from (milliseconds since the UNIX epoch) The timestamp (milliseconds since the Unix epoch)

Example:

1536569522277

resolution · enum<string> · required

Chart bars resolution given in full minutes or keyword 1D (only some specific resolutions are supported)

Available options: 1, 3, 5, 10, 15, 30, 60, 120, 180, 360, 720, 1D

Response

200 - application/json

Success response

jsonrpc · enum<string> · required

The JSON-RPC version (2.0)

Available options: 2.0

result · object · required

Hide child attributes

result. status · enum<string>

Status of the query: ok or no_data

Available options: ok, no_data

result. ticks · integer[]

Values of the time axis given in milliseconds since UNIX epoch

The timestamp (milliseconds since the Unix epoch)

result. volume · number[]

List of volume bars (in base currency, one per candle)

// todo

result. cost · number[]

List of cost bars (volume in quote currency, one per candle)

// todo

result. open · number[]

List of prices at open (one per candle)

Price in quote currency

result. close · number[]

List of prices at close (one per candle)

Price in quote currency

result. high · number[]

List of highest price levels (one per candle)

Price in quote currency

result. low · number[]

List of lowest price levels (one per candle)

Price in quote currency

id · integer

The id that was sent in the request