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

Your Octopus Energy API key is stored once, encrypted, by your own Jentic One instance and injected into the basic-auth Authorization header at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'get my electricity consumption', and Jentic returns the matching operation with the GraphQL document and variables prepared so the agent calls it without browsing the reference docs.

Time to first call

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.

Can I limit what my agent is allowed to do with the Octopus Energy API?

Yes. Because the Octopus Energy API is a single GraphQL endpoint with no resource id in the URL path, Jentic One scopes access by operation, and since you self-host it, your own rules decide which operations the agent may call. You can allow read-only operations such as querying account details, half-hourly meter consumption, and Agile or Go tariff rates while blocking mutations like submitting meter readings or updating account preferences. Jentic One also holds your API key and injects it into the basic-auth header at request time, so the agent can only reach the operations you have permitted with the credentials you control.