# Laevitas Vol Surface Term Structure

> Laevitas Vol Surface Term Structure is a paid API for AI agents from apiv2.laevitas.ch, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-13).

Retrieves the volatility term structure for crypto options, showing implied volatility across different expiries for a given underlying asset.

## Facts

- Endpoint: GET https://apiv2.laevitas.ch/api/v1/vol-surface/term-structure
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/laevitas-vol-surface-term-structure-b745ce06
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cf9JGUJ9E1OqN94hLBGhC

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability laevitas-vol-surface-term-structure-b745ce06
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Professional market data API for crypto derivatives, spot markets, prediction markets, Hyperliquid HyperCore data, proprietary volatility surfaces, and analytics.

## Authentication

Use an API key for authenticated REST requests:

```http
X-API-Key: your-api-key-here
```

Most data endpoints also support x402 pay-per-request without an API key.

| Resource | Path |
| --- | --- |
| OpenAPI JSON | `GET /openapi.json` |
| x402 discovery | `GET /.well-known/x402` |
| Changelog | `GET /api/v1/changelog` |
| WebSocket docs | `GET /websocket` |

## REST Surfaces

| Surface | Examples |
| --- | --- |
| Instruments | Cross-market contract reference data |
| Futures | OHLCVT, trades, tickers, orderbook, liquidations, carry |
| Perpetuals | OHLCVT, trades, funding, open interest, orderbook, liquidations |
| Options | OHLCVT, trades, Greeks, volatility, flow, dealer GEX |
| Vol Surface | Proprietary surface snapshots, slices, strikes, term structure, risk |
| Spot | OHLCVT, ticker, trades, volume, L2 orderbook, snapshots |
| Predictions | Polymarket instruments, categories, trades, ticker history |
| Hyperliquid - HyperCore | Node-derived fills, liquidations, positions, funding, TWAPs, resting orders, L2 books |
| Analytics | Realized volatility and derived metrics |

## Pagination

Paginated endpoints return the cursor at `meta.next_cursor`. Pass that value back as the `cursor` query parameter to fetch the next page.

## WebSocket Streaming

Real-time streams are documented at `/websocket`.

| Data | Channel pattern |
| --- | --- |
| Trades | `trades.{market}.{exchange}.{instrument}` |
| OHLC ticker | `ohlc.ticker.{market}.{exchange}.{instrument}.{timeframe}` |
| OHLCVT | `ohlc.vt.{market}.{exchange}.{instrument}.{timeframe}` |

Variables: `market` is one of `perpetuals`, `futures`, `options`, or `spot`; `timeframe` is one of `1m`, `5m`, `15m`, `1h`, `4h`, or `1d`.

## Quick Start

```bash
curl "https://apiv2.laevitas.ch/api/v1/futures/ohlcvt?exchange=deribit&instrument_name=BTC-PERPETUAL" \
  -H "X-API-Key: your-api-key-here"
```

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [],
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/laevitas-vol-surface-term-structure-b745ce06/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from apiv2.laevitas.ch](https://www.zero.xyz/host/apiv2.laevitas.ch/llms.txt)