FoxESS OpenAPI for Home Assistant (Marketplace integration)

On Home Assistant 2026.10 or older? Open it in HACS

Installs: 50 sharing analytics
GitHub stars: 1
Connection: Uses the vendor's cloud
Upkeep: Updated in the last 6 months
Version: v0.5.0, August 1, 2026
Category: Energy, Solar and batteries
Kind: Marketplace integration
Brand: FoxESS
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: foxess_openapi
Source: github.com/fruffin/home-assistant-foxess-openapi
Issues: Report an issue

Shows in Vulpo Button card, Chart card, Apple Watch.

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

FoxESS OpenAPI is a custom integration that reads FoxESS solar and battery systems through the FoxESS Open API. It creates a Home Assistant device for the configured inverter serial number and adds sensors for inverter status, PV strings, phase metrics, battery state, power flows, temperatures, daily energy totals, and API response time. Refresh intervals are exposed as number entities on the device, so they can be changed from its details page, and a button forces an immediate refresh of all datasets. Calls go through a shared coordinator and are spaced at least one second apart because the FoxESS API is rate limited. Support for PV strings 7 to 18 is optional, and second-battery sensors appear only when FoxESS reports values for them. Setup happens in the UI with an API key from FoxESS Cloud and the device serial number, and the integration depends on the vendor's cloud.

Automatic summary of the README and code of fruffin/home-assistant-foxess-openapi. Something wrong, or are you the maintainer and want your own text here? Get in touch

Shows in Vulpo

Button card, Chart card, Apple Watch.

Download Vulpo

Installs over time

Oct 21Nov 9

#1,533 of 1,551 Marketplace integrations. Installs sharing analytics.

Supports

Uses the vendor's cloudNeeds an internet connection and an account with the vendor.
From the MarketplaceInstalled through the Marketplace, formerly HACS.
Actively maintainedIts author released or pushed a change in the last six months.

Provides

Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Connect

API key
Device serial number
Expose PV strings 7-18
API host
Name

After setup

Expose PV strings 7-18

Texts from the code of fruffin/home-assistant-foxess-openapi.

From the README

Custom Home Assistant integration for FoxESS solar and battery systems using the FoxESS Open API.
FoxESS OpenAPI is config-flow first, creates a proper Home Assistant device for the configured inverter serial number, and exposes sensors for inverter status, PV strings, phase metrics, battery state, power flows, temperatures, daily energy totals, and API response time.
UI-based setup; no YAML configuration required.
Home Assistant device metadata based on the configured FoxESS serial number.
Configurable refresh intervals from the device details page.
Force-refresh button for ad hoc API updates.
Optional support for extended PV strings up to PV18.
Optional second-battery sensors are only created when FoxESS reports values for them.

From the README of fruffin/home-assistant-foxess-openapi, MIT License. Shortened.