| Source | Data | Refresh | Cache TTL |
|---|---|---|---|
| FoxESS Cloud API | Battery SoC, solar kW, grid import/export, work mode | ~5 min (API limit) | 5 min per user |
| Octopus Energy API | Agile export rates (48h), settled export consumption | Rates ~30 min | 30 min (rates); longer for historical slots |
| Open-Meteo | Hourly shortwave radiation → estimated kWh | ~1 hour | 1 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) / 1000using env defaults unless customised