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
Data Plans

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.

Delivered over REST · WebSocketBlock Scholes composite

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.

Start with a WebSocket for everything that moves, read point-in-time values and history over REST, and take the same data on-chain, signed, through the oracle, every update routed by an ID you choose.
  1. 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.

    Channels on the WebSocket today

    • mark.pxMark price; options carry an optional Greeks block
    • index.pxSpot, futures and perpetual index prices
    • settlement.px31-minute TWAP settlement price at expiry
    • strike.ivImplied vol at a specific strike
    • delta.ivImplied vol at a delta level, 0.01–0.5
    • moneyness.ivImplied vol at a moneyness ratio, 0.1–3.0
    • index.ivBSIV index at a constant tenor, 7d–365d
    • model.paramsCalibrated SVI parameters — α, β, ρ, m, σ
    • interest.rateForward-implied rate for any expiry
    • realized.volAnnualised realised vol, configurable lookback
    Full WebSocket API reference
    → 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

  2. 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 reference
    POSThttps://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
        }
      }
    }
  3. Step 03: Oracles and routing

    Every subscription carries a sid you 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.

    How the oracle delivers
    Routing
    A sid you 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.

The composite exists so that the number you mark, the number you margin against and the number you backtest on are the same number, independent of any single exchange.
  1. /01

    Source-agnostic marks

    Value a book without inheriting one venue’s outage, thin book or bad print.

  2. /02

    Portfolio risk

    Greeks and exposures computed from one surface, so teams reconcile against each other.

  3. /03

    Margin

    Requirements stressed on the same filtered, arbitrage-checked composite surface.

  4. /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.

Start on Core to evaluate, move to Prime for production, Enterprise for dedicated capacity. Additional assets and exchanges are available as add-on packages.
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
    Choose plan
  • Data Prime

    For teams running on BS data daily.

    • Everything in Core
    • Minutely data via REST
    • WebSocket streaming
    • Pull oracle with EIP-712 signatures
    Choose plan
  • 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
    Talk to us
Full plan breakdown in the docs

Get started

Integrate the Data API into your own systems.

Data Plans

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.

As of
BTC SPOT61,913.61−1.71% (since 19 Nov 2026 00:00 UTC)BTC FWD 30D62,155.96−1.75% (since 19 Nov 2026 00:00 UTC)BTC BASIS 30D+39.1bpBTC FUNDING+0.2bp−0.2bp (since 19 Nov 2026 00:00 UTC)BTC ATM 7D46.91%+0.95 vol pts (since 19 Nov 2026 00:00 UTC)BTC 25Δ SKEW 7D−9.34−2.06 vol pts (since 19 Nov 2026 00:00 UTC)BSIV 30D51.82+2.24 vol pts (since 19 Nov 2026 00:00 UTC)ETH SPOT$1,755−1.10% (since 19 Nov 2026 00:00 UTC)ETH ATM 7D60.30%+2.49 vol pts (since 19 Nov 2026 00:00 UTC)ETH 25Δ SKEW 7D−9.28−2.32 vol pts (since 19 Nov 2026 00:00 UTC)HYPE SPOT$66.73−0.27% (since 19 Nov 2026 00:00 UTC)HYPE ATM 7D75.53%+6.57 vol pts (since 19 Nov 2026 00:00 UTC)HYPE 25Δ SKEW 7D−3.76−4.35 vol pts (since 19 Nov 2026 00:00 UTC)SOL SPOT$73.06−0.65% (since 19 Nov 2026 00:00 UTC)SOL ATM 7D69.16%+4.28 vol pts (since 19 Nov 2026 00:00 UTC)SOL 25Δ SKEW 7D−6.32−6.46 vol pts (since 19 Nov 2026 00:00 UTC)XRP SPOT$0.9592−0.74% (since 19 Nov 2026 00:00 UTC)XRP ATM 7D74.59%+1.49 vol pts (since 19 Nov 2026 00:00 UTC)XRP 25Δ SKEW 7D−5.00−1.21 vol pts (since 19 Nov 2026 00:00 UTC)SPX SPOT$7,170−2.49% (since 19 Nov 2026 00:00 UTC)SPX ATM 7D25.40%+3.64 vol pts (since 19 Nov 2026 00:00 UTC)SPX 25Δ SKEW 7D−6.62−1.53 vol pts (since 19 Nov 2026 00:00 UTC)NVDA SPOT$145.78−4.04% (since 19 Nov 2026 00:00 UTC)NVDA ATM 7D60.32%+1.38 vol pts (since 19 Nov 2026 00:00 UTC)NVDA 25Δ SKEW 7D−8.10−1.99 vol pts (since 19 Nov 2026 00:00 UTC)SPCX SPOT$137.03−5.23% (since 19 Nov 2026 00:00 UTC)SPCX ATM 7D59.37%+2.26 vol pts (since 19 Nov 2026 00:00 UTC)SPCX 25Δ SKEW 7D−9.40−2.19 vol pts (since 19 Nov 2026 00:00 UTC)MU SPOT$683.05−4.10% (since 19 Nov 2026 00:00 UTC)MU ATM 7D87.40%+0.93 vol pts (since 19 Nov 2026 00:00 UTC)MU 25Δ SKEW 7D−12.49−2.59 vol pts (since 19 Nov 2026 00:00 UTC)