gas-risiko.deDatenzugang & API
Status
Für Analysten & Entwickler

Europäische Gasspeicherdaten — direkt in Ihren Workflow

gas-risiko.de veröffentlicht strukturierte, maschinenlesbare JSON-Daten: tägliche Füllstände, 14-Tage-ARIMAX-Prognosen mit vollständigen Quantilbändern, 365-Tage-Saisonausblicke, grenzüberschreitende Flow-Z-Scores und Füllstand-Stress-Szenarien — täglich morgens aus Primärquellen aktualisiert.

Zugang anfragen →Methodik →Status →OpenAPI →
Aktueller Datenstatus

Alle Datensätze zeigen die Aktualität relativ zum JSON-Build-Zeitstempel. Die Produktions-Pipeline läuft zweimal täglich nach Europe/Berlin (ca. 06:00 morgens und ca. 23:45 nach der AGSI+-Abendveröffentlichung) aus AGSI+, ENTSO-G, Open-Meteo, SMARD und TTF. Ein GitHub-Actions-Backup kann um ca. 00:30 UTC laufen. Orange kann bedeuten, dass eine Primärquelle noch als verzögert gilt — nicht zwingend, dass der Export alt ist.

Zugangsstufen

Zwei Stufen, eine klare Grenze

Stufe 0Der BeobachterKostenlos

Vollständiges öffentliches Dashboard für alle 7 Länder. Best-Effort-Daten, kein Konto erforderlich.

