Skip to main content
PilotWatt needs your personal Octopus API key plus the export electricity meter — not your home import meter.
This differs from older guides that only asked for an account number. PilotWatt reads half-hourly export consumption and Agile rates using MPAN + serial from the developer examples.

​
Step 1 — API key

  1. Go to octopus.energy/dashboard/developer
  2. Sign in
  3. Copy your personal API key from the developer page
Screenshot placeholder: add developer page screenshot before launch.

​
Step 2 — Export MPAN and meter serial

On the same developer page:
  1. Scroll to Examples → Consumption → Electricity
  2. Find the export meter block (often the second electricity example)
  3. Copy that block’s MPAN and meter serial number
Use the export meter — not the import meter for your home supply.

​
Step 3 — Enter in PilotWatt

Onboarding: Octopus step fields for API key, MPAN, and serial. Settings: Settings → Octopus Energy → Advanced. Click Save Octopus settings. Agile rates should appear on Home and Planner within 30 minutes (or immediately if rates are cached).

​
Troubleshooting