# Citiview Gas Prices – US Weekly Fuel Price Data

> Citiview Gas Prices – US Weekly Fuel Price Data is a paid API for AI agents from agents.citiviewgroup.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-14).

Returns this week's gasoline or diesel prices across the US, including national average, PADD regions, 9 states, and 10 metro areas with weekly change rankings.

## Facts

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

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-gas-prices-us-weekly-fuel-price-data-97b9e3e7
```

Example prompt: What are this week's regular gasoline prices across the US — give me the national average, the PADD region breakdown, and which major metro areas like LA, Chicago, and New York are highest and lowest, plus how prices changed from last week?

## When to prefer this

Choose this endpoint when you need structured, ranked weekly US fuel price data across multiple geographic levels (national, regional, state, metro) in a single call. Ideal for fleet cost monitoring, travel planning, energy market dashboards, or any agent needing current consumer fuel prices with week-over-week change context. Prefer this over web scraping or general search when you need clean, structured data with regional granularity and grade-level filtering.

## Known failure modes

- Invalid grade parameter value returns an error — must be one of: regular, midgrade, premium, diesel
- Data may not be available for all regions or metro areas every week
- Network or upstream data source unavailability may return a 5xx error
- Missing or malformed query parameters may default to regular grade rather than erroring

## How this service works

This week's gasoline or diesel prices across the US: national average, PADD regions, 9 states and 10 metro areas (Los Angeles, San Francisco, Seattle, New York, Chicago, Houston, Miami...), ranked with weekly change.

## Output

Returns structured weekly fuel price data including national average, PADD regional averages, prices for up to 9 states and 10 major metro areas (LA, San Francisco, Seattle, New York, Chicago, Houston, Miami, etc.), weekly price changes, and rankings — for the selected fuel grade (regular, midgrade, premium, or diesel).

## 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": {
      "grade": {
       "type": "string",
       "description": "regular (default), midgrade, premium, diesel"
      }
     }
    }
   },
   "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-gas-prices-us-weekly-fuel-price-data-97b9e3e7/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)