# Gloom Futures Curve Data API

> Gloom Futures Curve Data 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).

Returns the full futures curve (all contract expirations) for a given futures root symbol, including prices, volume, open interest, and expiration dates.

## Facts

- Endpoint: GET https://api.gloom.sh/v1/futures/curves/%7Broot%7D?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-futures-curve-data-api-92b4c88b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_q6wdIw8dCunXzITFjE_U2

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-futures-curve-data-api-92b4c88b
```

Example prompt: Pull the full futures curve for VIX right now — I want to see all the contract expirations, their prices, volume, and open interest so I can analyze the term structure.

## When to prefer this

Use this endpoint when you need the full term structure (all contract expirations) for a futures root symbol in a single call — especially for volatility products like VIX (VX) or other CME/CBOE-listed futures. Prefer this over single-contract endpoints when analyzing contango/backwardation, roll cost, or curve shape. It is well-suited for open-source finance terminal users and AI agents that need structured, machine-readable futures market data with open interest and volume across all maturities.

## Known failure modes

- Invalid or unrecognized root symbol returns an empty data array or 404
- Root symbol not supported on this platform returns an error
- Market closed or data unavailable for a session may return stale or missing data
- Payment not fulfilled (402 Payment Required) if x402 payment header is missing or insufficient
- Rate limiting or quota exceeded returns 429

## 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 futures contract objects, each containing: the as-of date, a human-readable label (e.g. 'VIX 2026-10'), the contract price, price change, ticker symbol, daily volume, currency, quote unit (e.g. volatility points), expiration date, and open interest. The array covers all available expirations for the requested root, forming the complete futures term structure curve.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "asOf": "2026-10-07",
    "label": "VIX 2026-10",
    "price": 17.3343,
    "change": 0.2525,
    "symbol": "VX/V6",
    "volume": 95088,
    "currency": "USD",
    "quoteUnit": "volatility points",
    "expiration": "2026-10-21",
    "openInterest": 148367
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-futures-curve-data-api-92b4c88b/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)