Metric Export für Excel

Der Metric Export liefert jede Metrik Ihrer Anlagen als CSV-Datei, die Excel und LibreOffice direkt öffnen. Diese Seite zeigt die alltäglichen Fälle als fertige Links und wie Sie Excel mit einem Link verbinden, sodass sich eine Arbeitsmappe selbst aktualisiert.

Voraussetzungen

Ein Mirox-Konto, das die Messwerte der Anlage lesen darf, die Sie exportieren.
Ein API-Token der Gruppe Metric Export — siehe API-Token-Nutzung. In einem Browser, in dem Sie angemeldet sind, funktioniert ein Link ohne Token.

Der einfache Weg: den Link aus der App kopieren

Sie müssen einen Link nicht von Hand zusammenstellen.

In Mirox öffnen

Daten-Export ▸ Metriken — wählen Sie Anlagen, Metriken, Zeitraum und Schrittweite. Die API-URL unter der Vorschau ist der Link genau dieser Auswahl, einschließlich der Komponenten, die Sie gewählt haben. Ausprobieren bereitet ein Token und fertige Befehle vor.

Die Rezepte unten zeigen, wie diese Links aussehen, damit Sie sie anpassen können.

Rezept 1: Produktion einer Anlage in 15 Minuten

Eine Woche Netzeinspeisung, als Energie je 15 Minuten:

curl --compressed "https://service.mirox.io/api/v1/export/series?park=ABC123DEF456&metrics=plant.grid_feedin&start=2026-07-01&end=2026-07-07&step=15min&values=delta" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o production_week.csv

Date;UTC offset;Grid feed-in (kWh)
2026-07-01 00:00;+02:00;0,0
2026-07-01 00:15;+02:00;0,0
2026-07-01 06:15;+02:00;1,3
...

Die Zeiten sind die Ortszeit der Anlage. Die Spalte UTC offset (mit language=de: UTC-Versatz) macht jede Zeile eindeutig, auch am Tag der Zeitumstellung. offset_column=false lässt sie weg; tz=utc exportiert in UTC.
end=2026-07-07 schließt den 7. Juli ein.
Für eine Kurve der Leistung statt der Energie exportieren Sie plant.grid_power.

Rezept 2: Der Vormonat, jeden Monat

Ein Link mit einer Voreinstellung liefert immer den jüngsten vollständigen Zeitraum. Das ist der Link für eine Arbeitsmappe, die einmal im Monat aktualisiert wird:

curl --compressed "https://service.mirox.io/api/v1/export/series?park=ABC123DEF456&metrics=plant.grid_feedin,plant.rad_pyranometer,availability.inverter_park&window=previous_month&step=day" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o previous_month.csv

Date;Grid feed-in (kWh);Plant-plane radiation, pyranometer (kWh/m²);Inverter availability (park) (%)
2026-08-01;5321,4;6,8;99,6
...

Rezept 3: Mehrere Anlagen nebeneinander

Eine Spalte je Anlage mit multi_park_agg=split:

curl --compressed "https://service.mirox.io/api/v1/export/series?park=ABC123DEF456,DEF456ABC123&metrics=plant.grid_feedin&window=previous_month&step=day&multi_park_agg=split" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o plants_compare.csv

Date;Sunnyside - Grid feed-in (kWh);Riverbend - Grid feed-in (kWh)
2026-08-01;5321,4;4102,9
...

multi_park_agg=merge, der Standard, ergibt eine Spalte für alle Anlagen gemeinsam.
portfolio=<uid> wählt alle Anlagen eines Portfolios.

Rezept 4: Jeder Wechselrichter

Eine Metrik der Wechselrichter-Ebene ergibt eine Spalte je Wechselrichter:

curl --compressed "https://service.mirox.io/api/v1/export/series?park=ABC123DEF456&metrics=inverter.ac&start=2026-07-01&end=2026-07-07&step=15min" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o inverters.csv

Date;UTC offset;WR 01.01 - AC production per inverter (kWh);WR 01.02 - AC production per inverter (kWh);...
2026-07-01 06:15;+02:00;0,6;0,6;...

