GET
/
options
/
batch-ohlcv
/
{exchange}
Batch Historical
curl --request GET \
  --url https://api.amberdata.com/markets/options/batch-ohlcv/{exchange} \
  --compressed \
  --header 'Accept-Encoding: <accept-encoding>' \
  --header 'x-api-key: <api-key>'
{
  "status": 200,
  "title": "OK",
  "description": "Successful request",
  "payload": {
    "metadata": {
      "next": null,
      "api-version": "2023-09-30"
    },
    "data": [
      {
        "instrument": "BTC-14MAR25-105000-C",
        "exchangeTimestamp": 1740009600000,
        "open": 0.019,
        "high": 0.022,
        "low": 0.0185,
        "close": 0.02,
        "volume": 40.3
      },
      {
        "instrument": "BTC-14MAR25-105000-C",
        "exchangeTimestamp": 1740096000000,
        "open": 0.019,
        "high": 0.022,
        "low": 0.0115,
        "close": 0.014,
        "volume": 25.5
      }
    ]
  }
}
The maximum time range (difference between startDate and endDate) is:
  • 62 days of daily, hourly or minutely data
  • This endpoint only stores the most recent 62 days of data.
  • Queries with a startDate older than 62 days from the current date will result in a 410 error.
In order to get more than the maximum allowed, you can use the Historical endpoint found here .
If you omit startDate and endDate, the API will return the most recent 62 days of daily data (not data older than 62 days from the current date).
Block trades are included in the calculation of OHLCV for Deribit.

Authorizations

​
x-api-key
string
header
required

Headers

​
Accept-Encoding
string
default:gzip, deflate, br
required
​
api-version
string

Path Parameters

​
exchange
string
default:deribit
required

The exchange for which to retrieve the most current data.

Query Parameters

​
instruments
string
default:BTC-29DEC23-30000-C
required

[Required] The instrument(s) for which to retrieve the most current data (comma separated). [Maximum] 50 instruments

​
startDate
string<date-time>

[Optional] Payload only includes data after this date (inclusive). [Formats] seconds | milliseconds | iso8601 [Examples] 1578531600 | 1578531600000 | 2020-09-01T01:00:00

​
endDate
string<date-time>

[Optional] Payload only includes data before this date (exclusive). [Formats] seconds | milliseconds | iso8601 [Examples] 1578531600 | 1578531600000 | 2020-09-01T01:00:00

​
timeInterval
string

[Optional] Time interval. [Defaults] minutes | hours | days*

​
timeFormat
string

[Optional] Time format of the timestamps in the return payload. [Defaults] milliseconds | ms* | iso | iso8601 | hr | human_readable

Response

200
application/json

200

The response is of type object.