OpenElectricity provides SDKs to access the API in TypeScript / JavaScript or Python.

Typescript SDK

The Typescript SDK is available on NPM.

It supports accessing the API synchronously and asynchronously, and includes a built in data and record table tools for analysing data.

Installation

The Typescript SDK is available on NPM at openelectricity.

Install the SDK using your preferred package manager:

npm install openelectricity

Quick Start

import { OpenElectricityClient } from 'openelectricity'

// Initialize the client
const client = new OpenElectricityClient()

// Get energy data for the NEM
const { datatable } = await client.getNetworkData('NEM', ['energy'], {
  interval: '1h',
  dateStart: '2024-01-01T00:00:00',
  dateEnd: '2024-01-02T00:00:00',
  primaryGrouping: 'network_region',
})

// Analyze the data
console.table(datatable.toConsole())

Python SDK

The Python SDK is available on PyPI.

It supports accessing the API synchronously and asynchronously, and exporting results to either pandas or polars DataFrames.

Installation

The Python SDK is available on PyPI at openelectricity.

Install the SDK using your preferred package manager:

pip install openelectricity

Quick Start

from openelectricity import OpenElectricityClient

# Initialize the client
client = OpenElectricityClient()

# Get energy data for the NEM
datatable = client.get_network_data('NEM', ['energy'], {
  interval: '1h',
  dateStart: '2024-01-01T00:00:00',
  dateEnd: '2024-01-02T00:00:00',
  primaryGrouping: 'network_region',
})