BluettiCloud 1.0.1

BluettiCloud

A C# library for connecting to Bluetti power stations via their Cloud API, receiving real-time device telemetry over a STOMP/WebSocket connection.

Platform: Windows only (token storage uses Windows Credential Manager)
Runtime: .NET 10

Quick Start

Warning! Telemetry data is pushed by the server only when the device state changes or a heartbeat occurs. The interval between updates is unpredictable: it can be as short as 30 seconds or as long as 5+ minutes.

using BluettiCloud.Services;
using Serilog;

namespace BluettiCloudConsole
{
    internal class Program
    {
        static async Task Main(string[] args)
        {
            Log.Logger = new LoggerConfiguration()
                .MinimumLevel.Debug()
                .WriteTo.Console()
                .CreateLogger();

            Client client = await ClientFactory.CreateAsync();
            client.OnRealtimeStatus += Client_OnRealtimeStatus;
            await client.StartAsync();

            while (true)
            {
                await Task.Delay(1000);
            }
        }

        private static void Client_OnRealtimeStatus(object? sender, BluettiCloud.Models.DeviceRealtimeStatus e)
        {
            if (e.BatterySoc == null)
            {
                return;
            }

            Log.Information($"{e.DeviceSn} = {e.BatterySoc}%. Grid In {e.PowerGridIn}W. AC Out {e.PowerAcOut}W. DC Out {e.PowerDcOut}W.");
        }
    }
}

Device Status Fields

DeviceRealtimeStatus exposes the following fields (all nullable string):

Known Limitations

• Windows only — TokenStorage uses Windows.Security.Credentials.PasswordVault. Linux/macOS support would require an alternative storage backend.
• Undocumented API — Bluetti does not publish an official API. The endpoints, message format, and authentication flow were reverse-engineered and may change without notice.

Contributing

Issues and pull requests are welcome. If Bluetti changes their API and the library breaks, please open an issue with the raw WebSocket frames if possible.

Credits

This library is a native .NET implementation of the communication protocol used in the Official Bluetti Home Assistant repository (https://github.com/bluetti-official/bluetti-home-assistant). Special thanks to the Bluetti for providing the reference implementation!