open-mastr
A package that provides an interface for downloading and processing the Marktstammdatenregister (MaStR)
General |
|
Publication |
|
Data Publication |
|
Software Archive |
|
Development |
|
Community |
|
Introduction
The Python package open-mastr provides an interface for accessing the Marktstammdatenregister (MaStR) data. The MaStR is a German register provided by the German Federal Network Agency (Bundesnetzagentur / BNetza) that keeps track of all power and gas units located in Germany. It is a daily growing dataset with millions of data points covering electricity and gas production units, electricity and gas consumers, storages, grids, and energy market participants.
Generally, and besides the offerings of open-mastr, the MaStR data can be accessed via three main options:
browse, filter and download in the browser
download daily provided dumps
access via the web service
These access options, however, are not exactly frictionless. open-mastr thus provides an improved developer experience for accessing the data. This project is intended for individuals who wish to “just work” with the MaStR data and who do not want to deal with the idiosyncrasies of the three access options above.
In particular, open-mastr facilitates access to the daily provided MaStR dumps with download methods (bulk) and by parsing the XML files to a relational database. Furthermore, the software provides a Python wrapper to access the MaStR SOAP web service (API).
Does open-mastr edit or change the MaStR data? No. open-mastr is a wrapper around the MaStR data and does not edit or change the data. It is intended to be used as a tool for working with the MaStR data.
Benefits provided by open-mastr
Benefit |
Description |
|---|---|
Data download and parsing |
Download, decode, and write data to a local database |
Translation to English |
Translate table names and columns from German to English as well as an English documentation page of the dataset |
Speed and parallelization |
Download and parse tables in seconds, not minutes |
Data processing |
Merge relevant information about different technologies to single csv files |
Just here for the data? We regularly run the whole download and cleansing pipeline and upload the dataset as csv files at zenodo!
Documentation
Installation
PyPI
Install the current release of open-mastr with pip:
pip install open-mastrGitHub
For development, clone this repository manually.
git clone git@github.com:OpenEnergyPlatform/open-MaStR.git
cd open-MaStRInstall the package with
pip install -e .[dev]Examples of Usage
These projects already use open-mastr:
If you want to see your project in this list, write an Issue or add changes in a Pull Request.
External Resources
Besides open-mastr, some other resources exist that ease the process of working with the Marktstammdatenregister:
The bundesAPI/Marktstammdaten-API is another implementation to access data via an official API.
Collaboration
License and Citation
Software
Data
3 maintainers
Metadata
3 maintainers
Release files for open-mastr 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| open_mastr-1.0.0.tar.gz | 1.4 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| open_mastr-1.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.6 MB
Release files / open_mastr-1.0.0.tar.gz
| Download URL | open_mastr-1.0.0.tar.gz |
|---|---|
| Size | 1.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a6294fa55db05fff82629f357142b0aac1791d05027ff3ae9e6b2ca8ebde98ac
|
|
BLAKE2b-256 checksum How to use checksums |
9fb6c86a00b1b8f90b72d79677ddaadf47560fbdc22876fc3942ea6c38814679
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 24, 2026.
Transparency logRelease files / open_mastr-1.0.0-py3-none-any.whl
| Download URL | open_mastr-1.0.0-py3-none-any.whl |
|---|---|
| Size | 200.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7b106c6a169f2f7d6ceee4bde6a3f4e4eb0a4ca965e075e597275a1ad11845ad
|
|
BLAKE2b-256 checksum How to use checksums |
cf2bc2d0a0de60dc9fa16caa8ae97e2a3e9a68fc43dcd381271739c9a98254c7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 24, 2026.
Transparency log
