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

# Volatility Cones

> The endpoint returns the percentile distribution of realized volatility for a specific spot trading pair. We can see the RV distribution for multiple measurement windows compared to the end date.




## OpenAPI

````yaml get /analytics/realized-volatility/cones/tradfi
openapi: 3.1.0
info:
  title: derivatives-api
  version: '2'
servers:
  - url: https://api.amberdata.com/markets/derivatives
security:
  - sec0: []
paths:
  /analytics/realized-volatility/cones/tradfi:
    get:
      summary: Volatility Cones
      description: >
        The endpoint returns the percentile distribution of realized volatility
        for a specific spot trading pair. We can see the RV distribution for
        multiple measurement windows compared to the end date.
      operationId: tradfi-realized-volatility-cones
      parameters:
        - name: currency
          in: query
          description: >
            **[Required]** The underlying currency for which there are listed
            option instruments. **[Examples]** `IBIT | COIN`
          required: true
          schema:
            type: string
            default: COIN
        - 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: '2024-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-11-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: Successful request
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 200
                    default: 0
                  title:
                    type: string
                    example: OK
                  description:
                    type: string
                    example: Successful request
                  payload:
                    type: object
                    properties:
                      data:
                        type: array
                        items:
                          type: object
                          properties:
                            current_10days:
                              type: number
                              example: 188.59100441153967
                            current_189days:
                              type: number
                              example: 86.58315755127511
                            current_21days:
                              type: number
                              example: 138.18121201307443
                            current_5days:
                              type: number
                              example: 177.94536809019925
                            current_84days:
                              type: number
                              example: 93.83723862596857
                            exchange:
                              type: string
                              example: tradfi
                            max_10days:
                              type: number
                              example: 188.59100441153967
                            max_189days:
                              type: number
                              example: 86.76388935216092
                            max_21days:
                              type: number
                              example: 140.3676474329399
                            max_5days:
                              type: number
                              example: 225.93675129920987
                            max_84days:
                              type: number
                              example: 93.94244338085745
                            min_10days:
                              type: number
                              example: 24.71124747847173
                            min_189days:
                              type: number
                              example: 71.31319001610387
                            min_21days:
                              type: number
                              example: 47.55385962174648
                            min_5days:
                              type: number
                              example: 12.664887422213141
                            min_84days:
                              type: number
                              example: 60.73489458144765
                            p25_10days:
                              type: number
                              example: 63.068268972451435
                            p25_189days:
                              type: number
                              example: 73.98652169371746
                            p25_21days:
                              type: number
                              example: 67.40309577779034
                            p25_5days:
                              type: number
                              example: 58.235148096095095
                            p25_84days:
                              type: number
                              example: 69.5842893029508
                            p50_10days:
                              type: number
                              example: 77.48942438611766
                            p50_189days:
                              type: number
                              example: 75.05077112473491
                            p50_21days:
                              type: number
                              example: 76.56004436195146
                            p50_5days:
                              type: number
                              example: 74.69020857542536
                            p50_84days:
                              type: number
                              example: 74.26986502630952
                            p75_10days:
                              type: number
                              example: 86.78839740397001
                            p75_189days:
                              type: number
                              example: 76.92083508135832
                            p75_21days:
                              type: number
                              example: 84.42278362853486
                            p75_5days:
                              type: number
                              example: 96.37097855158274
                            p75_84days:
                              type: number
                              example: 83.5450669521583
                            pair:
                              type: string
                              example: COIN
                      metadata:
                        type: object
                        properties:
                          api-version:
                            type: string
                            example: '2023-09-30'
              examples:
                success_response:
                  summary: TradFi volatility cones response
                  value:
                    status: 200
                    title: OK
                    description: Successful request
                    payload:
                      data:
                        - current_10days: 188.59100441153967
                          current_189days: 86.58315755127511
                          current_21days: 138.18121201307443
                          current_5days: 177.94536809019925
                          current_84days: 93.83723862596857
                          exchange: tradfi
                          max_10days: 188.59100441153967
                          max_189days: 86.76388935216092
                          max_21days: 140.3676474329399
                          max_5days: 225.93675129920987
                          max_84days: 93.94244338085745
                          min_10days: 24.71124747847173
                          min_189days: 71.31319001610387
                          min_21days: 47.55385962174648
                          min_5days: 12.664887422213141
                          min_84days: 60.73489458144765
                          p25_10days: 63.068268972451435
                          p25_189days: 73.98652169371746
                          p25_21days: 67.40309577779034
                          p25_5days: 58.235148096095095
                          p25_84days: 69.5842893029508
                          p50_10days: 77.48942438611766
                          p50_189days: 75.05077112473491
                          p50_21days: 76.56004436195146
                          p50_5days: 74.69020857542536
                          p50_84days: 74.26986502630952
                          p75_10days: 86.78839740397001
                          p75_189days: 76.92083508135832
                          p75_21days: 84.42278362853486
                          p75_5days: 96.37097855158274
                          p75_84days: 83.5450669521583
                          pair: COIN
                      metadata:
                        api-version: '2023-09-30'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties: {}
              examples:
                error_response:
                  summary: Bad request example
                  value: {}
      deprecated: false
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````