# Citiview US Energy Prices

> Citiview US Energy Prices is a paid API for AI agents from agents.citiviewgroup.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-14).

Returns current US energy prices from the EIA including retail gasoline, diesel, WTI crude, Henry Hub natural gas, crude oil inventories, and residential electricity prices by state with latest value and change.

## Facts

- Endpoint: GET https://agents.citiviewgroup.com/v1/energy?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/citiview-us-energy-prices-e6c93ea1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_glMeXaCe4xigM50Vb3lwg

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 citiview-us-energy-prices-e6c93ea1
```

Example prompt: What's the current WTI crude oil price and how much has it changed recently? Also pull the latest retail gasoline and diesel prices from the EIA.

## When to prefer this

Choose this endpoint when you need current, EIA-sourced US energy price data including retail fuel, natural gas, crude oil benchmarks, inventory levels, or state-level electricity rates. Prefer this over generic search or scraping when you want structured, normalized price data with change metrics ready for downstream computation or reporting.

## Known failure modes

- Invalid indicator value returns error — must be one of: gasoline, diesel, wti, natural_gas, crude_stocks, electricity
- State parameter required for electricity indicator but missing — returns error
- EIA data temporarily unavailable — upstream data fetch failure
- Invalid 2-letter state code returns empty or error response
- Payment of 0.003 USDC per call required via x402 protocol — missing payment returns 402

## How this service works

US energy prices from the EIA: retail gasoline and diesel, WTI crude, Henry Hub natural gas, crude oil inventories and residential electricity prices by state, with the latest value and change.

## Output

Returns the latest value and change for the requested energy indicator — such as gasoline price ($/gallon), diesel price ($/gallon), WTI crude spot price ($/barrel), Henry Hub natural gas price ($/MMBtu), crude oil inventories (barrels), or residential electricity price by state (cents/kWh) — sourced from the U.S. Energy Information Administration.

## 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": {
      "state": {
       "type": "string",
       "description": "2-letter state for electricity"
      },
      "points": {
       "type": "integer"
      },
      "indicator": {
       "type": "string",
       "description": "gasoline | diesel | wti | natural_gas | crude_stocks | electricity"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/citiview-us-energy-prices-e6c93ea1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.citiviewgroup.com](https://www.zero.xyz/host/agents.citiviewgroup.com/llms.txt)