Skip to main content

Python client for the Octopus Energy RESTful API

Project description

Octopus Energy Python API Client Library

A Client library for accessing the Octopus Energy APIs

Warning: The API is currently undergoing active development and should be considered unstable, even volatile until it reaches version 1.0.0

PyPI version PyPI - Python Version

Build Status Coverage Status

Installation

octopus-energy can be installed from PyPI using pip:

pip install octopus-energy

Code

The code is available in the octopus-energy repository on GitHub

Features

  • Get energy consumption from SMETS1 and SMETS2 electricity and gas meters.

Quickstart

You can obtain your API token and meter information from the Octopus Energy Developer Dashboard.

REST Client Wrapper

The REST client wrapper is a slim shim over the REST API that returns dictionaries as responses.

Note that you should reference the Octopus Energy API documentation for detailed notes on the API responses
and specifics around the request parameters.

from octopus_energy import OctopusEnergyRestClient

api_token="sk_live_your-token"
mprn = "your-mprn"
serial_number = "your-meter-serial-number"

async with OctopusEnergyRestClient(api_token) as client:
  consumption = await client.get_gas_consumption_v1(mprn, serial_number)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

octopus-energy-0.1.10.tar.gz (9.5 kB view details)

Uploaded Source

Built Distribution

octopus_energy-0.1.10-py3-none-any.whl (12.3 kB view details)

Uploaded Python 3

File details

Details for the file octopus-energy-0.1.10.tar.gz.

File metadata

  • Download URL: octopus-energy-0.1.10.tar.gz
  • Upload date:
  • Size: 9.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.4 CPython/3.8.3 Linux/5.4.0-1034-gcp

File hashes

Hashes for octopus-energy-0.1.10.tar.gz
Algorithm Hash digest
SHA256 ba8448104292bd4308adf3f81e54a3b402941e2bf39df349093595987b5bdd17
MD5 2870211382122eca8f9373c7e43bd415
BLAKE2b-256 bc101c58da6cab8cdab5617bdd5112ef7c5ddbf4037941a91a126150397cd4bf

See more details on using hashes here.

Provenance

File details

Details for the file octopus_energy-0.1.10-py3-none-any.whl.

File metadata

  • Download URL: octopus_energy-0.1.10-py3-none-any.whl
  • Upload date:
  • Size: 12.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.4 CPython/3.8.3 Linux/5.4.0-1034-gcp

File hashes

Hashes for octopus_energy-0.1.10-py3-none-any.whl
Algorithm Hash digest
SHA256 615c52246fc30d40d88adf3a07402f001471432982adb712cfe714b2813c2d29
MD5 a86ba0d07b59b955364308fee95dabb1
BLAKE2b-256 a86ecdf7789ed3afbd143eb12a5b4b8535693c10c51c919e759fff9b7966e5be

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page