# PreReason Energy Basket

> PreReason Energy Basket is a paid API for AI agents from api.prereason.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-12).

Returns US oil and gas market data including EIA crude/gas inventory z-scores versus 5-year norms, WTI/Brent/Henry Hub spot prices, Brent-WTI spread, and 30-day WTI realized volatility

## Facts

- Endpoint: GET https://api.prereason.com/api/commodities/energy-basket?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/prereason-energy-basket-5e76332f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QcIAyQyhaGT2XD45g5BpS

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 prereason-energy-basket-5e76332f
```

Example prompt: Pull the current energy basket briefing — I want to see where US crude oil and natural gas inventories stand versus their 5-year norms, today's WTI and Brent prices, the Brent-WTI spread, and the 30-day realized volatility on WTI, formatted as markdown.

## When to prefer this

Choose this endpoint when you need a pre-contextualized, multi-metric energy commodities snapshot that places EIA weekly crude and gas inventory data against 5-year seasonal norms with z-scores — rather than raw price feeds or single-metric lookups. Ideal when an agent needs to answer 'is the market tight or loose?' without computing historical comparisons itself. Prefer over generic commodity price APIs when the user wants inventory context, volatility, and spread data in one call.

## Known failure modes

- Requested historical date not on record returns an error or empty dataset
- Invalid date format (not YYYY-MM-DD) returns a validation error
- EIA data not yet released for the current week may return stale or unavailable inventory readings
- Payment failure (x402) results in 402 response before data is served

## How this service works

Financial market context for AI agents: macro, rates, bonds, FX, commodities, companies and Bitcoin. One API call returns a briefing with the reasoning already in it.

## Output

A structured briefing (JSON or token-optimized markdown) containing 7 metrics: WTI crude price, Brent crude price, Brent-WTI spread, Henry Hub natural gas price, oil inventory z-score vs 5-year seasonal norm, natural gas storage z-score vs 5-year seasonal norm, and WTI 30-day realized volatility computed from EIA spot prices — plus upcoming EIA report dates and one cross-metric correlation.

## 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",
     "properties": {
      "date": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
       "description": "Historical date in YYYY-MM-DD format. A paid call serves today or any ?date= on record."
      },
      "format": {
       "enum": [
        "json",
        "markdown"
       ],
       "type": "string",
       "description": "Response format. markdown is token-optimized for LLMs, json is structured. Default is markdown."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "metrics": {
   "oil-wti": {
    "name": "oil-wti"
   },
   "oil-brent": {
    "name": "oil-brent"
   },
   "brent-wti-spread": {
    "name": "brent-wti-spread"
   },
   "natural-gas-price": {
    "name": "natural-gas-price"
   },
   "oil-inventory-zscore": {
    "name": "oil-inventory-zscore"
   },
   "natgas-storage-zscore": {
    "name": "natgas-storage-zscore"
   },
   "oil-wti-realized-vol-30d": {
    "name": "oil-wti-realized-vol-30d"
   }
  },
  "briefing_used": "commodities.energy-basket",
  "briefing_metadata": {
   "name": "Energy Basket",
   "description": "US oil and gas stocks against the five year norm, with what changed and what comes next: EIA weekly commercial crude stocks and Lower 48 gas storage, each placed against the same week in the prior five years; WTI, Brent and Henry Hub spot prices; the Brent to WTI spread; WTI 30 day realised volatility (computed from EIA spot prices, backward looking); the dates of the next EIA reports.",
   "metrics_count": 7,
   "correlations_count": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/prereason-energy-basket-5e76332f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.prereason.com](https://www.zero.xyz/host/api.prereason.com/llms.txt)