{"uid":"cap_kpKP6EzeryyeoK0VWcgaZ","slug":"laevitas-options-volatility-data-e33d5705","name":"Laevitas Options Volatility Data","description":"Professional market data API for crypto derivatives, spot markets, prediction markets, Hyperliquid HyperCore data, proprietary volatility surfaces, and analytics.\n\n## Authentication\n\nUse an API key for authenticated REST requests:\n\n```http\nX-API-Key: your-api-key-here\n```\n\nMost data endpoints also support x402 pay-per-request without an API key.\n\n| Resource | Path |\n| --- | --- |\n| OpenAPI JSON | `GET /openapi.json` |\n| x402 discovery | `GET /.well-known/x402` |\n| Changelog | `GET /api/v1/changelog` |\n| WebSocket docs | `GET /websocket` |\n\n## REST Surfaces\n\n| Surface | Examples |\n| --- | --- |\n| Instruments | Cross-market contract reference data |\n| Futures | OHLCVT, trades, tickers, orderbook, liquidations, carry |\n| Perpetuals | OHLCVT, trades, funding, open interest, orderbook, liquidations |\n| Options | OHLCVT, trades, Greeks, volatility, flow, dealer GEX |\n| Vol Surface | Proprietary surface snapshots, slices, strikes, term structure, risk |\n| Spot | OHLCVT, ticker, trades, volume, L2 orderbook, snapshots |\n| Predictions | Polymarket instruments, categories, trades, ticker history |\n| Hyperliquid - HyperCore | Node-derived fills, liquidations, positions, funding, TWAPs, resting orders, L2 books |\n| Analytics | Realized volatility and derived metrics |\n\n## Pagination\n\nPaginated endpoints return the cursor at `meta.next_cursor`. Pass that value back as the `cursor` query parameter to fetch the next page.\n\n## WebSocket Streaming\n\nReal-time streams are documented at `/websocket`.\n\n| Data | Channel pattern |\n| --- | --- |\n| Trades | `trades.{market}.{exchange}.{instrument}` |\n| OHLC ticker | `ohlc.ticker.{market}.{exchange}.{instrument}.{timeframe}` |\n| OHLCVT | `ohlc.vt.{market}.{exchange}.{instrument}.{timeframe}` |\n\nVariables: `market` is one of `perpetuals`, `futures`, `options`, or `spot`; `timeframe` is one of `1m`, `5m`, `15m`, `1h`, `4h`, or `1d`.\n\n## Quick Start\n\n```bash\ncurl \"https://apiv2.laevitas.ch/api/v1/futures/ohlcvt?exchange=deribit&instrument_name=BTC-PERPETUAL\" \\\n  -H \"X-API-Key: your-api-key-here\"\n```","url":"https://apiv2.laevitas.ch/api/v1/options/volatility","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object"},"queryParams":{"type":"object","properties":{"end":{"type":"string"},"limit":{"type":"integer","maximum":1000,"minimum":1},"start":{"type":"string"},"cursor":{"type":"string"},"exchange":{"type":"string"},"resolution":{"enum":["1m","5m","15m","1h","4h","1d"],"type":"string"},"instrument_name":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":[],"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.08","successRate":"0.00","reviews":1,"stars":"1.3","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZDAXk-8NZ49Pj6qr2Pgrl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves historical implied volatility data for options instruments across major crypto exchanges","exampleAgentPrompt":"Pull the hourly implied volatility data for BTC-PERPETUAL on Deribit from January 1st to January 31st 2024, limit to 500 results.","exampleUseCases":[{"title":"Monitor volatility spikes for trading alerts","prompt":"Watch BTC and ETH options implied volatility on Deribit over the last 7 days and alert me whenever IV jumps more than 15% in a single hour—I need to know about sudden market regime shifts fast."},{"title":"Analyze vol term structure across exchanges","prompt":"Fetch the implied volatility surface for BTC options across Deribit, Binance, and OKX for the current month, then compare which exchange has the richest volatility curve so I can spot arbitrage opportunities."},{"title":"Build historical volatility backtest dataset","prompt":"Pull daily implied volatility data for BTC-PERPETUAL, ETH-PERPETUAL, and SOL-PERPETUAL from Deribit going back 12 months—I'm testing a mean-reversion strategy and need clean IV timeseries to validate it."}],"resultDescription":"Returns a JSON object with a 'data' array containing implied volatility records for the specified options instrument and time range, and a 'success' boolean flag.","failureModes":["Missing or invalid API key or unpaid x402 request returns 401/402","Unknown exchange name returns empty data or error","Invalid instrument_name format returns error or empty array","start/end date range too large may exceed limit","Invalid resolution enum value returns validation error","Cursor pagination token expired or invalid returns error"],"whenToPreferThis":"Use this endpoint when you need historical or recent implied volatility timeseries data for specific crypto options instruments on exchanges like Deribit, Binance, OKX, Bybit, or Hyperliquid. Prefer this over general market data APIs when you need options-specific IV metrics with flexible resolution.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":4,"lastUsedAt":"2026-06-15T13:54:19.627Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:49:16.365Z","isFirstParty":false}