Premium LLM-Ready EIA Series
1 creditGET /api/premium/clean/eia/seriesEIA Open Data series in LLM-ready format. Sorted-ascending numeric points, extracted primary_units, and derived month-over-month + year-over-year delta percentages computed against valid (non-null) observations. The deltas are usually the whole reason an agent is asking.
When to use this endpoint
When an agent needs "is this trending up or down?" without writing time-series math. Free /api/economy/eia/series returns raw points; this returns deltas.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| route* | query | string | EIA route (petroleum/pri/spt, electricity/retail-sales, etc.)e.g. petroleum/pri/spt |
| frequency | query | string | daily | monthly | annuale.g. monthly |
| start | query | string | Start date in frequency-matched format (YYYY, YYYY-MM, or YYYY-MM-DD)e.g. 2025-01 |
| end | query | string | End datee.g. 2026-04 |
| length | query | number | Max records (1-5000)e.g. 20 |
* required
Example response
{ "ok": true, "source_format": "eia_v2_envelope", "target_format": "tensorfeed_llm_ready_v1", "data": { "primary_units": "$/Mcf", "points": [{ "period": "2026-04", "value": 2.85, "mom_pct": 1.8, "yoy_pct": -12.4 }] }, "compression_stats": { "reduction_pct": 64 }, "billing": { "credits_charged": 1, "credits_remaining": 49 } }Code samples
Python SDK
tf._get("/premium/clean/eia/series", route="petroleum/pri/spt", frequency="daily")TypeScript SDK
await fetch("https://tensorfeed.ai/api/premium/clean/eia/series?route=petroleum/pri/spt&frequency=daily", { headers: { Authorization: "Bearer tf_live_..." } });FAQ
Why do MoM/YoY deltas matter?
Almost every agent asking about an economic indicator wants to know "is it changing." Pre-computing the deltas saves them the math and the parsing of the upstream EIA response shape.