Octopus products and add-ons
The Octopus Energy API in plain English
What Octopus’s free API can tell you: public tariff and rate data for every region, your own meter readings with an API key, and how to use it sensibly.
Edited by Rob Gibbs. Published: . Guidance reviewed: .
Short answer
Octopus runs a free REST API. Anyone can use it to list Octopus’s products and read each tariff’s unit rates and standing charges, region by region, without signing in. With the API key from your online account you can also read your own meter details and half-hourly readings. Keep the key private, ask only for the dates you need, and treat Octopus’s developer documentation as the final word.
Public price data: no key needed
The products endpoint lists every product Octopus currently sells. You can filter it, for example to Octopus Energy’s own brand, to fixed or variable products, to home rather than business products, or to what was on sale on a past date. Each product then lists its tariffs by region and payment method, with links to the full history of its unit rates and standing charges.
None of these price endpoints need an account. The addresses Octopus documents are:
- /v1/products/ for the list of current products.
- /v1/products/<product code>/ for one product and all its regional tariffs.
- …/electricity-tariffs/<tariff code>/standard-unit-rates/ for the unit rates over time. Agile returns one price for each half hour you ask for.
- …/standing-charges/ for the standing charge over time.
- …/day-unit-rates/ and …/night-unit-rates/ for Economy 7 tariffs, which have two registers.
Reading product and tariff codes
A product code names the tariff and its version, such as AGILE-FLEX-22-11-25, the Agile Octopus product Octopus uses in its own examples. A tariff code adds what it covers at the front and the region letter at the end: E-1R for single-rate electricity, E-2R for Economy 7 and G-1R for gas. So E-1R-AGILE-FLEX-22-11-25-C is Agile electricity in region C, London. Our regions page shows which letter covers your area.
A rate whose valid_to is empty is the price that applies now. Octopus’s documentation also notes that variable tariffs carry on when they reach their end date, while a fixed tariff moves to the variable tariff when its term ends.
Your own data: the API key
Your own account details and readings need your API key. Octopus shows it on the developer page of your online account, next to your MPAN and meter serial number. In a browser, you type the key as the username and leave the password blank. Code sends it the same way, as the username of a basic login.
With the key, the account endpoint returns your meter points, MPAN or MPRN, meter serial numbers and the tariff codes you are and have been on. The consumption endpoint returns half-hourly readings for one meter. Some details to know:
- Results come 100 to a page, newest first, unless you ask for order_by=period.
- group_by=day, week, month or quarter adds the half hours up for you.
- An export meter’s readings are listed as consumption, though they are what you sent to the grid.
- Gas readings from a SMETS2 meter come in cubic metres. SMETS1 gas readings come already converted to kWh.
Keep the key private
Octopus says the key is like a password. Anyone who has it can read your readings and account details, so never post it in a forum, a screenshot or public code, and only give it to a tool you trust. If you leave Octopus the key stops working, and a new home has a different MPAN and meter serial number, so update any tool after a move.
Our private usage tools work this way: your browser talks to Octopus directly, and this site never receives your key, account number or readings.
Using it sensibly
Octopus’s REST guides did not give a fixed request limit when we checked on 15 November 2026. Its GraphQL API, which covers more of the account, does publish limits: a complexity cap for each request, an hourly allowance and rate limiting. Either way, a little care keeps your scripts working:
- Always send period_from and period_to, written in UTC with a Z on the end. Without them Octopus guesses the range, and local times can shift results around the clock changes.
- Follow the next link in each response for further pages rather than asking for huge ranges at once.
- Save prices once you have them. Agile prices for the next 24 hours are set once a day, between 4pm and 8pm and usually nearer 4pm, so checking every few minutes gains nothing.
- There is little point asking for readings every few minutes: they only appear once your meter has sent them to Octopus.
Which web address to use
Octopus’s developer documentation now gives the base address as https://api.oegb-kraken.energy/v1/, and its old developer site redirects to the new one. The long-standing address, https://api.octopus.energy/v1/, still answered the same requests when we checked on 15 November 2026. That is our observation, not a promise from Octopus, so follow the documentation if the two ever differ.
Questions people ask
Is the Octopus Energy API free?
Yes. Octopus does not charge for it. Its price data is open to anyone, and customers can read their own readings with the API key from their online account.
Do I need to be an Octopus customer to use the API?
Not for prices. The product, unit rate and standing charge endpoints need no login. You only need an account, and its API key, to read your own meter details and readings.
Where do I find my Octopus API key?
On the developer page of your Octopus online account, alongside your MPAN and meter serial number. Treat it like a password. It stops working if you leave Octopus.
Can I get tomorrow’s Agile prices from the API?
Yes, once Octopus has set them. Agile prices for the next 24 hours are set once a day, between 4pm and 8pm and usually nearer 4pm. Ask the standard-unit-rates endpoint for your region’s Agile tariff code, with a period_from and period_to covering tomorrow written in UTC.
Is there a rate limit on the Octopus API?
Octopus’s REST guides did not state one when we checked on 15 November 2026. Its GraphQL API documents a complexity limit, an hourly allowance and rate limiting. Ask only for what you need, save prices once you have them, and do not ask for readings more than about once a day.
Why are some half hours missing from my readings?
Usually because the meter has not sent them yet, or sent them late. The API returns what Octopus has received. Our data gaps tool shows where the gaps are, and Octopus can look into long ones.
What is the difference between the REST and GraphQL APIs?
Both come from the same Octopus API site. The REST API is the simpler one for prices and half-hourly readings, and works with your API key. The GraphQL API covers more of the account, uses a login token and has published usage limits. Octopus’s REST guide says that token works for the REST API too.
Does OctoTariffs see my API key?
No. Our private usage tools run in your browser and talk to Octopus directly, so your key, account number and readings never reach this site.
Tariffs in this guide
Related guides
- A home battery without solar on Octopus: does it pay?How a home battery without solar panels can save money on Octopus by charging cheaply overnight, and what to check first.
- Octopus EV tariffs without a drivewayWhether Octopus Go or Intelligent Go can work if you have no driveway or home charger, and what to compare instead.
- How to test a "save £X" smart tariff claim against your own usageWhat sits behind a smart or EV tariff savings figure, the four questions to ask of it, and how to check it against your own half-hourly readings.
- SMETS1 vs SMETS2 smart meters: what is the difference?How SMETS1 and SMETS2 smart meters differ, why it matters when you switch supplier, and what it means for Octopus smart tariffs.
- Saving Sessions this winter: how to earn from using lessHow Octopus Saving Sessions Power Downs work this winter: joining Octoplus, how rewards are worked out, and easy ways to cut use at peak times.
- Octopus Charge Pack: the home battery add-on explainedWhat Octopus Charge Pack does with your home battery, which tariffs and batteries it works with, how the grid sessions and credits work, and who should skip it.
Primary sources
- REST API basics — Octopus Energy; checked 2026-11-15. Checked 15 November 2026 (HTTP 200; developer.octopus.energy now redirects to this Octopus Energy UK developer site): the REST API lets customers and partners reach the Octopus platform; every request uses the base address https://api.oegb-kraken.energy/v1/ over HTTPS; parameters filter results, for example brand=OCTOPUS_ENERGY; datetimes should be ISO 8601 with a timezone, or Europe/London is assumed; responses are JSON with up to 100 records a page and a "next" link for more. Endpoints that need authentication accept the account API key: in a browser, the API key goes in the username field with the password left blank; with cURL or Python it is passed as the username of HTTP basic authentication.
- API Endpoints — Octopus Energy; checked 2026-11-15. Checked 15 November 2026 (HTTP 200): the account endpoint (/v1/accounts/<account number>/) needs your API key and returns your meter points, MPAN or MPRN, meter serial numbers and current and past tariff codes; variable tariffs auto-extend, while fixed tariffs move to the variable tariff at the end of their term. The products endpoint (/v1/products/) needs no authentication and lists currently active products, filterable by brand, is_variable, is_business, is_green, is_prepay and available_at; each product lists its tariffs by region and payment method, with standing charges and links to standard-unit-rates and standing-charges histories; Economy 7 tariffs have separate day-unit-rates and night-unit-rates links; a null valid_to means the price is still active. The consumption endpoints (/v1/electricity-meter-points/<MPAN>/meters/<serial>/consumption/ and the gas equivalent) need authentication and return half-hourly readings, 100 a page by default, newest first unless order_by=period; group_by can aggregate to day, week, month or quarter; an export MPAN reports export as "consumption"; SMETS2 gas readings come in cubic metres and SMETS1 gas in kWh. Price endpoints return Agile half-hourly prices between two times, 100 records a page; times should end in Z for UTC so clock changes do not shift results; prices are given excluding and including VAT.
- GraphQL API basics — Octopus Energy; checked 2026-11-15. Checked 15 November 2026 (HTTP 200): the API site at https://api.oegb-kraken.energy serves both REST and GraphQL; the GraphQL API has published usage constraints to keep the service available: a complexity limit for each request, an hourly points allowance for each viewer, request-specific rate limiting and a cap on the number of nodes requested, with an error code returned when a limit is exceeded.
- Your smart home just got smarter with Agile Octopus and IFTTT — Octopus Energy; checked 2026-11-15. Where to find the API key, MPAN and meter serial number in the online account. Re-checked 15 November 2026 (HTTP 200): the API key, MPAN and meter serial number are shown on the developer page of the online account; the key is "like a password so do keep it secret"; if you leave Octopus the API key stops working, and if you move home with Octopus the new home has a different MPAN and meter serial number.
- How to get cheaper, greener energy with our open API — Octopus Energy; checked 2026-11-15. Using the Octopus API and half-hourly consumption data. Re-checked 15 November 2026 (HTTP 200): Octopus says it made Agile’s API public so customers can use its pricing data to automate their smart homes, and links to its developer site.
- Agile Octopus — Octopus Energy; checked 2026-11-15. Checked 15 November 2026 (HTTP 200): Agile Octopus includes Price Cap Protect, a guaranteed maximum unit rate per kWh that the half-hourly price never goes above, set far above Ofgem’s price cap unit rate. Half-hourly prices tied to wholesale prices and updated daily for the next 24 hours, set between 4pm and 8pm (usually nearer 4pm); Price Cap Protect ceiling; Plunge Pricing pays you when prices drop below zero; SMETS2 or some SMETS1 smart meter needed, around 14 days to connect.