Hervorragend
Trustpilot 5 stars

+49 800 400 8010

Hervorragend
Trustpilot 5 stars

weltweit über 10 Mio. Kund*innen

Dynamisch sparen leicht gemacht – so holst du dir die Preise für deine Geräte direkt per API

Dynamische Stromtarife sind nicht nur spannend, sondern können dir auch bares Geld sparen – wenn du weißt, wann der Strom günstig ist. Mit unserer API kannst du als Nutzer*in unseres dynamischen Stromtarifs dynamicOctopus deinen aktuellen Bruttoarbeitspreis inklusive der 15-minütigen Börsenstrompreise (Intraday Auction IDA 1) abrufen - und genau planen, wann sich die Nutzung großer Verbraucher wie Waschmaschine oder Trockner besonders lohnt. In dieser Anleitung zeigen wir dir Schritt für Schritt, wie du mit ein paar einfachen Abfragen an deine persönlichen Strompreise kommst.

Wichtig zu beachten: Die Nutzung unseres dynamischen Tarifs dynamicOctopus ist die Grundvoraussetzung dafür, dass du die Strompreise einsehen kannst. Diesen Tarif kannst du nur mit einem Smart Meter abschließen. Nutzt du den Tarif nicht, wird dir eine leere Liste ohne Preise angezeigt.

Bevor es los geht

Zugangsdaten

Um zu starten, brauchst du deine Octopus Energy Zugangsdaten, also E-Mail und Passwort, mit denen du bei uns registriert bist und auf unserer Webseite einloggst.


Dynamischer Stromtarif

Die API liefert dir nur dann Werte zurück, wenn du auch wirklich einen dynamischen Tarif hast. Wartest du noch auf dein Smart-Meter, können auch noch keine dynamischen Werte angezeigt werden.


1. Los geht’s: Starte im GraphQL-Explorer

GraphQL-Explorer: Zugangs-Token

Um Anfragen an die API stellen zu können, benötigst du einen Token. Diesen bekommst du mit der folgenden Anfrage (Mutation). Kopiere diesen Code in das obere Textfeld des GraphQL-Explorers:

mutation krakenLogin($email: String, $password: String) {
  obtainKrakenToken(input: {email: $email, password: $password}) {
    token
  }
}

Trage deine E-Mail und dein Passwort im „Variables“-Tab ein und klicke , um das Token zu generieren:

{
  "email": "happy.constantine@octopusenergy.de",
  "password": "geheimesPasswort123"
}

Oder einfach auf den Button klicken:

So sollte das dann aussehen, nur mit anderen Werten selbstverständlich:

API für dynamicOctopus

2. Trage das Token in den "Headers"-Tab ein

Damit die API weiß, dass du dynamicOctopus-Kunde und damit berechtigt bist, Daten abzufragen, musst du dein Authentifizierungstoken in den „Headers“-Tab kopieren:

{
  "Authorization": "Token-aus-Schritt-1"
}
API for dynamicOctopus 2

3. Frag die aktuellen Strompreise ab

Jetzt wird’s spannend: Um deinen aktuellen Brutto-Arbeitspreis inklusive der 15-minütigen Börsenpreise für deinen Tarif abzufragen, brauchst du deine Kundennummer. Diese beginnt immer mit "A-", gefolgt von mehreren Ziffern und/oder Buchstaben. Du findest sie zum Beispiel in deinem Octopus Energy Dashboard oder deiner App ganz oben links (s.u.) oder auf einer unserer Rechnungen.

Du findest deine Kundennummer in deinem Kundenkonto

Trage deine Kundennummer in den „Variables“-Tab ein (deine vorherige Eingabe von Email und Passwort kannst du einfach überschreiben):


{
  "accountNumber": "A-12345678"
}

Dann kopiere diesen Code in das Textfeld des GraphQL-Explorers und klicke , um die Preisabfrage durchzuführen:

query getDayAheadPrices($accountNumber: String!) {
  account(accountNumber: $accountNumber) {
    properties {
      electricityMalos {
        agreements {
          product {
            isTimeOfUse
          }
          unitRateForecast {
            validFrom
            validTo
            unitRateInformation {
              ...on TimeOfUseProductUnitRateInformation { 
                rates {
                  netUnitRateCentsPerKwh
              latestGrossUnitRateCentsPerKwh
              }
              }
            }
          }
        }
      }
    }
  }
}

Wenn alles geklappt hat, solltest du jetzt deinen Brutto-Arbeitspreis inklusive der 15-minütigen Börsenpreise für heute und gegebenenfalls morgen sehen. Beachte bitte, dass wir die Börsenpreise für morgen immer erst am späten Nachmittag erhalten. Vormittags gibt es daher lediglich die heutigen Preise zu sehen.

api-dynamicOctopus-3

Was du jetzt mit den Daten machen kannst

Mit diesen Infos kannst du z. B.:

  1. deine Stromnutzung clever planen (z. B. Wäsche waschen, wenn’s günstig ist),

  2. dein Smart Home automatisch steuern,

  3. oder einfach mal sehen, wie sich Strompreise im Tagesverlauf ändern.

Wenn du technisch etwas versiert bist, kannst du die Abfragen sogar automatisieren oder dir deine ganz persönliche Strompreis-Anzeige basteln.


Unsere API ist also direkte Draht zu deinen Strompreisen. Du kannst in Echtzeit nachvollziehen, wie sich dein Tarifpreis entwickelt und dein Verbrauchsverhalten an die Börsenpreise anpassen. Ganz schön smart, oder?

Wenn du Interesse an weiteren API-Anwendungen wie bspw. einer noch genaueren Analyse deiner Energiedaten hast, schau gerne auch auf unserem Blogpost dazu vorbei.