ordinex/dataUS Energy Data

Ordinex US Energy Data — Energy Market Intelligence API

Energy-market data that doesn't suffer from
look-ahead bias.

EIA natural gas, storage, and crude prices, NOAA regional weather, and ISO/RTO wholesale power - normalized, point-in-time correct, and paired with factor scores that were actually walk-forward backtested, not just computed and shipped. One REST API, built to feed trading systems directly.

2
core factors, empirically validated - not just computed
8+5
EIA storage regions and NOAA climate regions covered
27
annual walk-forward folds behind the crude spread factor alone
Direct
EIA + NOAA, public-domain federal sources, not via a reseller
PIT
point-in-time correct, with real reporting-lag safety built in
Auto
daily/weekly automatic refresh, no manual re-runs

Why this matters

No look-ahead bias, and no accidentally-honest factor

Most energy-data feeds stop at "here's the number." This one goes one step further: every factor was tested for whether it actually predicts anything, walk-forward, out-of-sample - and the honest misses are published right alongside the real ones. See the factor catalogue for the full tier breakdown.

01

Source publishes

EIA reports a weekly storage figure days after the "as of" date it actually describes.

02

Reporting lag respected

A real min_lag_days safety margin per source - a factor is never paired against a target move that happened before it was actually public.

03

Nothing overwritten

Every raw fact and factor observation is append-only, insert-if-not-exists - a later revision never silently replaces history.

04

Walk-forward tested

One held-out fold per calendar year, never fit and tested on the same window.

05

Scored, not just shipped

A five-dimension quality scorecard decides the tier - sign consistency, crisis robustness, and economic effect size, not just "it correlates."

Architecture

How data becomes a validated signal

01

Connectors

EIA v2 (natural gas, storage, petroleum, electricity) and NOAA CDO, direct public-domain federal sources. CAISO/NYISO wholesale power feeds the internal factor library.

02

Storage

Append-only, point-in-time - queries reconstruct exactly what was knowable as of any date.

03

Scheduler

Refreshes every source automatically (daily or weekly, matched to how often it actually updates) and recomputes factors forward.

04

Backtest engine

Bucket analysis, regime splits, annual walk-forward, and an economic-significance effect size - before a factor ever reaches the API.

05

REST API

Raw series, factor observations, rankings, and screens - all over HTTP, scoped to what's actually legally cleared to serve.

Factor library

Tiered by real evidence, not an undifferentiated list

Every factor below is sourced from EIA or NOAA - public-domain federal data, cleared for commercial use (see the legal review). Factors are tiered by how they scored on a five-step validation framework: predictive content, monotonicity, regime stability, mandatory walk-forward out-of-sample testing, and economic significance - not just whether they "worked" once. The full methodology and every real backtest result lives in the factor catalogue.

Crude spread mean reversion Tier 1 - Core
WTI/Brent relative-value spread - a clean sweep, 100% on every scorecard dimension. A large, tradeable-scale edge (−0.82x realized volatility at 20 trading days).
wti_brent_spread
Storage response to percentile (Lower 48) Tier 1 - Core
The single strongest, most cross-family-robust predictor in the library - confirmed four separate times across redundancy and combined-signal testing. +0.47x realized volatility at 60 trading days.
storage_percentile
Brent adjustment to spread Tier 2 - Secondary
Regime-dependent, but a perfect 100% on four of five scorecard dimensions - a real, modest confirming signal.
wti_brent_spread
Weather demand anomaly - Central, Southeast, Northeast Tier 2 - Secondary
Regional heating-degree-day anomalies vs. forward Henry Hub returns - independently useful diversification, confirmed via partial-correlation testing against each other.
weather_demand_anomaly_htdd
Storage - Salt, Midwest, South Central, Pacific; Weather - West, South Tier 3 - Context
Real, walk-forward-consistent relationships worth monitoring - not independent enough of the Tier 1 signal, or not reliable enough standalone, to trade on their own.
storage_percentile / weather_demand_anomaly_htdd
Raw EIA price series
Henry Hub, WTI (RWTC), Brent (RBRTE), and all 8 natural-gas-storage regions - the underlying data every factor above is computed from.
/v1/series
CAISO / NYISO wholesale power spark spread Not yet servable
Real, already-computed factors, held back from the public API pending an unresolved licensing question on ISO data redistribution - see the legal review. Used internally for backtesting only.
Rankings & screening
Sort subjects by a factor's latest value, or filter to a value range - the cross-sectional analog of a stock screener, for storage regions and weather zones instead of tickers.
/v1/rankings  /v1/screen
Source health
Per-source row count, last-updated timestamp, and a staleness verdict - open, no API key required.
/v1/health/sources

Quickstart

From zero to your first factor score

1

Get an API key

Sign up below for a free self-service key, or provision one directly if you're running your own instance.

shell
$ python -m scripts.create_api_key "my-bot" Created API key for 'my-bot' (rate limit: 60/min): <your-key>
2

Call an endpoint

Send it as the X-API-Key header on every request.

shell
$ curl -H "X-API-Key: <your-key>" \ https://energy.ordinexdata.com/v1/rankings?factor=storage_percentile&limit=5
3

Read the response

The top 5 storage regions ranked by their latest percentile value, most recent observation on/before today.

200 OK
[ { "factor": "storage_percentile", "subject": "PACIFIC", "value": 88.0 }, { "factor": "storage_percentile", "subject": "R48", "value": 62.3 }, ... ]

Reference

Full endpoint reference, generated from the API itself

Every request/response shape below is generated straight from the running API, so it never drifts out of sync with what's actually deployed.

Swagger UI

Interactive - try a request directly from the browser.

Open /docs

ReDoc

A cleaner read-through reference, better for a first pass.

Open /redoc

Access

Get an API key