Skip to main content
Type: IMPLIED_VOLATILITY_OPTION_SUMMARY_AGG | Weight: 1x | Max points: 100,000 | Advanced/Enterprise only Implied volatility summary data for option markets. The current public API shape is a single summary series selected by exchange, coin, rawSymbol, and tenor.

​
Parameters

ParameterTypeRequiredDescription
exchangestringYesUse the option venue that exposes the summary series. The current public example uses DERIBIT.
coinstringYesUnderlying asset, for example BTC.
rawSymbolstringYesSummary symbol, for example BTC_ATM.
tenorTenorYesOption summary tenor, for example ONE_W.
Use GET /v1/markets to discover available summary symbols and tenors before querying.

​
Response fields

FieldTypeDescription
impliedVolatilitydoubleImplied volatility summary value for the requested series
timestampTimestampStart of the returned interval bucket

​
Capabilities

FeatureSupportedDetails
Summary series queriesYesQuery by exchange, coin, rawSymbol, and tenor
Multi-exchange aggregationNo

​
Examples

​
One-week BTC ATM implied volatility

Fetches 7 days of daily BTC ATM implied volatility for the one-week tenor. 
curl "https://api.kiyotaka.ai/v1/points?type=IMPLIED_VOLATILITY_OPTION_SUMMARY_AGG&exchange=DERIBIT&coin=BTC&rawSymbol=BTC_ATM&tenor=ONE_W&interval=DAY&from=1775635290&period=604800" \
  -H "X-Kiyotaka-Key: YOUR_API_KEY"

​
Response

{
  "series": [
    {
      "id": {
        "type": "IMPLIED_VOLATILITY_OPTION_SUMMARY_AGG",
        "exchange": "DERIBIT",
        "rawSymbol": "BTC_ATM",
        "normalizedSymbol": "BTC",
        "category": "OPTION",
        "interval": "DAY",
        "tenor": "ONE_W",
        "coin": "BTC"
      },
      "points": [
        {
          "Point": {
            "impliedVolatility": 41.68456143125,
            "timestamp": { "s": 1775692800 }
          }
        }
      ]
    }
  ]
}