Data Sources
The providers behind the numbers, and what each one is used for. Modules without a connected provider are marked as Sample Data.
Last updated:
Connected providers
- FRED (Federal Reserve Bank of St. Louis) — Brent, WTI, Henry Hub, US diesel, Dollar Index, US 10Y, Fed Funds.
- EIA (US Energy Information Administration) — crude and product inventories, refinery and product series.
- AISStream — live vessel positions and chokepoint activity, when an API key is configured.
- GDELT — global news and event monitoring for crisis, shipping and refinery headlines.
- Esri / GEBCO / NOAA — label-free base map tiles; all place names on the maps come from NetbackBeacon's own bilingual place-name dataset.
Not currently licensed
Assessed spot prices from commercial price reporting agencies, term freight assessments and proprietary LNG indices are not part of the platform today. Any screen that resembles such content is a sample structure.
Licensing and redistribution rights
Below is the licence basis on which each connected provider is used. Where a licence forbids redistribution of raw values, NetbackBeacon shows derived or delayed views only.
- FRED — U.S. federal government data served through the St. Louis Fed API. Rights are set per series: many series are U.S. public-domain data, but some carry the copyright of the original source. Each series is shown with its FRED series ID and observation date; series-level commercial rights have not been legally reviewed (see the rights table below).
- EIA — U.S. Energy Information Administration open data. U.S. government works are public domain; the API requires a registered key and attribution to EIA.
- AISStream — free tier for non-commercial and evaluation use under the provider's terms; positions are displayed live and stored only as aggregated history. Raw AIS feeds are not redistributed or offered for download.
- GDELT — GDELT Project open data, free to use with attribution. Only headline metadata (title, source domain, timestamp, URL) is stored; full article text is never copied.
- Esri — label-free base tiles (World Ocean Base, GEBCO/NOAA bathymetry) are served under Esri tile usage terms and re-coloured client-side; attribution is rendered on every map. Ports, chokepoints, seas and routes are labelled from NetbackBeacon's own English/Turkish place-name dataset.
- Our World in Data — CC BY 4.0; charts and derived series carry the OWID attribution and the source dataset name.
What "Live" means on this platform
NetbackBeacon does not claim real-time or exchange-grade market data. "Live" on a card means the value was pulled from a connected provider on the cadence below, and every card carries its own observation timestamp.
- FRED and EIA benchmarks — refreshed hourly into the canonical store; underlying series are themselves published daily or weekly with the provider's own lag.
- Cockpit and market snapshot tiles — served from the canonical store, so the value shown is at most one refresh cycle old.
- AIS vessel positions — streamed live when a key is configured, with a user-selectable refresh interval (10s / 30s / 60s); when the stream is unavailable the map falls back to the last stored positions and says so.
- News headlines — GDELT queries cached for 5 minutes and served stale for up to 1 hour if the provider is unreachable.
- Historical Replay — archived observations only. Values are never recomputed from live data unless a step is explicitly labelled as a live re-price.
- Freight, scenario and compass outputs — model results computed from the inputs above using documented assumptions, not assessed market rates.
Attribution and terms
Each provider's data remains subject to that provider's own terms of use. NetbackBeacon redistributes derived and aggregated views only, and does not resell, sublicense or provide bulk export of any third-party feed.
If a provider changes its terms in a way that conflicts with the above, the affected module is switched to Sample Data until a compliant path is available.
Details will be published before commercial launch.
Module capability table
| Module | Status | Note |
|---|---|---|
| Market benchmarks | Delayed | FRED and EIA series, refreshed hourly; the providers publish daily or weekly with their own lag. Assessed PRA prices are not licensed. |
| LNG prices | DelayedUnavailable | Monthly FRED proxies (PNGASJPUSDM, PNGASEUUSDM) used in Historical Replay only. JKM and TTF assessments are unavailable. |
| Freight | ModelledSample | No licensed freight assessment (TD3C, Worldscale). Freight values are model or sample inputs. |
| AIS vessel positions | Connected | AISStream when a key is configured; otherwise the last stored snapshot, labelled as such. |
| Geopolitical news | Connected | GDELT headline metadata, cached 5 minutes, served stale for at most 1 hour. |
| Arbitrage signals | ModelledSample | Rule-based opportunity status from sample signal inputs on public pages. |
| Confidence scores | Modelled | Indicative signal agreement score (0–100). Not a probability of success and not back-tested. |
| Historical replay | Delayed | Archived FRED/EIA observations only; never recomputed from live data. |
Data dictionary
Last successful observation is shown on each card with its own timestamp; this table is static documentation.
| Metric | Series / dataset code | Provider | Observation freq. | Publication freq. | Unit | Kind | Revision behaviour | Max data age | Current availability |
|---|---|---|---|---|---|---|---|---|---|
| Brent spot | DCOILBRENTEU | FRED | Daily (business days) | Not documented | USD/bbl | Observed | Not documented | Not documented | Connected (server key) |
| WTI spot | DCOILWTICO | FRED | Daily (business days) | Not documented | USD/bbl | Observed | Not documented | Not documented | Connected (server key) |
| Henry Hub spot | DHHNGSP | FRED | Daily (business days) | Not documented | USD/MMBtu | Observed | Not documented | Not documented | Connected (server key) |
| US diesel retail | GASDESW | FRED | Weekly | Not documented | USD/gal → USD/bbl (×42) | Derived | Not documented | Not documented | Connected (server key) |
| ULSD US Gulf Coast | EER_EPD2DXL0_PF4_RGC_DPG | EIA | Daily (business days) | Not documented | USD/gal → USD/bbl (×42) | Derived | Not documented | Not documented | Connected (server key) |
| ULSD NY Harbor | EER_EPD2DXL0_PF4_Y35NY_DPG | EIA | Daily (business days) | Not documented | USD/gal → USD/bbl (×42) | Derived | Not documented | Not documented | Connected (server key) |
| EU natural gas (proxy) | PNGASEUUSDM | FRED | Monthly | Not documented | USD/MMBtu | Observed | Not documented | Not documented | Historical Replay only |
| Japan LNG (proxy) | PNGASJPUSDM | FRED | Monthly | Not documented | USD/MMBtu | Observed | Not documented | Not documented | Historical Replay only |
| EIA STEO Brent forecast | BREPUUS | EIA | Monthly | Monthly | USD/bbl | Modelled | Revised each STEO release | Not documented | Connected (server key) |
| AIS vessel positions | — | AISStream | Streaming | Streaming | lat/lon, kn | Observed | Not revised | Map snapshot stale after 10 min | Connected when key configured |
| News event signals | DOC 2.0 | GDELT | 15-minute updates | Not documented | headline count | Derived | Not revised | 1 hour (stale fallback) | Connected; may throttle |
| TD3C freight | — | — | Not connected in public preview | Not connected in public preview | WS / USD/t | Modelled | Not connected in public preview | Not connected in public preview | Not connected in public preview |
| JKM / TTF | — | — | Not connected in public preview | Not connected in public preview | USD/MMBtu | Modelled | Not connected in public preview | Not connected in public preview | Not connected in public preview |
Missing-data policy
- Carry-forward: benchmark cards show the last stored observation with its own observation date; it is never relabelled as current.
- Replay range mode carries values forward with no maximum age: weekly US diesel (FRED GASDESW) and daily Brent (FRED DCOILBRENTEU) are aligned per day/week/month bucket, and a bucket without its own value reuses the last earlier one. Replay shows how many points are carried and the source observation date of each series; missing values before the first observation are skipped, never set to zero. A maximum carry-forward period is not applied.
- Stale flag: news is flagged stale once served from cache after a provider failure (up to 1 hour, then shown as unavailable). Map snapshots are flagged stale after 10 minutes.
- Calculation stop: a netback is only shown when every input term is present; otherwise the output is marked Unavailable. No other automatic stop rule is documented.
- Interpolation: not used. Gaps stay gaps.
- Freshness per series: benchmark cards use the series' observation date (not the fetch time); status is Live up to one third of the series stale window, Delayed up to the window, then Stale. The window per series is defined in the metric registry (e.g. 10 days for daily FRED/EIA prices).
- AIS: each position keeps its provider observation time; the snapshot collection time is shown separately and never used as an observation time. A position is current for 10 minutes after its own observation; the overall status is current only when every position is. Collection runs hourly, so data is normally stale between runs. Positions stored without an observation time are shown as Unknown. Zero positions in a stale window are not shown as a current zero.
- Revisions: provider revisions overwrite the stored value on the next refresh; revision history is not kept.
- Awaiting product-owner decision: maximum carry-forward period per series and whether calculations should stop once a series is Stale.
Data usage rights
| Provider | Official terms | Attribution | Commercial use | Use in NetbackBeacon |
|---|---|---|---|---|
| FRED | Terms | Required (FRED and original series source) | Legal review required before commercial use | Benchmark cards, history, replay |
| EIA | Terms | Required (EIA as source) | Legal review required before commercial use | Inventories, product prices, STEO |
| AISStream | Terms | Not documented | Legal review required before commercial use | Live map positions; no raw redistribution |
| GDELT | Terms | Required (GDELT Project) | Legal review required before commercial use | Headline metadata and event signals |
| Esri | Terms | Rendered on every map | Legal review required before commercial use | Label-free base tiles |