Octopus Energy API

Name: Octopus Energy API
Brand: Octopus Energy API
Availability: InStock

✓ Official Vendor SpecIOTSensor Databasic1 EndpointsREST

For Agents

Pull smart-meter consumption, query Agile and Go tariff prices, and manage Octopus Energy accounts through a single GraphQL endpoint.

Install Jentic One Beta

Connect the Octopus Energy API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Octopus Energy API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Octopus Energy API.

Query half-hourly electricity and gas consumption from a smart meter

Retrieve Agile and Go tariff unit rates for a given postcode and time window

Look up account details, properties, and active agreements

GET STARTED

Start building with Octopus Energy API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Octopus Energy API for, with concrete tasks.

★ Smart-home Agile tariff automation

Time appliance use to the cheapest half-hourly Agile Octopus rates by querying the live unit-rate stream and scheduling EV charging, hot water, or batteries accordingly. The API returns rates 24 hours ahead, letting home-energy systems plan an optimal schedule and replan as new prices land each afternoon.

Query the Agile unit rates for the next 24 hours at a given postcode and return the three half-hourly windows with the lowest pence-per-kWh price

Energy-usage dashboards

Build personal or estate-wide dashboards showing electricity and gas consumption against tariff cost. The API returns half-hourly readings keyed to MPAN/MPRN, which can be aggregated into daily, weekly, or monthly views and joined with the active tariff rate to compute spend.

Fetch the last 7 days of half-hourly electricity consumption for a specified MPAN and aggregate it into daily kWh totals

EV charging dispatch verification

For Intelligent Octopus and Go customers, query the dispatch schedule to verify that the charger is being slotted into the smart-charge window and that the cheap-rate hours will apply. This is essential for fleet operators and home-energy apps that need to confirm a charge happened at the off-peak rate.

Retrieve tonight's planned dispatches for an Intelligent Octopus account and report the start and end times along with expected energy in kWh

AI agent energy assistant via Jentic

AI agents acting as personal energy assistants use Jentic to call the GraphQL endpoint without writing custom GraphQL clients. The agent searches Jentic for an intent like 'get my electricity usage', loads the operation schema, and executes — Jentic handles the basic-auth header and the GraphQL query construction.

Search Jentic for an Octopus Energy consumption query, load the schema, and execute it for the current month's usage

Key Endpoints

1 endpoints — octopus energy api exposes a single graphql endpoint covering uk energy accounts, tariffs, smart-meter consumption readings, agreements, and live wholesale rates.

METHOD

PATH

DESCRIPTION

POST

/v1/graphql

Single GraphQL endpoint for all account, consumption, tariff, and dispatch queries and mutations

POST

/v1/graphql

Single GraphQL endpoint for all account, consumption, tariff, and dispatch queries and mutations

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Octopus Energy basic-auth API keys are stored encrypted in the Jentic vault. Agents receive a scoped token; the raw API key never appears in the Authorization header value seen by the agent.

Intent-based discovery

The API is GraphQL-only with a single endpoint, which is hard for LLMs to call cold. Agents search Jentic by intent (for example 'get my electricity consumption') and Jentic returns the matching operation with the GraphQL document and variables prepared.

Time to first call

Direct GraphQL integration including schema discovery and basic-auth setup: half a day. Through Jentic: under 30 minutes — search, load, execute.

FAQs

Specific to using Octopus Energy API through Jentic.

What authentication does the Octopus Energy API use?

The API uses HTTP Basic authentication with your account's API key as the username and an empty password. Through Jentic, the API key is stored encrypted in the vault and the basic auth header is constructed at request time, so the raw key never enters the agent's context.

Can I query half-hourly consumption with the Octopus Energy API?

Yes. The GraphQL schema exposes consumption queries that return half-hourly readings for a given MPAN (electricity) or MPRN (gas) over a date range. Smart meters must be enrolled and reporting through DCC for the data to be available.

What are the rate limits for the Octopus Energy API?

Octopus Energy applies a soft rate limit on the GraphQL endpoint. Excessive bursts return 429 responses. Design agents to batch GraphQL queries (consumption, tariffs, and dispatches in one document) rather than firing many small requests.

How do I get Agile tariff prices through Jentic?

Search Jentic for 'octopus agile unit rates', load the GraphQL operation schema, and execute it with a postcode and a time window. Jentic returns the half-hourly unit rates as JSON; no GraphQL client wiring is required.

Is the Octopus Energy API free to use?

Yes for Octopus Energy account holders. The API is provided to retail customers and approved third parties without an additional fee — you authenticate with the same API key shown on your octopus.energy dashboard. Bulk or commercial use cases may require contacting Octopus Energy directly.

Does the Octopus Energy API support meter-reading submission?

Yes. The GraphQL schema exposes mutations to submit manual meter readings against a registered MPAN or MPRN. Submitted readings appear on the account dashboard and feed into the next bill cycle.