Alle 7 Länder — DE · IT · NL · AT · FR · CZ · PL
14-Tage-Prognose, Korridor-Stress, Auffüll-Stress
Jahresausblick mit voreingestellten Szenarien (Lesezugriff)
Offene Daten-API (/api/*) — kein Schlüssel nötig, ETag-Caching, faires IP-Limit
Best-Effort-Aktualität — AGSI+-Quellverzögerung von 2–3 Tagen gilt; kein SLA, kein vertragliches Kontingent
Stufe 1Der unabhängige Analyst
€99/Mo.Gründerpreis · Listenpreis 149–249 €/Mo.

Authentifizierte API-Integration für Analysten, Berater und unabhängige Forschende. Gründerpreis für frühe Abonnenten.

Alles aus Stufe 0
Authentifizierte /api/v1/* — übermitteln Sie Ihren Schlüssel im Api-Key-Request-Header; Antworten enthalten RateLimit-Limit/Remaining/Reset
500 API-Aufrufe/Tag · 60 Anfragen/Minute
Alle 7 Länder auf /api/v1/*
Jahres-Szenariolabor — voreingestellte Bibliothek + eigene Regler
E-Mail-Support — info@mh-analytics.eu
Kein formales SLA im Early Access (Best-Effort, Ziel: nächster Werktag)
Registrierung pausiertAnmelden

Höhere Stufen (The Strategic Hub · The Enterprise Grid) mit Forecast-Vintages / As-of-API, PDF-Berichten, Webhook-Alerts und rohen Monte-Carlo-Pfaden befinden sich in Entwicklung. Frühzeitiges Interesse: info@mh-analytics.eu.

Verfügbare Datensätze

Fünf strukturierte Datenfeeds

14-Tage-Prognose
/api/data?country=DE
Aktualisierung
2× täglich ~06:00 & ~23:45 Berlin
Max. Verzögerung
< 26 Std.
fill_level_pctstorage_pct_rankrequired_injection_rate_ppdayP10/P25/P50/P75/P90p_alarmsource_statusseasonal_profilestorage_type_breakdowncoefficientsdiagnostics
Jahresausblick (365 Tage)
/api/annual?country=DE
Aktualisierung
2× täglich ~06:00 & ~23:45 Berlin
Max. Verzögerung
< 36 Std.
baseline p10/p50/p90standardised scenarioswinter_minimum (OLS)p_breach_15pctood_boundsscenario_translation_metaess_paths
Szenariobibliothek
/api/scenarios?country=DE
Aktualisierung
2× täglich mit Jahresausblick
Max. Verzögerung
< 36 Std.
category / severityparametersdelta_winter_min_ppdelta_se_at_winter_mincorridor_metadatascenario_translation_meta
Gasfluss-Korridore
/api/network?country=DE
Aktualisierung
2× täglich ~06:00 & ~23:45 Berlin
Max. Verzögerung
< 26 Std.
flow_gwhcapacity_gwhutilization_pcttrailing_30d_meanzscore_30dis_lngstress_flag
Füllstand-Stress-Szenarien
/api/refill-stress?country=DE
Aktualisierung
2× täglich ~06:00 & ~23:45 Berlin
Max. Verzögerung
< 48 Std.
sensitivity_gridcritical_boundaryoct31_fill_pcttarget_shortfall_twhdays_below_15seasonal_rates
Abgedeckte Länder: DE · NL · FR · IT · AT · CZ · PL — ?country=XX an alle Endpunkte übergeben.
Beispiel-Response

Reale Payload-Struktur

Alle Responses sind versioniertes JSON mit einem contract_version- oder endpoint-spezifischen Contract-Version-Feld. Quantile sind immer monoton; NaN-Werte werden als null serialisiert.

GET /api/data?country=DE (excerpt)
{
  "contract_version": "1.0",
  "generated_at": "2026-04-26T04:07:33.912Z",
  "latest": {
    "date": "2026-04-24",
    "fill_level_pct": 37.42,
    "gas_in_storage_twh": 182.1,
    "storage_pct_rank": 31.4,
    "required_injection_rate_ppday": 0.284,
    "d_current": 0.91
  },
  "predictions": [
    { "date": "2026-04-25", "P10": 36.8, "P50": 37.6, "P90": 38.4 },
    { "date": "2026-04-26", "P10": 36.2, "P50": 37.1, "P90": 38.0 }
  ],
  "seasonal_profile": {
    "120": { "p10": 44.8, "p50": 56.1, "p90": 66.8 }
  },
  "storage_type_breakdown": {
    "country": "DE",
    "cavern_fraction": 0.49,
    "pore_fraction": 0.51
  },
  "source_status": {
    "agsi": { "stale": false, "last_date": "2026-04-24", "fetched_at": "2026-04-26T03:55Z" },
    "ttf":  { "stale": false, "last_date": "2026-04-25", "fetched_at": "2026-04-26T04:01Z" }
  }
}
Anwendungsfälle

Wer diese Daten nutzt

Gas- & Stromhandel
Historischen Perzentil-Rang verfolgen, benötigte Einspeisung vs. aktuelle Tagesänderung überwachen und Korridor-Z-Score-Anomalien vor Preisbewegungen erfassen.
Energie-Risikomanagement
P10/P50/P90-Jahresprognosen und Winter-Minimum-OLS-Prognosen nutzen, um Portfolios zu testen und VAR-Modelle gegen physische Speicherbeschränkungen zu validieren.
Strukturierte Produkte & Derivate
Die p_breach_15pct-Wahrscheinlichkeit und Korridor-Stress-Flags liefern unabhängige physische Referenzpunkte für Optionspreise und Winter-Lieferverträge.
Wissenschaft & Politikforschung
Strukturierte historische Füllstandsreihen mit Quellen-Metadaten, Modelldiagnostik (Ljung-Box, VIF, HAC-Standardfehler) und vollständiger Methodikdokumentation.
Versorger & Netzbetreiber
Tägliche Einspeisung-Gap (pp/Tag bis 90%-Ziel 31. Okt.) und Korridor-Auslastungsquoten integrieren direkt in Einsatzplanung und Bilanzierungstools.
Input für quantitative Modelle
JSON-Payloads sind versioniert und schema-validiert in CI. Direkt an LLMs, Zeitreihenmodelle oder Szenario-Engines übergeben — ohne manuelle Datenbereinigung.
Wissenschaftliche Standards

Rigoros, sachlich, transparent

ARIMAX mit HAC-Fehlern
Länderspezifische ARIMAX-Modelle mit Newey-West HAC-Standardfehlern. Alle Diagnosen in der API-Response.
Konformale Kalibrierung
Prognosebänder werden mit rollierender konformaler Prognose (κ-Multiplikator) auf 80% Coverage kalibriert. Coverage-Status je Land verfügbar.
Saisonaler Block-Bootstrap
365-Tage-Jahresausblick nutzt saisonal gewichteten Pfad-Ensemble (kein Point-Forecast). ESS zeigt, wie viele Historikjahre dominieren.
OOD-Erkennung
Szenario-Parameter außerhalb ±3σ der Trainingsdaten werden mit ood_flag markiert — damit klar ist, wann extrapoliert wird.
Vertrauen & Compliance

Praktische Informationen für die Beschaffung

Infrastruktur
Betrieben bei Hetzner Online GmbH (ISO 27001 zertifiziert). Automatisierte tägliche Pipeline mit GitHub-Actions-Backup. JSON-Daten zusätzlich auf GitHub gespiegelt.
Auftragsverarbeitungsvertrag
Ein DSGVO-konformer Auftragsverarbeitungsvertrag (AVV gem. Art. 28 DSGVO) ist auf Anfrage für institutionelle Integrationen verfügbar. Kontakt: info@mh-analytics.eu.
Open-Source-Auditierbarkeit
Pipeline, Modellcode und Schema-Definitionen sind auf GitHub unter MIT-Lizenz veröffentlicht — für unabhängige Überprüfung von Datenprovenienz, Modellannahmen und Reproduzierbarkeit.
MSA & Datenlizenz
Der Quellcode steht unter MIT-Lizenz. Die kommerzielle Nutzung der API-Ausgabe (Einbettung in kostenpflichtige Produkte, Weiterverteilung) erfordert eine separate Datenlizenz. Kontakt: info@mh-analytics.eu.
Rechtsdokumente

Vertragsvorlagen für die Beschaffung

SLA-Vorlage
Datenlizenz-/MSA-Vorlage
DPA-/AVV-Vorlage
Security-Statement
OpenAPI 3.1

Maschinenlesbarer API-Vertrag

Die vollständige OpenAPI 3.1 Spezifikation deckt öffentliche Endpunkte und authentifizierte /api/v1 Routen, Request-Parameter, Response-Schemas, Beispiele, Fehlermodelle, Cache/ETag-Semantik und RateLimit-Header ab. Zum Generieren von Client-Stubs, für Integrationstests oder Swagger UI.

OpenAPI-Spec ansehen →In Swagger UI öffnen →
Integrationsbeispiele
curl — 14-day forecast, Germany
curl -s "https://gas-risiko.de/api/data?country=DE" \
  -H "Accept: application/json" | jq '.latest,.predictions[:2]'
curl — conditional GET (ETag / 304)
ETAG=$(curl -sI "https://gas-risiko.de/api/data?country=DE" | grep -i etag | awk '{print $2}' | tr -d '\r')
curl -sv "https://gas-risiko.de/api/data?country=DE" -H "If-None-Match: $ETAG"
curl — authenticated API v1 with quota headers
curl -i "https://gas-risiko.de/api/v1/data?country=DE" \
  -H "Accept: application/json" \
  -H "Api-Key: $GAS_RISIKO_API_KEY"
curl — scenario catalogue, Germany
curl -s "https://gas-risiko.de/api/scenarios?country=DE" \
  -H "Accept: application/json" \
  | jq '.scenarios[] | {id:.scenario_id,category,delta:.delta_winter_min_pp}'
Python — poll for new data using ETag
import requests, json

BASE = "https://gas-risiko.de"
etag = None

def fetch_if_changed(country: str = "DE") -> dict | None:
    global etag
    headers = {"If-None-Match": etag} if etag else {}
    r = requests.get(f"{BASE}/api/data", params={"country": country}, headers=headers)
    if r.status_code == 304:
        return None  # data unchanged
    r.raise_for_status()
    etag = r.headers.get("ETag")
    return r.json()

data = fetch_if_changed("DE")
if data:
    latest = data["latest"]
    print(f"Fill: {latest['fill_level_pct']:.1f}%  "
          f"P50 d+1: {data['predictions'][0]['P50']:.1f}%")
Python — annual winter-minimum risk for all 7 countries
import requests

COUNTRIES = ["DE", "NL", "FR", "IT", "AT", "CZ", "PL"]
BASE = "https://gas-risiko.de"

risks = {}
for c in COUNTRIES:
    r = requests.get(f"{BASE}/api/annual", params={"country": c})
    r.raise_for_status()
    d = r.json()
    risks[c] = {
        "winter_min_p50": d["baseline"]["winter_minimum"]["p50"],
        "p_breach_15pct":  d["baseline"]["p_breach_15pct_any_winter"],
        "ood_bounds": d.get("ood_bounds", {}),
    }

for c, v in sorted(risks.items(), key=lambda x: x[1]["p_breach_15pct"], reverse=True):
    print(f"{c}  winter-min P50={v['winter_min_p50']:.1f}%  "
          f"P(breach 15%)={v['p_breach_15pct']:.0%}")

gas-risiko.de-Daten in Ihren Stack integrieren

Schreiben Sie uns für Datenlizenzierung, Update-SLAs, länderspezifische Erweiterungen, White-Label-Deployment oder Integrations-Support.

info@mh-analytics.eu →

Daten werden täglich aus öffentlichen Primärquellen aktualisiert (AGSI+, ENTSO-G, Open-Meteo, SMARD, TTF). Diese Website stellt keine Finanzberatung dar. Prognosen enthalten explizite Unsicherheiten — prüfen Sie immer Diagnosen und Intervallabdeckung vor dem produktiven Einsatz.