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

[taraskhust]

EcoFlow API Integration for Home Assistant

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

Features

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

Installation

HACS (Recommended)

Manual

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

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

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.

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

Supported Devices

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

Links

• GitHub: GitHub - TarasKhust/ecoflow-api-mqtt: Home Assistant integration for EcoFlow devices using official Developer API · GitHub
• Issues: Issues · TarasKhust/ecoflow-api-mqtt · GitHub
• EcoFlow API Docs: https://developer-eu.ecoflow.com/

Contributing

Contributions welcome! Please open issues or PRs on GitHub.

---

Made with in Ukraine

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

[dzmiller]

Does this integration run entirely locally after setup?

[taraskhust]

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

[Bratapfl]

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

[taraskhust]

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

[Bohdan]

Your post suggests it River 3 is now supported, but I can’t see it in the list of devices as of v 1.8.4. What am I missing?

[wallb35]

working better than ecoflow cloud for my stream ultra x, hope the river 2 pro will be supported soon

[wallb35]

Got a question about Automatic Fallback : does it comes back to MQTT after Fallback to Rest-Mode ? Any Log ?

[RichardVolders]

Will this integration also work for a Ecoflow Delta 3?

[RichardVolders]

Can you make this work with the Ecoflow Delta 3 Plus?
Thanks in advance!

[BinBotak]

Works well with my PowerStream but I have Delta Max 2000 connected, any chance of including support for the Delta Max product, Big problems getting the tolwi integration to talk to Delta Max 2000

[SvenVoeten]

Anyone using the new EcoFlow Ocean 2 devices with this integration?