US fuel-price signals (pump-price shock and spread gauges)
Monthly retail fuel-price signals derived from EIA data via FRED (regular gasoline and on-highway diesel, $/gal): month-on-month and year-on-year changes, 30-month change volatility, 3-sigma anomaly flags vs a trailing-12-month baseline, drift forecasts, per-month cross-series volatility ranks, the gasoline-diesel spread with a 3-year z-score, and pump-shock (>+15% in 3 months) and expensive (>$4/gal) flags. The US-side companion to the Canada fuel signals and the retail-price complement to wholesale crude. Country codes normalized to ISO alpha-3 (USA). Raw data: US Energy Information Administration via FRED.
Quality
Attribution
Federal Reserve Bank of St. Louis (FRED; underlying data: US Energy Information Administration)
Schema
| Column | Type | Description |
|---|---|---|
| date | string | Observation date (month start). (unit: ISO date) |
| country | string | Country of the series (United States). |
| country_code | string | ISO 3166-1 alpha-3 country code (USA). |
| series_id | string | FRED series identifier: GASREGCOVM or GASDESM. |
| series_label | string | FRED series title. |
| value | float | Retail fuel price, dollars per gallon: regular gasoline (GASREGCOVM) or diesel (GASDESM). (unit: dollars per gallon) |
| volatility_30d | float | |
| momentum_3m | float | |
| yoy_change_pct | float | |
| anomaly_flag | integer | |
| forecast_1m | float | |
| rank | integer | |
| gas_diesel_spread | float | |
| spread_z_3y | float | |
| pump_shock_flag | integer | |
| expensive_flag | integer |
Sample rows
| date | country | country_code | series_id | series_label | value | volatility_30d | momentum_3m | yoy_change_pct | anomaly_flag | forecast_1m | rank | gas_diesel_spread | spread_z_3y | pump_shock_flag | expensive_flag |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1990-09-01 | United States | USA | GASREGCOVM | US Regular Conventional Gas Price | 1.258 | — | — | — | 0 | — | — | — | — | 0 | 0 |
| 1990-10-01 | United States | USA | GASREGCOVM | US Regular Conventional Gas Price | 1.335 | — | — | — | 0 | — | — | — | — | 0 | 0 |
| 1990-11-01 | United States | USA | GASREGCOVM | US Regular Conventional Gas Price | 1.324 | — | — | — | 0 | — | — | — | — | 0 | 0 |
| 1991-02-01 | United States | USA | GASREGCOVM | US Regular Conventional Gas Price | 1.094 | — | -13.036565977742443 | — | 0 | — | — | — | — | 0 | 0 |
| 1991-03-01 | United States | USA | GASREGCOVM | US Regular Conventional Gas Price | 1.04 | — | -22.097378277153556 | — | 0 | 0.9855 | — | — | — | 0 | 0 |
Download sample data
Download the full sample snapshot for this dataset (sample rows, not the complete dataset).
Use with an LLM
Point any LLM at the metadata endpoint — the documentation above is machine-readable too (JSON-LD + Croissant).
cURL
curl "https://datazimuts.com/v1/datasets/us_fuel_signals/us_fuel_price_signals" | jq '{title, rows, columns_count, license}'Python
import requests
ds = requests.get("https://datazimuts.com/v1/datasets/us_fuel_signals/us_fuel_price_signals").json()
print(ds["title"], ds["rows"], "rows")
# Sample rows for an LLM context window
for row in ds.get("sample_rows", [])[:5]:
print(row)API endpoint: https://datazimuts.com/v1/datasets/us_fuel_signals/us_fuel_price_signals
Tip: fetch /llms.txt for the full machine-readable catalog.