# EIA US Regular Gasoline Price Change Oracle

> EIA US Regular Gasoline Price Change Oracle is a paid API for AI agents from oracles-production.up.railway.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns newly detected changes in US regular gasoline prices from the EIA, scored by significance, filterable by time and threshold.

## Facts

- Endpoint: GET https://oracles-production.up.railway.app/v1/energy-gas/changes
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eia-us-regular-gasoline-price-change-oracle-34645459
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0bWTa4P07e98sQ4dQFqMl

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 eia-us-regular-gasoline-price-change-oracle-34645459
```

Example prompt: Show me any US regular gasoline price changes detected since 2025-06-01T00:00:00Z with a significance of at least 5, up to 50 results.

## When to prefer this

Use this endpoint when you need structured, scored change-event data for US regular gasoline prices sourced directly from the EIA, especially when you want to filter by recency or significance threshold. Prefer this over general commodity APIs when you need verifiable primary-source links and machine-readable significance scores for downstream alerting or compliance workflows.

## Known failure modes

- EIA_API_KEY not set — endpoint returns no-op or empty result set
- Invalid ISO-8601 'since' value — returns 400 or empty results
- limit out of range (must be 1–500) — returns validation error
- min_significance out of range (must be 1–10) — returns validation error
- EIA upstream outage — no new observations returned
- Payment not processed (x402) — request rejected before reaching handler

## How this service works

New weekly US regular gasoline price data points since a timestamp (US Energy Information Administration), each with the $/gal value and record date. Answers "did US regular gasoline price change this week?"

## Output

A JSON object containing a count of matched change events, a source label (EIA), and an array of change records each with a type, title, summary, detail object, entityId, sourceUrl for verification, detectedAt timestamp, effectiveDate, and a significance score from 1–10.

## 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": {
      "limit": {
       "type": "integer",
       "maximum": 500,
       "minimum": 1
      },
      "since": {
       "type": "string",
       "format": "date-time",
       "description": "Only changes detected after this ISO-8601 instant"
      },
      "min_significance": {
       "type": "integer",
       "maximum": 10,
       "minimum": 1,
       "description": "Keep only changes scored at least this"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "count": {
       "type": "integer"
      },
      "source": {
       "type": "string"
      },
      "changes": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "type": {
          "type": "string"
         },
         "title": {
          "type": "string"
         },
         "detail": {
          "type": "object"
         },
         "summary": {
          "type": "string"
         },
         "entityId": {
          "type": "string"
         },
         "sourceUrl": {
          "type": [
           "string",
           "null"
          ],
          "description": "Primary-source link for verification"
         },
         "detectedAt": {
          "type": "string",
          "format": "date-time"
         },
         "significance": {
          "type": "integer",
          "maximum": 10,
          "minimum": 1
         },
         "effectiveDate": {
          "type": [
           "string",
           "null"
          ]
         }
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eia-us-regular-gasoline-price-change-oracle-34645459/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from oracles-production.up.railway.app](https://www.zero.xyz/host/oracles-production.up.railway.app/llms.txt)