# Gloom Options Volatility Surfaces API

> Gloom Options Volatility Surfaces API is a paid API for AI agents from api.gloom.sh, paid per call via x402, $1.5/call, status unknown (last checked 2026-11-01).

Fetches implied volatility surfaces for one or more equity/ETF ticker symbols, returning spot price, expiry ladder, and surface data captured at market close.

## Facts

- Endpoint: GET https://api.gloom.sh/v1/options/surfaces?utm_source=zero.xyz
- Price: $1.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gloom-options-volatility-surfaces-api-85d3b8ba
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rohlqrV8IuUOvmOCmk8qK

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 gloom-options-volatility-surfaces-api-85d3b8ba
```

Example prompt: Pull the current implied volatility surface for AAPL and SPY from Gloom so I can see the full expiry ladder and spot prices.

## When to prefer this

Choose this endpoint when you need structured implied volatility surface data — including full expiry ladders and spot prices — for equity options analysis, derivatives pricing, or hedging workflows. Prefer it over generic market data APIs when you specifically need the vol surface (not just option quotes or Greeks), and when working with Gloom's finance terminal ecosystem. Best suited for quantitative finance agents doing model calibration, vol monitoring, or risk analysis.

## Known failure modes

- Invalid or unrecognized ticker symbol returns missing or empty surface data
- Market closed or no recent session may return stale capturedAt timestamps
- Missing required 'symbols' query parameter results in a 400-level error
- Symbol with no options market (e.g. OTC stocks) may return empty expiries array
- Rate limiting or payment failure (x402) results in 402 Payment Required response

## How this service works

Gloom is a free, open-source finance terminal for desktop and TUI with charts, news, filings, portfolios, alerts, and plugins.

## Output

Returns an array of objects per requested symbol, each containing: the current spot price, the full implied volatility surface object (with source, version, expiry ladder, spot-as-of timestamp, and capture timestamp), session date, and any surface computation failures. Data reflects the most recently captured market session.

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "symbols"
     ],
     "properties": {
      "symbols": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "spot": 774.95,
    "symbol": "AAPL",
    "surface": {
     "spot": 774.95,
     "source": "gloom",
     "symbol": "SPY",
     "version": 1,
     "expiries": [
      {}
     ],
     "failures": [],
     "spotAsOf": "2026-10-08T16:46:00.000Z",
     "capturedAt": "2026-10-08T16:55:20.000Z"
    },
    "capturedAt": "2026-10-08T16:55:20.000Z",
    "sessionDate": "2026-10-08"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-options-volatility-surfaces-api-85d3b8ba/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.gloom.sh](https://www.zero.xyz/host/api.gloom.sh/llms.txt)