# EIA US Diesel Price Change Feed

> EIA US Diesel Price Change Feed 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 diesel prices from the Energy Information Administration, scored by significance.

## Facts

- Endpoint: GET https://oracles-production.up.railway.app/v1/energy-diesel/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-diesel-price-change-feed-1301b1b0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ClvOT_k0EZTx7rt49Xkl4

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-diesel-price-change-feed-1301b1b0
```

Example prompt: Show me all EIA diesel price changes detected since 2025-01-01T00:00:00Z with a significance score of at least 5, and limit the results to 50.

## When to prefer this

Use this endpoint when you need to programmatically detect and react to new US diesel price observations from the authoritative EIA source, especially when you need significance filtering or time-windowed polling. Prefer over generic energy data APIs when you want pre-scored change events with source verification links rather than raw time-series data.

## Known failure modes

- EIA_API_KEY not set — endpoint no-ops and returns empty or error response
- Invalid since parameter format (must be ISO-8601) — likely 400 error
- limit out of range (must be 1-500) — validation error
- min_significance out of range (must be 1-10) — validation error
- EIA upstream outage — may return empty results or timeout
- Payment not provided or insufficient — 402 response

## How this service works

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

## Output

A JSON object containing a count of matching change events, the source identifier, and an array of change records — each with a type, title, summary, detail object, entityId, sourceUrl for verification, detectedAt timestamp, significance score (1-10), and optional effectiveDate.

## 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-diesel-price-change-feed-1301b1b0/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)