> ## Documentation Index
> Fetch the complete documentation index at: https://docs.amberdata.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Batch Historical

> Delivers historical OHLCV (Open, High, Low, Close, Volume) data in batch format for multiple Options market contracts, providing comprehensive price and volume history over specified time ranges for efficient analysis across multiple instruments.

<Warning>
  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](/http/md/options-ohlcv) .
</Warning>

<Note>
  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).
</Note>

<Tip>
  Block trades are included in the calculation of OHLCV for Deribit.
</Tip>


## OpenAPI

````yaml get /options/batch-ohlcv/{exchange}
openapi: 3.1.0
info:
  title: market-api
  version: '2'
servers:
  - url: https://api.amberdata.com/markets
security:
  - ApiKeyAuth: []
paths:
  /options/batch-ohlcv/{exchange}:
    get:
      summary: Batch Historical
      description: >-
        Delivers historical OHLCV (Open, High, Low, Close, Volume) data in batch
        format for multiple Options market contracts, providing comprehensive
        price and volume history over specified time ranges for efficient
        analysis across multiple instruments.
      operationId: batch-historical-ond-1
      parameters:
        - name: exchange
          in: path
          description: The exchange for which to retrieve the most current data.
          schema:
            type: string
            default: deribit
          required: true
        - name: instruments
          in: query
          description: >-
            **[Required]** The instrument(s) for which to retrieve the most
            current data (comma separated).  **[Maximum]** 50 instruments
          required: true
          schema:
            type: string
            default: BTC-29DEC23-30000-C
        - name: startDate
          in: query
          description: >-
            **[Optional]** Payload only includes data after this date
            (inclusive). **[Formats]** `seconds | milliseconds | iso8601`
            **[Examples]** `1578531600 | 1578531600000 | 2020-09-01T01:00:00`
          schema:
            type: string
            format: date-time
        - name: endDate
          in: query
          description: >-
            **[Optional]** Payload only includes data before this date
            (exclusive). **[Formats]** `seconds | milliseconds | iso8601`
            **[Examples]** `1578531600 | 1578531600000 | 2020-09-01T01:00:00`
          schema:
            type: string
            format: date-time
        - name: timeInterval
          in: query
          description: >-
            **[Optional]** Time interval. **[Defaults]** `minutes | hours |
            days*`
          schema:
            type: string
        - name: timeFormat
          in: query
          description: >-
            **[Optional]** Time format of the timestamps in the return payload.
            **[Defaults]** `milliseconds | ms* | iso | iso8601 | hr |
            human_readable`
          schema:
            type: string
        - name: Accept-Encoding
          in: header
          required: true
          description: ''
          schema:
            type: string
            default: gzip, deflate, br
        - name: api-version
          in: header
          schema:
            type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value:
                    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
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  title:
                    type: string
                  description:
                    type: string
                  payload:
                    type: object
                    properties:
                      metadata:
                        type: object
                        properties:
                          next:
                            type: string
                          api-version:
                            type: string
                      data:
                        type: array
                        items:
                          type: object
                          properties:
                            instrument:
                              type: string
                            exchangeTimestamp:
                              type: integer
                            open:
                              type: number
                            high:
                              type: number
                            low:
                              type: number
                            close:
                              type: number
                            volume:
                              type: number
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                type: object
                properties: {}
      deprecated: false
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````