Skip to main content

​
Method Signature

pub async fn get_energy_stats_total(
    &mut self,
    year: &str,
    plant_id: &str,
    mix_sn: &str
) -> Result<serde_json::Value>
Retrieves total cumulative energy statistics for a MIX inverter up to the specified year. Returns aggregated energy production and consumption data.

​
Parameters

​
year
&str
required
The year up to which to retrieve total statistics.
Format: YYYY (e.g., “2025”)
​
plant_id
&str
required
The unique identifier of the plant.
​
mix_sn
&str
required
The serial number of the MIX inverter.

​
Returns

​
Result<serde_json::Value>
Result
Returns a Result containing:
  • Ok(serde_json::Value): JSON object with total cumulative energy statistics
  • Err(GrowattError): Error if the request fails, authentication is invalid, or response is empty

​
Example

use growatt_api::GrowattApi;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut api = GrowattApi::new();
    api.login("username", "password").await?;
    
    let stats = api.get_energy_stats_total(
        "2025",
        "1234567",
        "ABC123XYZ"
    ).await?;
    
    println!("Total energy stats: {}", stats);
    
    Ok(())
}

​
API Endpoint

POST /panel/mix/getMIXEnergyTotalChart

​
Notes

  • Requires authentication via login() before calling
  • Automatically checks login status before making the request
  • Returns cumulative energy data from the beginning of system operation up to the specified year
  • Useful for understanding lifetime energy production and consumption
  • Throws InvalidResponse error if the response is empty or null

Build docs developers (and LLMs) love

Get started for freeTalk to us