{"uid":"cap_3ljwmOqEuzycj_ivq509y","slug":"laevitas-options-volatility-surface-by-tenor-b2b71efd","name":"Laevitas Options Volatility Surface by Tenor","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/vol-surface/by-tenor","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":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"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_1fODIVIgu9AoqzZtHo1Zh","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 the options implied volatility surface organized by tenor (time to expiry) for a given exchange and instrument","exampleAgentPrompt":"Can you pull the options volatility surface by tenor for BTC on Deribit from Laevitas, using 1h resolution for the past week, up to 100 data points?","exampleUseCases":[{"title":"Real-time vol curve monitoring for options traders","prompt":"Get me the options implied volatility surface by tenor for ETH on OKX right now. I want to see the full expiry structure to spot any unusual term structure changes."},{"title":"Historical volatility term structure analysis","prompt":"Can you fetch the options vol surface organized by tenor for BTC options on Deribit over the last 30 days? I need to analyze how the volatility curve evolved across different expiry buckets."},{"title":"Cross-exchange volatility surface comparison","prompt":"Pull the options volatility surfaces by tenor for the same BTC contract on both Deribit and Bybit from the past week. I want to compare the vol term structures and identify any arbitrage opportunities."}],"resultDescription":"Returns a JSON object with a data array containing the implied volatility surface organized by tenor (expiry) for the specified options instrument and exchange, along with a success flag. Each data point reflects vol levels across different expiry tenors at a given timestamp.","failureModes":["Missing or invalid API key returns 401 unauthorized","Invalid exchange name returns empty data or error","Unsupported resolution value rejected by enum validation","Start/end date out of available data range returns empty data array","Limit exceeding 1000 returns validation error","Invalid instrument_name format returns empty result or error","x402 payment failure if pay-per-request mode used without sufficient USDC"],"whenToPreferThis":"Use this endpoint when you need options implied volatility surface data organized by tenor (time to expiry buckets) rather than by strike. Ideal for analyzing volatility term structure, calendar spread pricing, or building vol curve models. Prefer this over generic market data endpoints when you need crypto options-specific vol surface analytics from exchanges like Deribit, OKX, Bybit, or Binance.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:54:09.590Z","isFirstParty":false}