{"uid":"cap_cf9JGUJ9E1OqN94hLBGhC","slug":"laevitas-vol-surface-term-structure-b745ce06","name":"Laevitas Vol Surface Term Structure","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/vol-surface/term-structure","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"},"date":{"type":"string"},"limit":{"type":"integer","maximum":5000,"minimum":1},"model":{"type":"string"},"start":{"type":"string"},"cursor":{"type":"string"},"expiry":{"type":"string"},"margin":{"enum":["inverse","linear"],"type":"string"},"currency":{"type":"string"},"exchange":{"type":"string"},"instrument":{"type":"string"},"tenor_days":{"type":"integer"}}}},"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_qo3tDlo5vqKvCClkY5o6G","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 volatility term structure for crypto options, showing implied volatility across different expiries for a given underlying asset.","exampleAgentPrompt":"Pull the volatility term structure for BTC options on Deribit from Laevitas — use the linear margin type and limit the results to 100 data points.","exampleUseCases":[{"title":"Monitor ATM volatility skew across expirations","prompt":"Check the implied volatility term structure for ETH options right now — I need to see how the curve slopes from weekly through quarterly expiries so I can compare short-term vs long-term pricing."},{"title":"Hedge portfolio with dynamic vol forecasts","prompt":"Give me the current vol surface term structure for Bitcoin on Deribit — show me strikes around ATM so I can assess whether near-term or longer-dated options are relatively expensive for hedging our positions."},{"title":"Analyze volatility regime changes over time","prompt":"Fetch historical volatility term structure snapshots for SOL options across the last week — I want to track how the shape of the curve has evolved to detect shifts in market expectations."}],"resultDescription":"Returns a JSON object with a data array containing implied volatility values across different expiry dates or tenors, representing the vol term structure for the queried underlying asset, along with a success boolean.","failureModes":["Invalid or unsupported currency symbol returns empty data array","Unsupported exchange name results in error or empty response","Invalid margin type (must be 'inverse' or 'linear') causes validation error","Date range with no available data returns empty data array","Exceeding limit maximum of 5000 triggers schema validation error","Missing or invalid API key with no x402 payment results in 401 unauthorized","Rate limiting or payment failure via x402 returns 402 payment required"],"whenToPreferThis":"Use this endpoint when you need structured implied volatility data across multiple expiry horizons (term structure) for crypto options, particularly when you want Laevitas's proprietary vol surface model. Prefer this over raw exchange data when you need cleaned, normalized, or model-fitted volatility curves rather than raw market quotes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:06:05.510Z","isFirstParty":false}