# PreReason Oil Producers Briefing

> PreReason Oil Producers Briefing 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 WTI and Brent spot prices, US oil and gas inventory z-scores, and side-by-side stock data for covered US oil producers, integrated majors, refiners, and oilfield service companies vs WTI

## Facts

- Endpoint: GET https://api.prereason.com/api/commodities/oil-producers?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-oil-producers-briefing-e7a1a2be
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_I4u8TEr4xv5ZL8STQbFq9

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-oil-producers-briefing-e7a1a2be
```

Example prompt: Pull me today's crude oil briefing — WTI and Brent spot prices, US oil and gas inventory z-scores vs the 5-year EIA norm, and how the covered US producers, integrated majors, and refiners are tracking against WTI in markdown format.

## When to prefer this

Choose this endpoint when you need a combined view of crude oil benchmark prices (WTI, Brent), US energy inventory context (EIA z-scores), and US-listed oil company equity performance all in one call. It is ideal for energy sector analysis, portfolio monitoring, and AI agent briefings that need commodity and equity data together without separate API calls to price feeds and stock data providers. Prefer it over generic financial data APIs when you specifically want coverage of US oil producers, refiners, integrated majors, and oilfield services companies benchmarked against WTI.

## Known failure modes

- Date parameter not in YYYY-MM-DD format returns validation error
- Requested historical date not in PreReason record returns empty or error response
- Missing or invalid x402 payment header results in 402 Payment Required
- Unsupported format enum value returns bad request error
- Service unavailability or upstream EIA data lag may result in stale or partial data

## 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

Returns a structured briefing with six commodity metrics (WTI, Brent, Brent-WTI spread, natural gas price, oil inventory z-score, natgas storage z-score), plus per-company data for each covered US oil producer, integrated major, refiner, and oilfield services company — including share price, 1/3/12-month performance vs WTI over the same windows, 90-day daily-return correlation with WTI, and a link ID to each company's own filed-figures briefing. Companies are grouped and ordered by stored market cap.

## 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"
   }
  },
  "briefing_used": "commodities.oil-producers",
  "briefing_metadata": {
   "name": "Oil and Its Producers",
   "description": "Crude oil and the covered USA companies EDGAR codes tie to it, side by side: US oil and gas stocks against the five year norm (EIA), WTI and Brent spot, then each integrated major, producer and refiner, and two oil field service companies coded as producers, with its share price, its change over 1, 3 and 12 months beside WTI over the same windows, and the 90 day correlation of its daily changes with WTI, with the id of its own briefing for its filed figures. Each group in order of stored market capitalisation; it describes, it does not rank.",
   "metrics_count": 6,
   "correlations_count": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/prereason-oil-producers-briefing-e7a1a2be/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)