# US Diesel Price Brief (LLM Narrative)

> US Diesel Price Brief (LLM Narrative) is a paid API for AI agents from oracles-production.up.railway.app, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-14).

Returns an LLM-generated plain-English summary of recent US diesel price movement over a configurable time window.

## Facts

- Endpoint: GET https://oracles-production.up.railway.app/v1/energy-diesel/brief
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-diesel-price-brief-llm-narrative-5b67fd68
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_e9h75GshHeuZcInhj-eDI

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 us-diesel-price-brief-llm-narrative-5b67fd68
```

Example prompt: Give me a quick AI-written briefing on how US diesel prices have moved over the past 30 days.

## When to prefer this

Use this endpoint when you need a human-readable, narrative summary of recent US diesel price trends rather than raw price data. Ideal for briefings, newsletters, dashboards, or conversational agents where concise prose is preferred over structured numbers. Choose this over raw data endpoints when the consumer is a non-technical stakeholder or an LLM that needs context about energy costs.

## Known failure modes

- No price change data in the requested window — brief may note no significant movement
- Invalid date-time format for 'since' parameter — request rejected
- Payment not completed or insufficient — 402 Payment Required
- Window too far in the past with no stored data — empty or minimal brief returned

## How this service works

LLM-written read on recent movement in US diesel price — direction and magnitude.

## Output

A short LLM-generated narrative (brief) summarizing recent US diesel price movement, tagged with whether it was produced by an LLM or a template, and noting how many price changes it was based on.

## 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": {
      "since": {
       "type": "string",
       "format": "date-time",
       "description": "Window start (default: last 30 days)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "brief": {
       "type": "string"
      },
      "generatedBy": {
       "enum": [
        "llm",
        "template"
       ],
       "type": "string"
      },
      "basedOnChanges": {
       "type": "integer"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-diesel-price-brief-llm-narrative-5b67fd68/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)