Skip to main content
SourceDataRefreshCache TTL
FoxESS Cloud APIBattery SoC, solar kW, grid import/export, work mode~5 min (API limit)5 min per user
Octopus Energy APIAgile export rates (48h), settled export consumptionRates ~30 min30 min (rates); longer for historical slots
Open-MeteoHourly shortwave radiation → estimated kWh~1 hour1 hour per user

FoxESS

  • Auth: API key + signed requests
  • Used for: live dashboard, manual override, EV import inference, scheduler push

Octopus

  • Auth: personal API key (Basic)
  • Used for: rates chart, earnings, optimiser scoring
  • Requires export MPAN + meter serial

Open-Meteo

  • No API key
  • Location from your Settings / onboarding postcode
  • kWh estimate: (radiation × panel area × efficiency) / 1000 using env defaults unless customised

Degraded mode

If an upstream API fails, PilotWatt shows the last cached value with a stale timestamp and retry where possible. The recommendation may switch to “insufficient data” if inputs are too old.