Ohne Auswahl enthält die Datei alle Wechselrichter, 50 je Seite. lane_page=2 ergibt die nächsten 50; lane_limit=100 ergibt 100 je Seite.
Um nur bestimmte Wechselrichter zu exportieren, fügen Sie components=inverter:1043,inverter:1044 hinzu. Der Komponentendialog auf dem Tab Metriken setzt die Referenzen für Sie in den Link.
Strings und Generatoranschlusskästen funktionieren genauso, mit string.power (Energie je String) und gak.power (Energie je Generatoranschlusskasten).

Rezept 5: Jeder Einstrahlungssensor

Jeder Sensor einzeln, ohne Mittelung:

curl --compressed "https://service.mirox.io/api/v1/export/series?park=ABC123DEF456&metrics=sensor.irradiance&window=yesterday&step=15min" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o sensors.csv

sensor.irradiation ergibt die Einstrahlungsenergie je Sensor in kWh/m², in jeder Schrittweite bis zu einem Jahr. Die Systemvorlage Einstrahlungssensoren (CAFE1030CAFE) enthält beide, zusammen mit der Pyranometer-Einstrahlung der Anlage.

Rezept 6: Windturbinen

Energie und Windgeschwindigkeit jeder Turbine, je Tag:

curl --compressed "https://service.mirox.io/api/v1/export/series?park=ABC123DEF456&metrics=turbine.energy_ac,turbine.wind_speed&window=previous_month&step=day" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o turbines.csv

Die Leistung einer Turbine, turbine.power_ac, ist eine 15-Minuten-Metrik: Exportieren Sie sie mit step=15min.

Rezept 7: Batterie

Geladene und entladene Energie und der Ladezustand des Speichers, je Tag:

curl --compressed "https://service.mirox.io/api/v1/export/series?park=ABC123DEF456&metrics=battery.energy_in_ac,battery.energy_out_ac,battery.soc&window=previous_month&step=day" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o battery.csv

Für einzelne Container, Racks, Module oder Zellen nutzen Sie die Metriken dieser Ebenen, zum Beispiel battery_box.soc oder battery_cell.voltage. Eine Anlage hat viele Zellen; wählen Sie im Komponentendialog die, die Sie brauchen.

Excel mit Power Query

Power Query liest einen Link direkt, mit dem Token im Header Authorization. Die Arbeitsmappe aktualisiert sich dann mit Daten ▸ Alle aktualisieren.

Wählen Sie in Excel Daten ▸ Daten abrufen ▸ Aus anderen Quellen ▸ Leere Abfrage.
Öffnen Sie den Erweiterten Editor und fügen Sie die Abfrage unten ein. Ersetzen Sie die Anlage, die Metriken und das Token.
Wenn Excel fragt, wie die Verbindung hergestellt werden soll, wählen Sie Anonym. Das Token steht bereits im Header; jede andere Wahl führt dazu, dass Excel den Header ablehnt.

let
    Source = Csv.Document(
        Web.Contents(
            "https://service.mirox.io",
            [
                RelativePath = "api/v1/export/series",
                Query = [
                    park = "ABC123DEF456",
                    metrics = "plant.grid_feedin,plant.rad_pyranometer",
                    window = "previous_month",
                    step = "day",
                    header = "id",
                    separator_csv = ",",
                    separator_decimal = "."
                ],
                Headers = [Authorization = "Bearer YOUR_API_TOKEN"]
            ]
        ),
        [Delimiter = ",", Encoding = 65001, QuoteStyle = QuoteStyle.Csv]
    ),
    Promoted = Table.PromoteHeaders(Source, [PromoteAllScalars = true]),
    Typed = Table.TransformColumnTypes(
        Promoted,
        {
            {"timestamp", type date},
            {"plant.grid_feedin", type number},
            {"plant.rad_pyranometer", type number}
        },
        "en-US"
    )
in
    Typed

header=id macht die Spaltenköpfe zu stabilen IDs. Die Abfrage funktioniert weiter, wenn eine Metrik umbenannt wird oder die Sprache wechselt.
Mit separator_decimal = "." und der Kultur "en-US" werden die Zahlen auf jedem Rechner gleich gelesen, unabhängig von seinen Regionaleinstellungen.
Bei einer Schrittweite unter einem Tag enthält die Spalte timestamp Datum und Uhrzeit: Verwenden Sie type datetime. Die Spalte utc_offset ist ein Text.
Leere Zellen bleiben leer. Sie bedeuten „keine Daten“, nicht null.
Für eine Vorlage verwenden Sie RelativePath = "api/v1/export/series/template/CAFE1000CAFE" und lassen metrics weg.

