> ## 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.

# Seasonality: Volatility Month of the Year

> This endpoint returns the average realized volatility, for a select date range, grouped by the month-of-the-year. Users can view how Q4 volatility compares to say, Q1 volatility, etc.



## OpenAPI

````yaml get /analytics/realized-volatility/seasonality/month-of-year
openapi: 3.1.0
info:
  title: derivatives-api
  version: '2'
servers:
  - url: https://api.amberdata.com/markets/derivatives
security:
  - sec0: []
paths:
  /analytics/realized-volatility/seasonality/month-of-year:
    get:
      summary: 'Seasonality: Volatility Month of the Year'
      description: >-
        This endpoint returns the average realized volatility, for a select date
        range, grouped by the month-of-the-year. Users can view how Q4
        volatility compares to say, Q1 volatility, etc.
      operationId: derivatives-realized-volatility-seasonality-month-of-the-year
      parameters:
        - name: exchange
          in: query
          description: >-
            **[Required]**  The exchange for which to retrieve the volatility
            cone. 

            **[Examples]** `gdax`
          required: true
          schema:
            type: string
            default: gdax
        - name: pair
          in: query
          description: >-
            **[Required]** The underlying pair for which to retrieve the
            volatility cone. 

            **[Examples]** `btc_usd`
          required: true
          schema:
            type: string
            default: btc_usd
        - 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
            default: '2020-01-01'
        - 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
            default: '2024-06-01'
        - 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
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value:
                    status: 200
                    title: OK
                    description: Successful request
                    payload:
                      data:
                        - month: JAN
                          historicalVolatility1day: 65.77079688679153
                        - month: FEB
                          historicalVolatility1day: 59.7447949807975
                        - month: MARCH
                          historicalVolatility1day: 76.73331120590984
                        - month: APR
                          historicalVolatility1day: 54.358370710033334
                        - month: MAY
                          historicalVolatility1day: 67.70822896571099
                        - month: JUNE
                          historicalVolatility1day: 64.21472571465304
                        - month: JULY
                          historicalVolatility1day: 46.20634917679558
                        - month: AUG
                          historicalVolatility1day: 45.904014842623525
                        - month: SEP
                          historicalVolatility1day: 48.981292813814726
                        - month: OCT
                          historicalVolatility1day: 43.324680324903184
                        - month: NOV
                          historicalVolatility1day: 54.04051311136871
                        - month: DEC
                          historicalVolatility1day: 49.554863548275776
                      metadata:
                        api-version: '2023-09-30'
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 200
                  title:
                    type: string
                    example: OK
                  description:
                    type: string
                    example: Successful request
                  payload:
                    type: object
                    properties:
                      data:
                        type: array
                        items:
                          type: object
                          properties:
                            month:
                              type: string
                              example: JAN
                              description: >-
                                The month abbreviation (JAN, FEB, MARCH, APR,
                                MAY, JUNE, JULY, AUG, SEP, OCT, NOV, DEC)
                            historicalVolatility1day:
                              type: number
                              example: 65.77079688679153
                              description: >-
                                The average historical volatility for this month
                                over the specified date range
                      metadata:
                        type: object
                        properties:
                          api-version:
                            type: string
                            example: '2023-09-30'
                            description: The API version used for this response
        '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

````