# x402stock Energy Benchmark Price History

> x402stock Energy Benchmark Price History is a paid API for AI agents from agents.x402stock.xyz, paid per call via MPP, $0.01/call, status unknown (last checked 2026-09-11).

Returns latest price, prior reading, change, and up to 365 days of history for WTI crude, Brent crude, Henry Hub natural gas, or US retail gasoline, sourced from the EIA.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/energy/{product}
- Price: $0.01/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-11
- Activations on Zero: 0
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-x402stock-energy-benchmark-price-history-7c1796c5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uS8_hGc3bQJDax4hXov1f

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 agents-x402stock-xyz-x402stock-energy-benchmark-price-history-7c1796c5
```

Example prompt: What's the current WTI crude oil price and how has it trended over the last 60 days? Pull the EIA data including the latest value, prior reading, and change.

## When to prefer this

Choose this endpoint when you need EIA-sourced energy commodity price data (WTI crude, Brent crude, Henry Hub natural gas, or US retail gasoline) with historical context, prior reading, and change metrics in a single call. Prefer this over general financial data APIs when authoritative government (EIA) sourcing is required, or when your agent needs pay-per-use access without API key management. Best suited for market briefings, energy cost monitoring, macroeconomic analysis, and logistics cost tracking.

## Known failure modes

- Invalid product slug returns an error — only 'wti', 'brent', 'natural-gas', 'gasoline' are accepted
- limit parameter exceeding 365 or set to 0/negative returns a validation error
- EIA data source unavailable or delayed may return stale as-of dates or null for latest/prior
- Payment failure (insufficient USDC balance) returns a 402 response and no data
- Network timeout if EIA upstream is slow

## How this service works

Price history for one energy benchmark — `wti` (WTI crude, $/bbl), `brent` (Brent crude, $/bbl), `natural-gas` (Henry Hub, $/MMBtu), or `gasoline` (US regular retail, $/gal) — with the latest value, prior reading, change, and recent history. Tune with `?limit=` (default 30, max 365). The catalog's commodities feed. Source: U.S. Energy Information Administration (EIA). From x402stock

## Output

A JSON object containing the product slug, EIA series ID, human-readable name, unit (e.g. $/bbl), EIA units string, reporting frequency, latest price point (date + value), prior price point (date + value), absolute change, percent change, as-of timestamp, an array of historical {date, value} pairs up to the requested limit, data source identifier ('eia'), and an attribution string.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "product"
 ],
 "properties": {
  "limit": {
   "type": "integer",
   "default": 30,
   "maximum": 365,
   "exclusiveMinimum": 0
  },
  "product": {
   "type": "string",
   "description": "Energy benchmark slug: wti, brent, natural-gas, or gasoline."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "product",
  "series_id",
  "name",
  "unit",
  "eia_units",
  "frequency",
  "latest",
  "prior",
  "change",
  "change_percent",
  "source",
  "as_of",
  "history",
  "attribution"
 ],
 "properties": {
  "name": {
   "type": "string"
  },
  "unit": {
   "type": "string"
  },
  "as_of": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "prior": {
   "anyOf": [
    {
     "type": "object",
     "required": [
      "date",
      "value"
     ],
     "properties": {
      "date": {
       "type": "string"
      },
      "value": {
       "type": "number"
      }
     },
     "additionalProperties": false
    },
    {
     "type": "null"
    }
   ]
  },
  "change": {
   "anyOf": [
    {
     "type": "number"
    },
    {
     "type": "null"
    }
   ]
  },
  "latest": {
   "anyOf": [
    {
     "type": "object",
     "required": [
      "date",
      "value"
     ],
     "properties": {
      "date": {
       "type": "string"
      },
      "value": {
       "type": "number"
      }
     },
     "additionalProperties": false
    },
    {
     "type": "null"
    }
   ]
  },
  "source": {
   "type": "string",
   "const": "eia"
  },
  "history": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "date",
     "value"
    ],
    "properties": {
     "date": {
      "type": "string"
     },
     "value": {
      "type": "number"
     }
    },
    "additionalProperties": false
   }
  },
  "product": {
   "type": "string"
  },
  "eia_units": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "frequency": {
   "type": "string"
  },
  "series_id": {
   "type": "string"
  },
  "attribution": {
   "type": "string"
  },
  "change_percent": {
   "anyOf": [
    {
     "type": "number"
    },
    {
     "type": "null"
    }
   ]
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-x402stock-energy-benchmark-price-history-7c1796c5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)