Skip to main content

​
Solar Inverter State

Solar inverter state parameters provide real-time production data, battery status, household consumption, and energy metrics. These fields are read-only and automatically updated from the manufacturer’s API.
State data refresh frequency depends on the manufacturer’s API. Most values update every 5-15 minutes.

​
Grid Exchange

​
current_power_to_grid_w
integer
Current power being exported to or imported from the grid in Watts. Positive values indicate export; negative values indicate import.Example: 2500 (exporting 2.5 kW)

​
Solar Production

​
current_solar_production_w
integer
Current solar power production in Watts.Returns 0 during nighttime or cloudy conditions.Example: 6250

​
Household Consumption

​
household_consumption_w
integer
Current total power consumption of the household in Watts.Includes all electrical loads in the building.Example: 950

​
Solar Surplus

​
solar_surplus_w
integer
Solar power available after household consumption, in Watts. Represents excess production not consumed by the home.Example: 5300

​
Battery Status

​
battery_charge_level_percent
integer
Current battery charge level in percent.Returns null or 0 if no battery is connected.Example: 85Range: 0-100
​
battery_charge_discharge_power_w
integer
Current battery power flow in Watts.Positive values: Battery is discharging Negative values: Battery is chargingExample: -755 (charging at 755W)
​
current_state_last_updated_at
datetime
Timestamp when the battery and inverter state was last updated from the manufacturer’s API.Use this to determine data freshness.Example: 2023-03-22T13:54:34.000Z

​
Usage Examples

​
Get Inverter State

curl -X GET \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/inverters/{device_id}' \
  -H 'Authorization: Bearer {auth_token}' \
  -H 'Accept: application/json'

​
Understanding Power Flows

Scenario: current_solar_production_w: 8000, household_consumption_w: 1500
  • 1500W used directly in home
  • 6500W available for battery charging and grid export
  • Battery charges if below max charge limit
Battery: Charging at maximum rate Grid: Exporting excess power

​
Best Practices

  • Poll inverter state every 5-10 minutes during daylight hours
  • Reduce polling to 15-30 minutes during nighttime
  • Check current_state_last_updated_at to avoid unnecessary calls
  • Display last update timestamp for transparency
  • Show current production prominently during daylight
  • Calculate and show self-consumption percentage using current_solar_production_w and household_consumption_w
  • Highlight peak production times
  • Display battery level with charge/discharge status
  • Show power flow direction (charging/discharging)
  • Alert on unusual battery behavior
  • Track cycling patterns for health monitoring
  • Visualize power flows between solar, battery, and home
  • Calculate and display self-consumption rate
  • Provide historical energy flow analysis

Inverter Attributes

Writable parameters and configuration

Dashboard Integration

Building end-user dashboards