# Gloom Options Chain Lookup

> Gloom Options Chain Lookup 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).

Returns an options chain for one or more ticker symbols filtered by expiry date, including strike prices, last price, volume, open interest, and call/put side.

## Facts

- Endpoint: GET https://api.gloom.sh/v1/options/chains?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-chain-lookup-476f5bbb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qHK_Ph6VJCpTzTYU_2ssg

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-chain-lookup-476f5bbb
```

Example prompt: Pull the options chain for AAPL and SPY expiring on 2025-01-17 — I want to see strike prices, last prices, volume, and open interest for both calls and puts.

## When to prefer this

Choose this endpoint when you need structured options chain data — strikes, premiums, volume, and open interest — for one or more tickers filtered by a specific expiry date. It is well-suited for algorithmic trading research, options strategy analysis, and derivatives monitoring workflows. Prefer this over general stock quote endpoints when options-specific fields (contract symbol, open interest, side) are required.

## Known failure modes

- Missing required 'symbols' or 'expiry' query params returns a 400 error
- Invalid or unrecognized ticker symbol may return empty data array
- Expiry date not matching any listed contracts returns empty results
- Payment not included or insufficient (x402 protocol) results in 402 Payment Required
- Rate limiting or upstream data provider outage may cause 5xx errors
- Malformed expiry date format may cause a parsing error or empty 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 options contract objects, each containing the contract symbol, ticker symbol, side (call or put), strike price, last price, volume, open interest, percent change, change, and currency.

## 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",
      "expiry"
     ],
     "properties": {
      "expiry": {
       "type": "string"
      },
      "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": [
   {
    "side": "call",
    "change": -1.8800049,
    "strike": 500,
    "symbol": "AAPL",
    "volume": 16,
    "currency": "USD",
    "lastPrice": 274.52,
    "openInterest": 62,
    "percentChange": -0.6801754,
    "contractSymbol": "SPY261009C00500000"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-options-chain-lookup-476f5bbb/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)