Halten Sie das Token aus geteilten Arbeitsmappen heraus

Das Token ist Teil der Abfrage und wandert mit der Arbeitsmappe. Erstellen Sie ein Token der Gruppe Metric Export nur für diesen Zweck: Es kann Exporte lesen und sonst nichts, und Sie können es widerrufen, ohne Ihre anderen Tokens anzufassen.

Die CSV-Datei in Excel öffnen

Trennzeichen: Die Standardwerte (; zwischen den Spalten, , als Dezimalzeichen) öffnen sich direkt in einem Excel mit deutschen Regionaleinstellungen. Für englische Einstellungen fügen Sie separator_csv=,&separator_decimal=. hinzu — die beiden müssen sich unterscheiden.
Datumsangaben: datetime_format nimmt ein Muster wie %d.%m.%Y %H:%M, wenn Sie ein anderes Format brauchen.
Kodierung: Die Dateien sind UTF-8. Wenn Sonderzeichen falsch aussehen, importieren Sie die Datei mit Daten ▸ Aus Text/CSV.
Spaltennamen: language=de (oder es, fr, it, pt) übersetzt sie.
Größe: Große Dateien werden unterwegs komprimiert, wenn der Client es akzeptiert — daher --compressed in den Beispielen. Browser und Excel tun das von selbst.

Grenzen

Grenze	Wert
Metriken je Link	20
Anlagen je Link	50
Komponenten je Metrik und Seite	50, höchstens 100
Spalten	400
Werte je Spalte	180 000 — 125 Tage bei 1 Minute, fünf Jahre bei 15 Minuten
Werte insgesamt	1 800 000

Ein Link, der mehr verlangt, wird mit 400 over_budget abgelehnt, und die Antwort nennt die Schrittweite oder den Zeitraum, die passen würden. Wie Sie einen großen Export aufteilen, beschreibt die Metric-Export-API.

Links, die Sie bereits nutzen, funktionieren weiter

Links des bisherigen Rohdaten-Exports liefern weiter dieselben Spalten. In einer Arbeitsmappe, die sie verwendet, muss sich nichts ändern:

https://service.mirox.io/api/v1/export/raw/query?metrics=raw_grid_energy_total&park=ABC123DEF456&start=2026-07-01T00:00:00Z&end=2026-07-08T00:00:00Z&step=15m&value=use_delta

https://service.mirox.io/api/v1/export/raw/query?metrics=raw_grid_energy_total&park=ABC123DEF456,DEF456ABC123&start=2026-07-01T00:00:00Z&end=2026-08-01T00:00:00Z&step=1h&value=use_delta&multi_park_agg=split

https://service.mirox.io/api/v1/export/raw/component/query?metrics=comp_raw_inverter_energy_ac&park=ABC123DEF456&component_type=inverter&start=2026-07-01T00:00:00Z&end=2026-07-08T00:00:00Z&step=15m&value=use_delta

https://service.mirox.io/api/v1/export/raw/component/query?metrics=comp_raw_string_energy&park=ABC123DEF456&component_type=string&components=1084279778457255938&start=2026-07-01T00:00:00Z&end=2026-07-08T00:00:00Z&step=15m&value=use_delta

Ihre Entsprechungen im Metric Export sind die Rezepte 1, 3 und 4 oben. Drei Dinge unterscheiden sich: Energie ist in kWh statt Wh, die Zeiten sind die Ortszeit der Anlage statt UTC, und die Metriken tragen die Namen, die die Berichte verwenden. Der Leitfaden zum Umstieg listet jede bisherige ID mit ihrer Metrik; die bisherigen Links sind in der Legacy-Export-API beschrieben.

Metric Export — die Seite Daten-Export
Metric-Export-API — jeder Parameter, jede Grenze und jeder Fehler
Externer Berichtsgenerator — ein vollständiges Python-Beispiel
API-Token-Nutzung — das Token erstellen, das die Beispiele verwenden
FAQ zum Daten-Export