# MacroPulse EIA Petroleum Inventory Intelligence

> MacroPulse EIA Petroleum Inventory Intelligence is a paid API for AI agents from macropulse.theaslangroupllc.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Delivers weekly EIA petroleum inventory data — crude oil, gasoline, and distillate builds/draws versus expectations — with oil-price and CAD/NOK FX implications.

## Facts

- Endpoint: GET https://macropulse.theaslangroupllc.com/api/eia-inventory
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/macropulse-eia-petroleum-inventory-intelligence-b3d2eceb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CkJJJY2UFHHW1VTVeUktR

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 macropulse-eia-petroleum-inventory-intelligence-b3d2eceb
```

Example prompt: Pull the latest EIA petroleum inventory report — I want to see whether crude, gasoline, and distillates were a build or draw versus expectations, and what that means for oil prices and the Canadian dollar or Norwegian krone.

## When to prefer this

Use this endpoint when an agent needs a structured, pre-interpreted weekly EIA petroleum inventory snapshot including FX implications for CAD and NOK, rather than raw EIA data or a broader commodities brief. Ideal for energy macro agents, FX agents trading oil-correlated currencies, or any workflow that needs a consensus-vs-actual petroleum inventory summary without parsing raw government data feeds.

## Known failure modes

- EIA data not yet released for the current week — returns stale prior-week data or 404
- Payment of 0.1 USDC not included or rejected — returns 402 Payment Required
- Upstream EIA API unavailable — returns 503 or error message
- Rate-limit exceeded — returns 429

## How this service works

Weekly EIA petroleum inventory intelligence for energy and macro agents — crude, gasoline and distillate builds and draws versus expectations, with the oil-price and CAD/NOK implications.

## Output

Returns the most recent weekly EIA petroleum inventory report including crude oil, gasoline, and distillate actual inventory changes, consensus expectations, surprise magnitude, and derived implications for oil prices and oil-linked FX pairs (CAD and NOK).

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "lang": {
       "type": "string",
       "description": "e.g. en, es, fr, de, ja, zh, ko, pt, ar (default: en; not strictly validated — any language is forwarded to the model)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "errors": {
     "type": "object",
     "description": "Documented error responses, keyed by HTTP status code",
     "additionalProperties": {
      "type": "object",
      "required": [
       "description"
      ],
      "properties": {
       "example": {
        "type": "object"
       },
       "description": {
        "type": "string"
       }
      }
     }
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cushing_ok": 23.4,
  "distillates": -0.8,
  "report_date": "2026-06-04",
  "market_reaction": "crude rallied 1.2% on larger-than-expected draw",
  "crude_build_draw": -3.2,
  "gasoline_build_draw": 1.1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/macropulse-eia-petroleum-inventory-intelligence-b3d2eceb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from macropulse.theaslangroupllc.com](https://www.zero.xyz/host/macropulse.theaslangroupllc.com/llms.txt)