# Gloom Options Implied Volatility API

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

Returns implied volatility metrics (IV7, IV30, IV60, IV90, IV180) and spot price for one or more stock ticker symbols.

## Facts

- Endpoint: GET https://api.gloom.sh/v1/options/iv?utm_source=zero.xyz
- Price: $0.12/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-implied-volatility-api-8d8d7efc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xVt9A1nmbdFhXdrTDX0DG

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-implied-volatility-api-8d8d7efc
```

Example prompt: Can you pull the implied volatility data for AAPL and TSLA — I need the IV30 and spot price for both to decide if options premiums are elevated right now?

## When to prefer this

Use this endpoint when you need multi-horizon implied volatility term structure data (IV7 through IV180) and spot price for equity tickers in a single call. Prefer this over general market data APIs when your use case is specifically options pricing, volatility trading, or risk analysis requiring IV across different expiration windows. It is cost-effective at $0.12 USDC per call for ad-hoc or low-frequency lookups.

## Known failure modes

- Missing or invalid 'symbols' query parameter returns an error
- Unknown ticker symbols may return null IV values across all horizons
- IV values for shorter or longer horizons (iv7, iv60, iv90, iv180) may be null when insufficient options data exists
- Payment failure via x402 protocol results in 402 response before data is returned
- Rate limiting or service downtime may cause timeouts

## 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 a JSON array of objects per symbol, each containing IV at multiple time horizons (iv7, iv30, iv60, iv90, iv180 — some may be null if unavailable), the current spot price, the calculation method used (e.g. 'quote-mid'), and timestamps for when the data was captured and the session date.

## 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": [
   {
    "iv7": null,
    "iv30": 0.126587000116,
    "iv60": null,
    "iv90": null,
    "spot": 774.95,
    "iv180": null,
    "method": "quote-mid",
    "symbol": "AAPL",
    "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-implied-volatility-api-8d8d7efc/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)