> ## 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 Index Decorated

> This endpoint returns the value of the BTC (or other altcoin) VIX. Along with the volatility index we are also returned underlying volatility surface datapoints (such as skew) and underlying spot prices.



## OpenAPI

````yaml get /analytics/volatility/index-decorated
openapi: 3.1.0
info:
  title: derivatives-api
  version: '2'
servers:
  - url: https://api.amberdata.com/markets/derivatives
security:
  - sec0: []
paths:
  /analytics/volatility/index-decorated:
    get:
      summary: Volatility Index Decorated
      description: >-
        This endpoint returns the value of the BTC (or other altcoin) VIX. Along
        with the volatility index we are also returned underlying volatility
        surface datapoints (such as skew) and underlying spot prices.
      operationId: derivatives-volatility-index-decorated
      parameters:
        - name: currency
          in: query
          description: >-
            **[Optional]** The underlying currency for which to retrieve the
            volatility index. 

            **[Examples]** `BTC | SOL_USDC`  

            Note: inverse options have underlying currencies formatted as (BTC,
            ETH) while linear option currency formats include the stable coin in
            the same  (SOL_USDC)
          required: true
          schema:
            type: string
            default: BTC
        - name: exchange
          in: query
          description: >-
            **[Optional]**  The exchange for which to retrieve the volatility
            index. 

            **[Examples]** `deribit`
          schema:
            type: string
            default: deribit
        - 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-06-01'
        - name: timeInterval
          in: query
          description: >-
            **[Optional]** Time interval of data frequency for the selected date
            range. 

            **[Examples]** `minute | hour | day` 
             **[Note]** Due to the density of data historical date ranges are limited to 60x 1-minute or 24x 1 hour intervals, per call.
          schema:
            type: string
            default: day
        - 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:
              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:
                            exchangeTimestamp:
                              type: string
                              example: '2024-06-06 19:00:00.0'
                              description: >-
                                The timestamp when the data was received from
                                the exchange
                            exchange:
                              type: string
                              example: deribit
                              description: >-
                                The exchange where the volatility index is
                                calculated
                            instrument:
                              type: string
                              example: DERIBIT_BTC_DVOL_INDEX
                              description: >-
                                The instrument identifier for the volatility
                                index
                            currency:
                              type: string
                              example: BTC
                              description: The underlying currency for the volatility index
                            indexPrice:
                              type: number
                              example: 71043.50828947368
                              description: The index price of the underlying asset
                            underlyingPrice:
                              type: number
                              example: 71970.97051523329
                              description: The current price of the underlying asset
                            close:
                              type: number
                              example: 52.83
                              description: The closing value of the volatility index
                            atm:
                              type: number
                              example: 51.51823745869919
                              description: At The Money volatility
                            delta50:
                              type: number
                              example: 51.69346060959675
                              description: 50% delta volatility
                            deltaCall25:
                              type: number
                              example: 53.87852293010057
                              description: 25% delta call volatility
                            deltaPut25:
                              type: number
                              example: 50.85645481877562
                              description: 25% delta put volatility
                            delta25RrSkew:
                              type: number
                              example: 3.0220681113249555
                              description: 25% delta risk reversal skew (call25 - put25)
                            daysAgo:
                              type: integer
                              example: 0
                              description: Number of days ago from the current date
              examples:
                Result:
                  value:
                    status: 200
                    title: OK
                    description: Successful request
                    payload:
                      data:
                        - exchangeTimestamp: '2024-06-06 19:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 71043.50828947368
                          underlyingPrice: 71970.97051523329
                          close: 52.83
                          atm: 51.51823745869919
                          delta50: 51.69346060959675
                          deltaCall25: 53.87852293010057
                          deltaPut25: 50.85645481877562
                          delta25RrSkew: 3.0220681113249555
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-06 18:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 71082.68947368421
                          underlyingPrice: 71991.85266862402
                          close: 53.41
                          atm: 51.84655133119005
                          delta50: 52.08967881730025
                          deltaCall25: 54.6118859256467
                          deltaPut25: 50.99467108317352
                          delta25RrSkew: 3.6172148424731816
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-06 17:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 70942.9730263158
                          underlyingPrice: 71829.62975556214
                          close: 53.98
                          atm: 52.295710475490786
                          delta50: 52.519859459978484
                          deltaCall25: 54.97627457056669
                          deltaPut25: 51.735387054397926
                          delta25RrSkew: 3.240887516168762
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-06 16:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 71286.85078947368
                          underlyingPrice: 72181.80892269053
                          close: 53.77
                          atm: 52.407733011148984
                          delta50: 52.68940994786385
                          deltaCall25: 55.142702045236575
                          deltaPut25: 51.76170758437015
                          delta25RrSkew: 3.3809944608664253
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-06 15:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 71447.76342105263
                          underlyingPrice: 72352.4542939263
                          close: 53.85
                          atm: 52.55276118850411
                          delta50: 52.797910334780966
                          deltaCall25: 55.07595206633709
                          deltaPut25: 51.84902165650667
                          delta25RrSkew: 3.226930409830416
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-06 14:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 71099.5719736842
                          underlyingPrice: 72001.66591824421
                          close: 54.23
                          atm: 52.804515216361246
                          delta50: 53.046452812096526
                          deltaCall25: 55.20535397298803
                          deltaPut25: 52.139981889507794
                          delta25RrSkew: 3.0653720834802343
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-06 13:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 71164.67631578947
                          underlyingPrice: 72070.29267796311
                          close: 54.37
                          atm: 52.93513315093241
                          delta50: 53.172765140955036
                          deltaCall25: 55.23797706426304
                          deltaPut25: 52.258711235453426
                          delta25RrSkew: 2.9792658288096163
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-06 12:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 71158.46513157895
                          underlyingPrice: 72066.77844289514
                          close: 54.26
                          atm: 52.73245258295585
                          delta50: 52.91153814509892
                          deltaCall25: 54.437753047972116
                          deltaPut25: 52.31423199021567
                          delta25RrSkew: 2.1235210577564487
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-06 11:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 70995.26078947369
                          underlyingPrice: 71886.0726613873
                          close: 54.22
                          atm: 52.72682495035447
                          delta50: 52.843333071667374
                          deltaCall25: 54.51598575412658
                          deltaPut25: 52.429702737993075
                          delta25RrSkew: 2.086283016133507
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-06 10:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 70984.3569736842
                          underlyingPrice: 71858.46639831913
                          close: 54.42
                          atm: 52.8322947967893
                          delta50: 52.93831172675815
                          deltaCall25: 54.960893111757116
                          deltaPut25: 52.53978823598809
                          delta25RrSkew: 2.421104875769025
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-06 09:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 70924.06368421053
                          underlyingPrice: 71767.35366706343
                          close: 54.5
                          atm: 53.001041966737795
                          delta50: 53.12697739069145
                          deltaCall25: 55.14923407325927
                          deltaPut25: 52.70246052706958
                          delta25RrSkew: 2.4467735461896893
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-06 08:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 71026.84
                          underlyingPrice: 71906.49270059494
                          close: 54.49
                          atm: 52.9329612640609
                          delta50: 53.12541169275627
                          deltaCall25: 55.29681698268398
                          deltaPut25: 52.413425375306225
                          delta25RrSkew: 2.883391607377753
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-06 07:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 70902.30483333333
                          underlyingPrice: 71752.4955656904
                          close: 54.67
                          atm: 53.08188974686868
                          delta50: 53.25575324970096
                          deltaCall25: 55.217421072111975
                          deltaPut25: 52.722240860339376
                          delta25RrSkew: 2.495180211772599
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-06 06:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 70898.44
                          underlyingPrice: 71757.93781441746
                          close: 55.04
                          atm: 53.598200059652605
                          delta50: 53.7886762535623
                          deltaCall25: 55.70634252840137
                          deltaPut25: 53.25274655714243
                          delta25RrSkew: 2.4535959712589417
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-06 05:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 71066.32733333333
                          underlyingPrice: 71918.14497953827
                          close: 55.03
                          atm: 53.63457068741584
                          delta50: 53.83309517086581
                          deltaCall25: 55.627672947055224
                          deltaPut25: 53.257404554650144
                          delta25RrSkew: 2.3702683924050802
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-06 04:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 71068.16166666667
                          underlyingPrice: 71894.56757070626
                          close: 55.09
                          atm: 53.72015029950521
                          delta50: 53.90733383778383
                          deltaCall25: 55.99887272025997
                          deltaPut25: 53.1503270208576
                          delta25RrSkew: 2.848545699402365
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-06 03:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 71173.38233333334
                          underlyingPrice: 72029.09966284121
                          close: 55.3
                          atm: 53.967537997391844
                          delta50: 54.174395573944956
                          deltaCall25: 56.1118163353827
                          deltaPut25: 53.47254569798131
                          delta25RrSkew: 2.6392706374013883
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-06 02:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 71140.54816666667
                          underlyingPrice: 71992.71789138885
                          close: 55.36
                          atm: 53.85043370431609
                          delta50: 54.07247739905966
                          deltaCall25: 56.138735532553135
                          deltaPut25: 53.50301771649843
                          delta25RrSkew: 2.635717816054708
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-06 01:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 71026.21283333334
                          underlyingPrice: 71876.60197693041
                          close: 55.52
                          atm: 54.12098422741766
                          delta50: 54.368863372268386
                          deltaCall25: 56.526187794547276
                          deltaPut25: 53.522339075354196
                          delta25RrSkew: 3.00384871919308
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-06 00:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 71118.75666666667
                          underlyingPrice: 71975.70021577465
                          close: 55.64
                          atm: 54.07249057342441
                          delta50: 54.30455606587215
                          deltaCall25: 56.31610733763884
                          deltaPut25: 53.7084854358118
                          delta25RrSkew: 2.607621901827038
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-05 23:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 71154.62633333333
                          underlyingPrice: 72048.304821437
                          close: 55.82
                          atm: 54.29419242827043
                          delta50: 54.45745198936885
                          deltaCall25: 56.27758307903957
                          deltaPut25: 54.108429777844606
                          delta25RrSkew: 2.1691533011949673
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-05 22:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 71156.08216666666
                          underlyingPrice: 72045.374582141
                          close: 56.16
                          atm: 54.81246301578333
                          delta50: 54.97828170974095
                          deltaCall25: 56.79550490379206
                          deltaPut25: 54.44413386048209
                          delta25RrSkew: 2.3513710433099675
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-05 21:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 71212.97399999999
                          underlyingPrice: 72097.39678039736
                          close: 56.28
                          atm: 54.94573075050074
                          delta50: 55.18486513504689
                          deltaCall25: 57.35117215968467
                          deltaPut25: 54.36256606116892
                          delta25RrSkew: 2.9886060985157528
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-05 20:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 71309.9465
                          underlyingPrice: 72156.7070441139
                          close: 56.39
                          atm: 54.970876704619776
                          delta50: 55.2046408641653
                          deltaCall25: 57.20324761796363
                          deltaPut25: 54.74140363215486
                          delta25RrSkew: 2.461843985808777
                          daysAgo: 0
                        - exchangeTimestamp: '2024-06-05 19:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 71093.25466666667
                          underlyingPrice: 72002.53197370801
                          close: 56.26
                          atm: 55.08335782618
                          delta50: 55.330956178534784
                          deltaCall25: 57.55316565374264
                          deltaPut25: 54.350317611601
                          delta25RrSkew: 3.202848042141639
                          daysAgo: 1
                        - exchangeTimestamp: '2024-06-05 18:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 71642.4225
                          underlyingPrice: 72572.31286339424
                          close: 56.63
                          atm: 55.585083251379366
                          delta50: 55.83004823344287
                          deltaCall25: 57.80566120086786
                          deltaPut25: 54.80447103901212
                          delta25RrSkew: 3.001190161855739
                          daysAgo: 1
                        - exchangeTimestamp: '2024-06-05 17:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 71319.163
                          underlyingPrice: 72228.35193022514
                          close: 56.67
                          atm: 55.768841718112256
                          delta50: 56.05536656377461
                          deltaCall25: 58.02236449856287
                          deltaPut25: 54.92292351116763
                          delta25RrSkew: 3.0994409873952407
                          daysAgo: 1
                        - exchangeTimestamp: '2024-06-05 16:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 71605.79666666666
                          underlyingPrice: 72512.96521099427
                          close: 56.21
                          atm: 54.97759744236457
                          delta50: 55.23094249751539
                          deltaCall25: 57.26013726268294
                          deltaPut25: 54.380090746095405
                          delta25RrSkew: 2.8800465165875337
                          daysAgo: 1
                        - exchangeTimestamp: '2024-06-05 15:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 70882.53566666666
                          underlyingPrice: 71763.95365937233
                          close: 55.95
                          atm: 54.652055102615996
                          delta50: 54.86757901941423
                          deltaCall25: 57.002092499551104
                          deltaPut25: 54.04584155141366
                          delta25RrSkew: 2.956250948137445
                          daysAgo: 1
                        - exchangeTimestamp: '2024-06-05 14:00:00.0'
                          exchange: deribit
                          instrument: DERIBIT_BTC_DVOL_INDEX
                          currency: BTC
                          indexPrice: 70733.97516666666
                          underlyingPrice: 71584.58825913753
                          close: 55.74
                          atm: 54.48226136759716
                          delta50: 54.74012873530287
                          deltaCall25: 57.25799202519757
                          deltaPut25: 53.7777208838321
                          delta25RrSkew: 3.4802711413654634
                          daysAgo: 1
        '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

````