HELPERG Data · Developers and infrastructure
HELPERG Data
The infrastructure behind HELPERG's data products: a public JSON API that needs no credential, the official providers and licences it reads, whether each domain is operational, and how to integrate — for the economic calendar, published statistical values, official release notices and weather.
Developer documentationOpenAPI documentSources and licences
- Official sources only
- No credential for the public API
- Attribution on every record
- No forecast, consensus or rating
Economic data
Official-source economic data currently available through HELPERG.
- Economic calendar
- Scheduled official releases with the status the publisher states, verified values where published, and an official source on every row.
- Releases
- Published statistical values with unit, reference period, publication status, the previous period and the revision history.
- Economic news
- The publishers' own release notices, decisions and statements, linked to the calendar events and series they concern.
Is the data service operational?
Read from the public status route when this page loads: one of four honest words per data domain, when each last received data, and whether the corpus is held in durable storage. Unknown is reported as unknown.
Status is unavailable.
The status could not be read. Treat the data surface as unverified until the status page answers.
The developer surfaces
What the platform reads, whether it is operational, and how to call it. Each of these is also a JSON endpoint.
Sources and licences
Every official provider, the datasets taken from it, what HELPERG changes, and the attribution each licence requires.API status
Whether each data domain is operational, when it last received data, and whether the corpus is durable.Developer docs
The public API: endpoints, record shapes, decimal semantics, errors, rate limits and attribution obligations.The products these endpoints serve
- Economic calendar
- Scheduled official releases with the status the publisher states, verified values where published, and an official source on every row.
- Releases
- Published statistical values with unit, reference period, publication status, the previous period and the revision history.
- Economic news
- The publishers' own release notices, decisions and statements, linked to the calendar events and series they concern.
- Weather
- Current conditions and the weather forecast for a place, with the provider's own update time and attribution.
Official providers and what is registered
Counts are derived from the platform's own registries at build time. Whether a series has published values on this deployment is stated per record by the API, never assumed here.
Two ways in, deliberately different
- Public access — no credential
- The pages on this site and the JSON endpoints under
/api/public/v1/. Bounded windows and page sizes, shared-cacheable responses, explicit public record shapes, and every value with its source and licence. Meant for reading, for citing, and for server-side integration without an account. - Consumer access — credentialed
- The endpoints under
/api/v1/serve HELPERG's own ecosystem products with a credential and a scope, wider windows, full canonical records and revision histories. They are not opened by anything on this site, and no page here carries a credential.
Provenance and reliability
- Authoritative sources only. Data is taken from the organisation that originates it — a statistical agency, a central bank, a meteorological institute — never from an aggregator, and commercial calendars are not consulted.
- Validation at the boundary. Every provider payload is checked against a schema of that provider's shape before anything is read from it. What does not fit is quarantined, not guessed.
- One truth model. A scheduled event, a published value, and a revision are three different records. A scheduled time that has passed never becomes a publication; a value is published only when an observation has been verified; a revision keeps the vintage it replaced.
- Provenance on every record. Source, source URL, when HELPERG retrieved it, what the source said about its own change, and the licence it travels under. Where an official interface publishes the inputs and not the headline figure, HELPERG computes the figure the agency itself prints, in exact decimal arithmetic, and says so on the record with the inputs and the arithmetic.
- Freshness stated, never hidden. Responses say whether the corpus is fresh, stale or unavailable, and the status page reports each domain in four honest words: ok, degraded, unavailable, unknown.
What this platform does not do
It publishes no forecast, consensus or estimate of any kind and rates nothing: HELPERG holds no survey of forecasters, and every value shown is either the publisher's own figure or a figure computed from the publisher's own inputs and marked as such. It does not scrape publishers, reproduce copyrighted articles, or redistribute data whose terms do not permit it. It does not fill a gap with an estimate: a value that has not been published is recorded as absent, and a value served from cache is served with its real age attached.