Pegeldaten selbst nutzen: offen, kostenlos, aber roh.
Die Wasserstände von über 640 Pegeln an den Bundeswasserstraßen stehen als offene Daten im Netz, ohne Anmeldung und ohne Bedingungen für die Weiterverwendung. Wer sie für eine eigene Auswertung, eine App oder eine Tabellenkalkulation nutzen will, muss aber drei Dinge wissen: wie die Schnittstelle aufgebaut ist, wie weit sie zurückreicht und dass die Zahlen ungeprüfte Rohdaten sind. Dieser Beitrag zeigt die Schnittstelle an Beispielen aus der offiziellen Dokumentation, rechnet einen Abruf am Pegel Bonn durch und erklärt, wo die geprüften Werte stehen.
PEGELONLINE in Kürze
PEGELONLINE ist das gewässerkundliche Informationssystem der Wasserstraßen- und Schifffahrtsverwaltung des Bundes (WSV); betrieben, entwickelt und gehostet wird es vom Informationstechnikzentrum Bund (ITZBund). Es stellt nach Angaben des ITZBund Pegeldaten von über 640 Messstationen an den Bundeswasserstraßen bereit, verzeichnet rund 420 Millionen Zugriffe im Jahr, davon etwa 150 Millionen über die REST-Schnittstelle, und ist für private und kommerzielle Nutzung kostenfrei. Im Normalbetrieb sind es bis zu 10 Zugriffe pro Sekunde, bei Hochwasser bis zu 1.000. Eine Anmeldung oder Autorisierung ist für die Schnittstelle nicht nötig (PEGELONLINE, Dokumentation REST-API).
Wichtig für alle, die selbst rechnen wollen: Die Zeitreihe heißt in der Schnittstelle ausdrücklich „WASSERSTAND ROHDATEN“. Auch die Bundesanstalt für Gewässerkunde (BfG) schreibt zu den Werten aus PEGELONLINE: „Es handelt sich um ungeprüfte Daten.“
Die REST-Schnittstelle: Aufbau und Beispielabfragen
Alle Abfragen beginnen mit der Basisadresse https://pegelonline.wsv.de/webservices/rest-api/v2. Darunter gibt es Ressourcen für Pegel (stations), Gewässer (waters), Zeitreihen eines Pegels (etwa W für den Wasserstand), den aktuellen Messwert (currentmeasurement) und die Messwerte (measurements) in den Formaten JSON, CSV oder als PNG-Grafik. Neben dem Wasserstand nennt die Dokumentation weitere Zeitreihen, etwa WV für Vorhersagen, TRM für Terminwerte sowie F und T für Fahrrinnen- und Tauchtiefen. Einzelne Pegel werden laut Dokumentation über ihre UUID angesprochen, die in der Pegeltabelle steht oder aus stations.json hervorgeht; ein Beispiel der Dokumentation zeigt auch den Pegelnamen im Pfad (stations/KÖLN.json).
Die folgenden Abfragen stammen wörtlich aus der offiziellen Dokumentation:
| Zweck | Abfrage (an die Basisadresse anzuhängen) |
|---|---|
| Alle Pegel bestimmter Gewässer | /stations.json?waters=RHEIN,MAIN |
| Pegel am Rhein im Umkreis eines Flusskilometers | /stations.json?waters=RHEIN&km=680&radius=50 |
| Pegel im Umkreis einer Position (WGS84, Dezimalgrad) | /stations.json?latitude=52.44&longitude=13.57&radius=30 |
| Wasserstand Bonn, letzte 8 Tage | /stations/593647aa-9fea-43ec-a7d6-6476a76ae868/W/measurements.json?start=P8D |
| Ganglinie Bonn als Bild, 20 Tage | /stations/593647aa-9fea-43ec-a7d6-6476a76ae868/W/measurements.png?start=P20D&width=900&height=400 |
| Alle Pegel mit Vorhersage | /stations.json?includeForecastTimeseries=true&hasTimeseries=WV |
Weitere Parameter erweitern die Antwort: includeTimeseries nimmt die Zeitreihen eines Pegels mit, includeCurrentMeasurement den aktuellen Wert und includeCharacteristicValues die gewässerkundlichen Kennwerte wie MNW, MW oder HHW. Zeiträume werden mit start und end angegeben, entweder als ISO-8601-Zeitpunkt oder als ISO-8601-Dauer wie P8D für acht Tage (PEGELONLINE, Dokumentation REST-API).
Durchgerechnet: ein Abruf am Pegel Bonn
Am 7. November 2026 lieferte die Abfrage /stations/BONN/W/currentmeasurement.json diese Antwort:
{
"timestamp": "2026-11-07T18:15:00+01:00",
"value": 81.0,
"stateMnwMhw": "low",
"stateNswHsw": "unknown"
}
Der Wasserstand betrug also 81 cm am Pegel, gemessen um 18:15 Uhr Mitteleuropäischer Zeit; der Zusatz +01:00 ist der Abstand zur koordinierten Weltzeit. Zu einer Höhe über dem Meer wird der Wert erst mit dem Pegelnullpunkt, den die Abfrage mit includeCharacteristicValues=true zusammen mit den Kennwerten liefert: 42,713 m über NHN, gültig seit dem 1. November 2019. Die PEGELONLINE-Hilfe beschreibt die Rechnung: Der Wasserstand ist relativ, für absolute Höhen wird der PNP addiert.
Die beiden Statusfelder ordnen den Wert ein. stateMnwMhw vergleicht ihn mit dem Mittleren Niedrigwasser (MNW) und dem Mittleren Hochwasser (MHW) und kann die Werte low, normal, high, unknown, commented und out-dated annehmen; stateNswHsw bezieht sich auf die Schifffahrtswasserstände NSW und HSW. unknown heißt, dass der Bezugswert fehlt, commented steht für eine Störung, out-dated für einen Wert, der älter als 25 Stunden ist (Dokumentation REST-API). Für Bonn passt beides zu den mitgelieferten Kennwerten:
| Kennwert (PEGELONLINE, Pegel Bonn) | Wert | Bezug |
|---|---|---|
| NNW, Niedrigster Niedrigwasserstand | 81 cm | 22.10.2018 |
| MNW, Mittel der Niedrigwasserstände | 121 cm | 01.11.2010 bis 31.10.2020 |
| GlW, Gleichwertiger Wasserstand | 142 cm | gültig ab 01.01.2023 |
| MW, Mittel der Tageswasserstände | 290 cm | 01.11.2010 bis 31.10.2020 |
| MHW, Mittel der Hochwasserstände | 680 cm | 01.11.2010 bis 31.10.2020 |
| HHW, Höchster Hochwasserstand | 1.013 cm | 23.12.1993 |
81 cm liegen unter dem MNW von 121 cm, deshalb low. Einen HSW führt PEGELONLINE für Bonn in dieser Liste nicht, deshalb unknown beim zweiten Feld. Und der Wert entspricht genau dem niedrigsten in den Kennwerten geführten Wasserstand von 2018.
Das HHW der PEGELONLINE-Kennwerte ist nicht in jedem Fall der höchste je beobachtete Wasserstand: Das Gewässerkundliche Jahrbuch führt für Bonn in seiner Extremwertliste ab 1880 mit 1.020 cm vom 28. November 1882 einen höheren Wert, die 1.013 cm von 1993 stehen dort auf Platz zwei (mehr im Beitrag Historische Hochwasser).
Takt, Rückschau und Zeitzone
Die Zeitreihe des Pegels Bonn meldet "equidistance": 15, also Werte im Abstand von 15 Minuten. Das passt zur PEGELONLINE-Hilfe: „Im Binnenbereich wird das Gros der Pegel alle 15 Minuten aktualisiert“, an der Küste sind die Werte in der Regel nicht älter als 5 Minuten. Die Messwerte über die Schnittstelle reichen 31 Tage zurück; ohne Angabe eines Zeitraums liefert die Schnittstelle 10 Tage (Dokumentation REST-API). Der Test bestätigt das: Eine Abfrage mit start=P40D lieferte am 7. November 2026 nicht 40, sondern knapp 32 Tage, 3.049 Werte ab dem 7. Oktober 2026, 01:15 Uhr. Das ITZBund selbst spricht von Daten „bis zu 30 Tage rückwirkend“; maßgeblich für die Schnittstelle ist die Angabe der Dokumentation.
Alle Zeitangaben beziehen sich auf die gesetzliche Zeit, also MEZ oder MESZ. In JSON steht der Abstand zur Weltzeit dabei, in CSV fehlt die Zeitzone (Dokumentation REST-API). Wer Werte über die Zeitumstellung hinweg auswertet, sollte deshalb JSON nehmen oder die Zeitzone selbst nachtragen. Die Dokumentation empfiehlt außerdem, Antworten im eigenen Programm zwischenzuspeichern und bedingte Abfragen mit ETag und If-None-Match zu verwenden; bei unveränderten Daten antwortet der Server dann mit dem Status 304. Bei Binnenpegeln im 15-Minuten-Takt bringt eine häufigere Abfrage keine zusätzlichen Messwerte.
Historische Daten: der Download seit 2000
Für längere Zeiträume ist nicht die Schnittstelle gedacht, sondern der Rohdaten-Download auf der Website. Wasserstände und Abflüsse stehen dort in der Regel ab dem 1. Januar 2000 zur Verfügung, andere Größen wie Wasser- oder Lufttemperatur nur für die letzten 31 Tage. Den Download gibt es an drei Stellen: auf der Stammdatenseite eines Pegels in der Tabelle „Messwertgeber am Pegel“ in der Spalte „Download Rohdaten“, in der Pegelauswahl-Tabelle für bis zu zehn Pegel gleichzeitig als ZIP-Datei und in der Ganglinienansicht über den Knopf „Download“ (PEGELONLINE, Hilfe).
| Format | Eigenschaften laut PEGELONLINE-Hilfe |
|---|---|
| JSON | für Programme; Zeitstempel nach ISO 8601 mit Zeitzone, Dezimalpunkt; gesetzliche Zeit |
| CSV | Excel-kompatibel, Semikolon als Trenner, Dezimalkomma; gesetzliche Zeit |
| ZRXP | Austauschformat für Zeitreihen; Zeitstempel YYYYMMDDhhmmss ganzjährig in MEZ ohne Sommerzeit, Dezimalpunkt, Zeichensatz ISO-8859-1, Fehlwerte als -777.0 |
Auch die heruntergeladenen Daten sind „ungeprüfte Rohdaten“: „Diese Messwerte wurden noch nicht validiert und können Ausreißer, Messfehler oder andere Unregelmäßigkeiten enthalten“ (PEGELONLINE, Hilfe). Wer über Jahre auswertet, sollte deshalb wissen, was der Unterschied zu geprüften Daten ist.
Rohdaten und geprüfte Daten
Das Pegelhandbuch der LAWA definiert den Begriff knapp: „Messwerte, die unmittelbar von dem Pegel übertragen, aus- oder abgelesen werden, sind ungeprüft und werden als Roh- oder Ursprungsdaten bezeichnet“ (LAWA 2018, A.4.2). Danach beginnt die Prüfung. Fernübertragene Werte werden arbeitstäglich auf Vollständigkeit kontrolliert und auf Plausibilität geprüft, etwa gegen zwei Grenzwerte und gegen eine größte zulässige Differenz zwischen zwei aufeinanderfolgenden Werten. In einem zweiten Schritt werden Ganglinien auf Ausreißer und Lücken untersucht, redundante Sensoren miteinander und mit den Ablesungen an der Pegellatte verglichen; Lücken können geschlossen und Werte korrigiert werden, wenn genug Informationen vorliegen (LAWA 2018, C.2). Von redundant ausgestatteten Messstellen werden alle Rohdatenreihen und eine geprüfte Reihe langfristig aufbewahrt (LAWA 2018, A.4.2).
Wie nötig das ist, zeigen zwei Beispiele aus den Abrufen für diese Reihe:
- In den Abflussrohdaten des Moselpegels Cochem folgten am 13. Oktober 2026 auf 64,3 m³/s um 9:45 Uhr die Werte −490 m³/s um 10:00 Uhr und 113 m³/s um 10:15 Uhr, danach wieder 65,3 m³/s. Solche Sprünge zwischen zwei Viertelstunden sind genau das, wonach die Plausibilitätsprüfung mit einer größten zulässigen Differenz sucht.
- Am Pegel Bonn zeigen die Rohdaten im abgerufenen Zeitraum vom 7. Oktober bis 7. November 2026 einen Tiefstwert von 60 cm am 7. Oktober (das tiefste Tagesmittel des Jahres lag schon am 28. September, siehe Niedrigwasser 2018, 2022 und 2026), an 1.619 der 3.049 abgerufenen Viertelstunden lag der Wasserstand unter 81 cm. Das Jahrbuch führt für Bonn als niedrigste Wasserstände seit 1880 unter anderem 67 cm am 16. Februar 1929, damals bei Eisgang (siehe Eisgang und Eisstau), und 81 cm im Oktober 2018. Ob die Werte von 2026 so stehen bleiben, entscheidet erst die Prüfung; als amtlicher Kennwert stehen sie bisher nirgends. Eine eigene Gegenprobe spricht für die Werte: Die Nachbarpegel zeigten zur selben Zeit ebenfalls Stände unter ihrem bisherigen NNW, und der Verlauf hat keine Sprünge. Amtlich geprüft ist der Wert damit trotzdem noch nicht.
Geprüfte Werte veröffentlicht das Deutsche Gewässerkundliche Jahrbuch (DGJ). Nach der BfG finden sich dort „die verifizierten Daten und wichtige daraus abgeleitete statistische Kennwerte“; das DGJ umfasst rund 1.100 Pegel, für 190 davon liefert die WSV die Daten. Die Seiten der Bundespegel stellt die BfG auf ihrem Server dgj-daten.bafg.de als PDF bereit, geordnet nach Flussgebieten. Die Jahrbuchseite des Pegels Bonn für 2025 enthält Tageswerte, Hauptwerte für das Abflussjahr, das vom 1. November des Vorjahres bis zum 31. Oktober reicht, Zehnjahreswerte, eine Dauertabelle und die Extremwerte seit 1880. Sie trägt den Stand 4. August 2026, die des Moselpegels Trier den Stand 20. August 2026. Zwischen dem Ende eines Abflussjahres und den geprüften Werten liegen also viele Monate. Die BfG hält Rohdaten und geprüfte Daten gemeinsam in der Datenbank WISKI7 von WSV und BfG; Tageswerte reichen dort bis 1727 zurück, 15-Minuten-Werte bis in die 1980er Jahre (BfG, Hydrologie).
Ein Detail am Rand: Die Jahrbuchseiten geben den Pegelnullpunkt im Höhensystem DHHN2016 an, für Bonn +42,71 m; PEGELONLINE nennt 42,713 m über NHN. Mehr zu Pegelnullpunkt und Höhensystem steht im Beitrag über Pegelnullpunkt und Wasserstand.
Die Lizenz: Datenlizenz Deutschland Zero
Nach den Nutzungsbedingungen von PEGELONLINE (Stand 21. Mai 2024) erfolgt die Bereitstellung „auf der Grundlage der Lizenz DL-DE->Zero-2.0“. Die Daten und Metadaten dürfen für kommerzielle und nicht kommerzielle Zwecke insbesondere vervielfältigt, bearbeitet, mit eigenen Daten verknüpft und in Anwendungen eingebunden werden. Der Lizenztext der Datenlizenz Deutschland Zero 2.0 auf GovData fasst es in einem Satz: „Jede Nutzung ist ohne Einschränkungen oder Bedingungen zulässig.“ Anders als bei der Variante „Namensnennung“ besteht keine Pflicht zur Quellenangabe. Eine Quellenangabe ist trotzdem guter Stil, schon damit Leser wissen, dass es Rohdaten sind.
Zwei weitere Punkte stehen in den Nutzungsbedingungen: ITZBund und GDWS übernehmen keine Haftung und Gewährleistung für die inhaltliche Richtigkeit, und für jeden Datendownload werden Informationen in einer Protokolldatei gespeichert. Wer auf Pegeldaten Entscheidungen stützt, etwa für die Abladetiefe eines Schiffs, trägt die Verantwortung für die Auswertung also selbst.
Landespegel: andere Portale, andere Regeln
PEGELONLINE enthält die Pegel an den Bundeswasserstraßen. Viele weitere Pegel betreiben die Länder, in Nordrhein-Westfalen etwa das Landesamt ein eigenes Pegelmessnetz (MUNV NRW 2024), und sie veröffentlichen die Daten in eigenen Portalen, mit eigenen Formaten, Zeiträumen und Lizenzen. Ein Beispiel ist der Gewässerkundliche Dienst Bayern: Er bietet Messdaten im CSV-Format kostenlos zum Herunterladen an (LfU Bayern), auf der Downloadseite eines Pegels mit dem Hinweis „This data is licensed under a Creative Commons Attribution 4.0 International License“, also mit Pflicht zur Namensnennung, und im Zeichensatz ISO-8859-1. Die Lizenz unterscheidet sich damit von der des Bundes. Wer Bundes- und Landespegel in einer Auswertung zusammenführt, muss die Bedingungen jeder Quelle einzeln prüfen und einhalten.
Einen gemeinsamen Einstieg bietet das Länderübergreifende Hochwasserportal (LHP) unter hochwasserzentralen.de, in dem jedes Land laufend Daten einer Auswahl von Hochwassermeldepegeln bereitstellt (Umweltbundesamt). Eine öffentlich dokumentierte gemeinsame Schnittstelle für alle Landespegel, vergleichbar mit der REST-Schnittstelle von PEGELONLINE, wurde für diesen Beitrag nicht gefunden.
Kurz zusammengefasst für die eigene Auswertung
- Für aktuelle Werte und die letzten 31 Tage die REST-Schnittstelle nutzen, für längere Reihen ab 2000 den Rohdaten-Download.
- Wasserstand und Pegelnullpunkt zusammen speichern, und auf das Gültigkeitsdatum des Pegelnullpunkts achten.
- JSON mit Zeitzone verwenden oder bei CSV die gesetzliche Zeit berücksichtigen; ZRXP ist ganzjährig MEZ.
- Rohdaten vor der Auswertung auf Ausreißer, Lücken und Fehlwerte prüfen. Für Statistik, Hauptwerte und Jährlichkeiten die geprüften Jahrbuchwerte nehmen.
- Lizenz je Quelle prüfen: PEGELONLINE ohne Bedingungen, Landesportale teils mit Namensnennung.
- Schonend abfragen: zwischenspeichern, bedingte Abfragen nutzen, nicht öfter als der Messtakt.
So zeigt es Pegelradar
Pegelradar ist selbst ein Beispiel für die Nutzung dieser Daten. Die Bundespegel lädt der Browser direkt bei PEGELONLINE über die REST-Schnittstelle und lädt sie alle 15 Minuten neu; davon getrennt ruft der Server pegel.lischwe.de sie alle 30 Minuten ab, als Vergleichswert für den Trendpfeil (siehe Messgeräte am Pegel). Landespegel, Hochwasserwarnungen und weitere Dienste kommen über einen eigenen Dienst unter pegel.lischwe.de, der die Landesportale abfragt. Die Datenquellen-Übersicht der App nennt die Lizenz der PEGELONLINE-Daten (dl-de/zero-2-0) und weist darauf hin, dass es sich um ungeprüfte Rohdaten handelt und geprüfte Werte erst die Gewässerkundlichen Jahrbücher veröffentlichen. Für 161 Pegel verlinkt die Detailansicht direkt das Jahrbuch-PDF des Pegels auf dgj-daten.bafg.de, für die übrigen allgemein dgj.de.
Weil PEGELONLINE Messwerte nur für rund einen Monat herausgibt, speichert Pegelradar seit dem 6. November 2026 selbst Stundenwerte aller Bundespegel, rückwirkend ab Oktober 2026, und behält die gesammelten Landespegel-Werte ohne Löschfrist. Darauf beruhen die Ansichten „1 Jahr“ und „Gesamt“ in den Ganglinien; sie werden mit jedem Tag länger. Diese Reihen sind ebenfalls Rohdaten, und Stundenwerte sind gröber als die 15-Minuten-Werte der Quelle. Einen Export der Messwerte bietet Pegelradar nicht an, nur die Favoritenliste lässt sich als Datei sichern; wer Daten weiterverarbeiten will, nutzt am besten direkt die amtlichen Quellen.
Quellen
- PEGELONLINE: Dokumentation der REST-API v2. https://pegelonline.wsv.de/webservice/dokuRestapi
- PEGELONLINE: Hilfe und Erläuterungen (Aktualisierung, Download, Formate, Zeitzonen, Pegelnullpunkt). https://pegelonline.wsv.de/gast/hilfe
- PEGELONLINE: Nutzungsbedingungen, Stand 21.05.2024. https://pegelonline.wsv.de/gast/nutzungsbedingungen
- GovData: Datenlizenz Deutschland, Zero, Version 2.0. https://www.govdata.de/dl-de/zero-2-0
- ITZBund: PEGELONLINE, Gewässerkundliches Informationssystem der WSV. https://itzbund.de/DE/itloesungen/fachverfahren/pegelonline/pegelonline_node.html
- PEGELONLINE (WSV), REST-API v2: eigene Abrufe für Bonn (currentmeasurement, Kennwerte, Messwerte P31D und P40D, CSV, PNG) sowie Cochem (Abfluss P30D), 07.11.2026. https://pegelonline.wsv.de/webservices/rest-api/v2/
- LAWA: Leitfaden zur Hydrometrie des Bundes und der Länder, Pegelhandbuch, 5. Auflage, Stuttgart 2018, Abschnitte A.4.2 und C.2. https://lawa.de/documents/02_anhang_2_lawa_pegelhandbuch_2_1552299134.pdf
- Bundesanstalt für Gewässerkunde: Hydrologie (DGJ, WISKI7). https://www.bafg.de/DE/3_Beraet/2_Exp_quantitaet/Hydrologie_M1/hydrologie_node.html
- Bundesanstalt für Gewässerkunde: Wasserstände (Hinweis auf ungeprüfte Daten). https://www.bafg.de/DE/5_Informiert/1_Portale_Dienste/Wasserstaende/wasserstaende_node.html
- Deutsches Gewässerkundliches Jahrbuch, Seiten der Bundespegel: Bonn/Rhein (2710080), Jahr 2025, Stand 04.08.2026, und Trier UP/Mosel (26500100), Stand 20.08.2026. https://dgj-daten.bafg.de/Rhein/Bonn/2710080_W.pdf, https://dgj-daten.bafg.de/Rhein/Trier/26500100_WQ.pdf
- Bayerisches Landesamt für Umwelt: Bereitstellung von Pegeldaten. https://www.lfu.bayern.de/wasser/wasserstand_abfluss/bereitstellung_pegeldaten/index.htm
- Gewässerkundlicher Dienst Bayern: Downloadseite eines Pegels mit Lizenzhinweis CC BY 4.0 (Beispiel Hammerles). https://gkd.bayern.de/en/rivers/discharge/bayern/hammerles-14198309/download
- Ministerium für Umwelt, Naturschutz und Verkehr NRW: Hochwasserlage zum Jahreswechsel 2023/2024, Vorlage 18/2121, 12.01.2024. https://www.landtag.nrw.de/portal/WWW/dokumentenarchiv/Dokument/MMV18-2121.pdf
- Umweltbundesamt: Hochwasserwarnung (Länderübergreifendes Hochwasserportal), Stand 10.08.2022. https://www.umweltbundesamt.de/themen/wasser/extremereignisseklimawandel/hochwasser/hochwasserwarnung