EcoFlow API Integration - Official Developer API + MQTT (Delta Pro 3)

Share your Projects! Custom Integrations
,
1

EcoFlow API Integration for Home Assistant

Home Assistant integration for EcoFlow devices using the official EcoFlow Developer API with optional MQTT real-time updates.

:star2: Features

  • :white_check_mark: Hybrid Mode - REST API + MQTT for real-time updates
  • :white_check_mark: Official API - Uses EcoFlow Developer REST API (stable & documented)
  • :white_check_mark: Complete Delta Pro 3 support - 40+ sensors, 13 binary sensors, 9 switches, 13 controls
  • :white_check_mark: Real device tested - All features verified with actual Delta Pro 3
  • :white_check_mark: Energy Dashboard ready - Automatic kWh sensors for HA Energy Dashboard
  • :white_check_mark: Battery monitoring - BMS data, SOC, SOH, temperature, cycles, capacity
  • :white_check_mark: Power monitoring - Input/output, AC, Solar (HV/LV), DC, USB-C, USB
  • :white_check_mark: Full control - AC charging power, charge levels, standby times, X-Boost
  • :white_check_mark: Extra Battery support - Automatic detection and monitoring
  • :white_check_mark: Ukrainian localization :ukraine:

:package: Installation

HACS (Recommended)

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Manual

  1. Copy custom_components/ecoflow_api to your config/custom_components/
  2. Restart Home Assistant

:gear: Configuration

  1. Get API keys from EcoFlow Developer Portal
  2. Go to Settings → Devices & Services → Add Integration
  3. Search “EcoFlow API” and follow the setup wizard

:arrows_counterclockwise: Hybrid Mode (REST + MQTT)

The integration supports hybrid mode combining:

  • REST API - Reliable device control
  • MQTT - Real-time sensor updates (no polling delay!)

Enable MQTT in integration options for instant updates.

:bar_chart: Entities

Type Count Examples
Sensors 40+ Battery level, power, temperature, remaining time
Binary Sensors 13 Charging, discharging, AC connected, battery full
Switches 9 AC output, DC output, X-Boost, beeper
Numbers 13 Charging power, charge levels, standby times
Selects 4 AC frequency, standby times

:earth_africa: Supported Devices

Device Status
Delta Pro 3 :white_check_mark: Full Support
Delta Pro :arrows_counterclockwise: Planned
Delta 2 / 2 Max :arrows_counterclockwise: Planned
River 2 / 2 Max :arrows_counterclockwise: Planned

:books: Links

:handshake: Contributing

Contributions welcome! Please open issues or PRs on GitHub.

Made with :heart: in Ukraine :ukraine:

Note: This is a non-commercial project. Commercial use is prohibited.

1 Like
2

Does this integration run entirely locally after setup?

3

No, this integration does NOT run entirely locally. It requires internet connection because:

  1. REST API - connects to EcoFlow cloud servers (api.ecoflow.com)
  2. MQTT - connects to EcoFlow MQTT broker (mqtt.ecoflow.com:8883)

EcoFlow does not provide a local API. All communication goes through their cloud infrastructure.

If you need local-only access, consider:

  • EcoFlow BLE integration (Bluetooth, limited functionality)
  • Note: Most EcoFlow integrations require cloud access
4

Does it also retrieve PowerStream data or ONLY delta pro 3?

5
Delta Pro 3 :white_check_mark: Full Support All features, real device tested
Delta Pro :white_check_mark: Full Support US API verified
Delta 3 Plus :white_check_mark: Full Support All features
River 3 :white_check_mark: Full Support All features
River 3 Plus :white_check_mark: Full Support Same API as River 3