> ## 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 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: 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: derivatives-realized-volatility-cones 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-01-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: - exchange: gdax pair: btc_usd current_180days: 57.8576871987908 min_180days: 39.11684280082735 max_180days: 112.16458840572531 p75_180days: 84.21832787116985 p50_180days: 69.90313327986112 p25_180days: 54.88690147506426 current_90days: 65.38033717750392 min_90days: 34.29029015131686 max_90days: 124.89522804294555 p75_90days: 81.16783917660511 p50_90days: 66.31691486150768 p25_90days: 52.334979706515774 current_30days: 45.06156764942955 min_30days: 24.07333390860325 max_30days: 189.48310101421418 p75_30days: 75.90531543097599 p50_30days: 63.18354743795466 p25_30days: 49.081271883281325 current_14days: 50.63271655398003 min_14days: 15.905336435198922 max_14days: 261.45308678136536 p75_14days: 77.15011657183202 p50_14days: 59.65214502613274 p25_14days: 45.349055100239696 current_7days: 47.446161931957064 min_7days: 15.772143462558525 max_7days: 331.20928400816234 p75_7days: 74.68689529993709 p50_7days: 56.631315187516996 p25_7days: 42.829248159278094 current_1day: 29.148342222179462 min_1day: 0.47061174456210236 max_1day: 619.625334604921 p75_1day: 69.98263387792929 p50_1day: 46.804756220012045 p25_day1: 30.227524387511373 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: exchange: type: string example: gdax description: The exchange on which the subject pair is found pair: type: string example: btc_usd description: The subject pair used for the calculation current_180days: type: number example: 57.8576871987908 description: >- The current realized volatility for 180 days rolling window min_180days: type: number example: 39.11684280082735 description: >- The minimum realized volatility observation for 180 days rolling window max_180days: type: number example: 112.16458840572531 description: >- The maximum realized volatility observation for 180 days rolling window p75_180days: type: number example: 84.21832787116985 description: The 75th percentile for 180 days rolling window p50_180days: type: number example: 69.90313327986112 description: >- The 50th percentile (median) for 180 days rolling window p25_180days: type: number example: 54.88690147506426 description: The 25th percentile for 180 days rolling window current_90days: type: number example: 65.38033717750392 description: >- The current realized volatility for 90 days rolling window min_90days: type: number example: 34.29029015131686 description: >- The minimum realized volatility observation for 90 days rolling window max_90days: type: number example: 124.89522804294555 description: >- The maximum realized volatility observation for 90 days rolling window p75_90days: type: number example: 81.16783917660511 description: The 75th percentile for 90 days rolling window p50_90days: type: number example: 66.31691486150768 description: >- The 50th percentile (median) for 90 days rolling window p25_90days: type: number example: 52.334979706515774 description: The 25th percentile for 90 days rolling window current_30days: type: number example: 45.06156764942955 description: >- The current realized volatility for 30 days rolling window min_30days: type: number example: 24.07333390860325 description: >- The minimum realized volatility observation for 30 days rolling window max_30days: type: number example: 189.48310101421418 description: >- The maximum realized volatility observation for 30 days rolling window p75_30days: type: number example: 75.90531543097599 description: The 75th percentile for 30 days rolling window p50_30days: type: number example: 63.18354743795466 description: >- The 50th percentile (median) for 30 days rolling window p25_30days: type: number example: 49.081271883281325 description: The 25th percentile for 30 days rolling window current_14days: type: number example: 50.63271655398003 description: >- The current realized volatility for 14 days rolling window min_14days: type: number example: 15.905336435198922 description: >- The minimum realized volatility observation for 14 days rolling window max_14days: type: number example: 261.45308678136536 description: >- The maximum realized volatility observation for 14 days rolling window p75_14days: type: number example: 77.15011657183202 description: The 75th percentile for 14 days rolling window p50_14days: type: number example: 59.65214502613274 description: >- The 50th percentile (median) for 14 days rolling window p25_14days: type: number example: 45.349055100239696 description: The 25th percentile for 14 days rolling window current_7days: type: number example: 47.446161931957064 description: >- The current realized volatility for 7 days rolling window min_7days: type: number example: 15.772143462558525 description: >- The minimum realized volatility observation for 7 days rolling window max_7days: type: number example: 331.20928400816234 description: >- The maximum realized volatility observation for 7 days rolling window p75_7days: type: number example: 74.68689529993709 description: The 75th percentile for 7 days rolling window p50_7days: type: number example: 56.631315187516996 description: >- The 50th percentile (median) for 7 days rolling window p25_7days: type: number example: 42.829248159278094 description: The 25th percentile for 7 days rolling window current_1day: type: number example: 29.148342222179462 description: >- The current realized volatility for 1 day rolling window min_1day: type: number example: 0.47061174456210236 description: >- The minimum realized volatility observation for 1 day rolling window max_1day: type: number example: 619.625334604921 description: >- The maximum realized volatility observation for 1 day rolling window p75_1day: type: number example: 69.98263387792929 description: The 75th percentile for 1 day rolling window p50_1day: type: number example: 46.804756220012045 description: >- The 50th percentile (median) for 1 day rolling window p25_day1: type: number example: 30.227524387511373 description: | The 25th percentile for 1 day rolling window (note: field name uses 'day1' instead of '1day') required: [] required: [] required: [] required: [] '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 ````