{"uid":"cap_lyM4cDB7NJZu3HJUNjbnV","slug":"laevitas-expired-options-expiries-analytics-44719a93","name":"Laevitas Expired Options Expiries Analytics","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\nData and history endpoints also accept x402 without an API key: 1, 5 or 10 credits ($0.001 each) for data up to 1 year, 1–3 years or older.\n\n**Subscriptions with USDC:** Premium and Enterprise can be purchased on Base or Solana for a month, a quarter, six months or a year. Access is prepaid, with no automatic renewal. [Buy a subscription](https://v3.laevitas.ch/profile/subscription/wallet) or read the [USDC subscription guide](/x402#subscriptions).\n\nThe subscription belongs to your signed-in Laevitas account; wallet sign-in does not require an email. Enterprise users generate an API key in V3 after activation. Plan and billing-period limits still apply. Subscription purchases are separate from API credit bundles.\n\nFor Claude MCP, add `https://apiv2.laevitas.ch/api/v1/mcp`, select **Sign in now → Register automatically**\nwith no custom headers, and authorize with your API key on the Laevitas page.\nDo not enter a client ID or secret manually. All OAuth clients require PKCE S256.\nConnection guide: [MCP setup](/mcp). CIMD / published client identity is not supported.\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| Options Backtests | Strategy templates, asynchronous submission, status, combined results, cancellation |\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\nBacktests are asynchronous jobs, not paginated market-data queries. Start with\n`GET /api/v1/options/backtests/strategies`, submit with `POST /api/v1/options/backtests`,\nthen poll `/{id}` and retrieve `/{id}/result`. These responses have no data/meta wrapper.\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/analytics/options/expired_expiries/%7Bmarket%7D/%7Bcurrency%7D?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"maturity":{"type":"string","description":"Exact expiry filter. Omit for all retained settlement rows."}}},"responseSchema":{"type":"object","required":["date","data"],"properties":{"data":{"type":"array","items":{"type":"object","required":["Date","Strike","OptionType","mark_price","mark_price_usd","position","index_price"],"properties":{"Date":{"type":"string","description":"Listed expiry date, DMMMYY; not collection time."},"Strike":{"type":"number","nullable":true,"description":"Exercise price in the option underlying quote convention."},"position":{"type":"number","nullable":true,"description":"Source retained position quantity; not trade count or USD notional. Null when unavailable, including delivery-price reconstructions."},"OptionType":{"type":"string","description":"Source call/put label, preserved without recoding."},"mark_price":{"type":"number","nullable":true,"description":"Source expiry option price per underlying unit, in the instrument settlement currency."},"index_price":{"type":"number","nullable":true,"description":"Source expiry index reference; quote units per underlying unit."},"mark_price_usd":{"type":"number","nullable":true,"description":"Source USD value of that option price."}},"additionalProperties":false}},"date":{"type":"integer","maximum":9007199254740991,"minimum":0,"description":"UTC Unix seconds. Source last update for live series; response-generation minute for current discovery."}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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_mVA4J4WLJ9BlDbygfovWR","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":"Returns settlement-price data for expired crypto options expiries on a given market and currency, optionally filtered to a specific maturity date.","exampleAgentPrompt":"Pull up the expired options expiry data for BTC on Deribit from Laevitas — I want to see the strike prices, mark prices, and index reference at settlement for all past maturities.","exampleUseCases":[{"title":"Post-expiry settlement audit","prompt":"Get all the expired BTC options settlement data from Deribit on Laevitas — I need the strike, call/put type, mark price in USD, and index price at expiry for every maturity we have."},{"title":"Single maturity deep-dive","prompt":"On Laevitas, pull the expired ETH options data for the 29MAR24 maturity on Deribit — I want to see every strike, its mark price, and the index reference at settlement."},{"title":"Options expiry position analysis","prompt":"Retrieve the expired Deribit SOL options expiry analytics from Laevitas and show me which strikes had the largest retained positions at settlement across all past maturities."}],"resultDescription":"Returns a JSON object with a UTC Unix timestamp and an array of settlement rows, each containing the expiry date label (e.g. '29MAR24'), strike price, option type (call/put), mark price in the settlement currency, mark price in USD, retained position quantity, and the index reference price at expiry. Null values appear where the source data was unavailable or reconstructed from delivery prices.","failureModes":["Invalid market or currency parameter returns an error or empty data array","Unknown maturity string returns no matching rows","Expired or missing API key returns 401 unauthorized","Insufficient credits (x402) results in 402 Payment Required","Market not covered by Laevitas returns empty or error response","Rate limit exceeded returns 429"],"whenToPreferThis":"Use this endpoint when you need historical settlement data for already-expired crypto options contracts on a specific exchange and currency pair — particularly for auditing, backtesting, or post-expiry analytics. Prefer this over live options endpoints when the focus is on past expiries rather than current open interest or implied volatility.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:15.506Z","isFirstParty":false,"canonicalSlug":"laevitas-expired-options-expiries-analytics-44719a93"}