Infrastructure
Real-time crypto options volatility surfaces through a single API.
The Data API streams options volatility surfaces, term-structure and skew across every major crypto derivatives venue — Deribit, OKX, Binance, Bybit, BingX, Hyperliquid. REST and WebSocket access, from hourly snapshots to live streaming updates.
- REST + WebSocket interface
- BTC + ETH included, more on request
- Sub-second updates
- 99.9% uptime SLA on Enterprise
What you get
A full vol surface, in one response.
Every listed expiry is fitted and interpolated onto a standard grid of tenors and forward moneyness, so a call returns the whole calibrated object. BTC shown here as the live example; the same shape is available across every asset the composite covers.
Request it over REST for a snapshot or history, or hold a WebSocket connection open to receive updates as the market moves. Both return the same calibrated object.
This is one interface onto the same data every Data & Analytics leaf renders its own view of — surfaces, term structure, skew, indices and more, all from the one engine.
Latest · BTC
- 30D ATM IV
- 49.6%
- 30D 25Δ risk reversal
- −10.0vol pts
- 30D BSIV
- 57.3%
The protocol
Streaming, REST and on-chain delivery.
Step 01: WebSocket API
JSON-RPC 2.0 over a connection that stays open: authenticate once and subscribe, and updates arrive continuously. Prices, implied vol by strike, delta or moneyness, BSIV, model parameters, rates and realised vol, with more added as coverage grows.
Full WebSocket API referenceChannels on the WebSocket today
mark.pxMark price; options carry an optional Greeks blockindex.pxSpot, futures and perpetual index pricessettlement.px31-minute TWAP settlement price at expirystrike.ivImplied vol at a specific strikedelta.ivImplied vol at a delta level, 0.01–0.5moneyness.ivImplied vol at a moneyness ratio, 0.1–3.0index.ivBSIV index at a constant tenor, 7d–365dmodel.paramsCalibrated SVI parameters — α, β, ρ, m, σinterest.rateForward-implied rate for any expiryrealized.volAnnualised realised vol, configurable lookback
→ subscribe request{"jsonrpc": "2.0","method": "subscribe","params": [{"frequency": "1000ms","client_id": "mark_subscription_1","batch": [{ "sid": "0x1", ... }]}]}← subscription push{"jsonrpc": "2.0","method": "subscription","params": {"data": {"values": [{ "sid": "0x1", ... }]}}}Quoted from the real WebSocket API reference
Step 02: REST API
A point-in-time read: the latest value, or history over a range. A POST with an API key and a JSON body naming the asset and window returns the same data the WebSocket streams, for batch jobs, backtests and anything that doesn’t need a live connection.
Full REST API referencePOSThttps://prod-data.blockscholes.com/api/v1/iv/index{ "exchange": "composite", "base_asset": "BTC", "asset_type": "option", "expiry": "30d", "start": "LATEST", "end": "LATEST", "frequency": "1h", "options": { "format": { "timestamp": "ms", "hexify": false, "decimals": 10 } } }Step 03: Oracles and routing
Every subscription carries a
How the oracle deliverssidyou set, echoed back on each update, so each value is routed to the code that requested it. On-chain, the same values arrive signed and independently verifiable: pulled when a contract needs one, or pushed on a heartbeat plus deviation triggers.- Routing
- A
sidyou set, echoed on every update - Signing
- EIP-712 on EVM chains, BCS on Sui
- Pull
- A signed value on request
- Push
- On a heartbeat, plus deviation triggers
What it powers
One calibrated object, four jobs downstream.
- /01
Source-agnostic marks
Value a book without inheriting one venue’s outage, thin book or bad print.
- /02
Portfolio risk
Greeks and exposures computed from one surface, so teams reconcile against each other.
- /03
Margin
Requirements stressed on the same filtered, arbitrage-checked composite surface.
- /04
Backtesting
Historical surfaces built the same way as the live one, so the test matches the trade.
Plans
Three plans on the same engine.
- REST updates on every plan
- Hourly
- Minutely and streaming from Data Prime
- REST + WebSocket
- Live updates on Enterprise
- Sub-second
- Uptime SLA on Enterprise
- 99.9%
Data Core
For builders evaluating BS data.
- Hourly updates via REST
- Spot, perpetuals, futures and options
- Index and mark prices, volatility data
Data Prime
For teams running on BS data daily.
- Everything in Core
- Minutely data via REST
- WebSocket streaming
- Pull oracle with EIP-712 signatures
Data Enterprise
For institutional teams with custom needs.
- Sub-second updates, options pricing at 200ms
- Real-world asset datasets and feeds
- 99.9% uptime SLA
- Dedicated 24/7 support
Use cases
What teams build on the Data API
- Market MakerReal-Time Volatility Surfaces for Options Market MakingReal-time volatility surfaces for setting fair bid-ask quotes across strike-expiry grids. Exchange-weighted SVI aggregation and sub-second data delivery reduce adverse selection and improve P&L consistency for crypto options market makers.Read the story
- TradFi DerivativesPortfolio-Level Greeks and Dynamic Collateral ManagementComputing portfolio-level Greeks and dynamically adjusting collateral requirements using calibrated implied volatility surfaces. Margin engines evaluate delta and gamma from SVI surfaces to set collateral across strike-expiry combinations.Read the story
- Asset ManagerVolatility Monitoring and Risk Reporting for Digital Asset FundsMonitoring portfolio Greeks, tracking regime changes across the volatility term structure, and generating risk reports for institutional LPs and compliance teams. Real-time surfaces enable fund managers to identify dislocations before they impact portfolios.Read the story
- Risk ManagementInstitutional Risk Dashboards with Regulatory-Grade DataBuilding institutional risk dashboards for real-time portfolio VaR monitoring, vol skew tracking, and compliance-ready reporting. FCA-registered data provenance ensures regulatory-grade audit trails for institutional risk teams.Read the story
Get started
Integrate the Data API into your own systems.
Research has a free tier; the Data API, Oracle and Backtester are paid. A Console account is free to create, and is where a Data Plan is bought, provisioned and managed.