SolarEdge inverter via Cloud API connection
This guide describes how to connect a SolarEdge inverter to the Currentt Navigator via the SolarEdge Monitoring API. Data is retrieved via the cloud, so no local connection to the inverter is needed.
The Cloud API can only be used to read inverter data. Controlling the inverter or battery is not possible via the API. Use Modbus RTU or Modbus TCP for that purpose.
See also: For local connection, refer to the guides for Modbus RTU or Modbus TCP.
❓ When to use the Cloud API?
The Cloud API is suitable when:
- No local (physical) access to the inverter is available
- Remote monitoring is desired
The Cloud API has a delay of 10-15 minutes and is read-only. For real-time data or inverter control, use Modbus RTU or Modbus TCP.
Read-only: Via the SolarEdge Monitoring API, the inverter can only be read. It is not possible to control the inverter, limit power, or change settings via the API. Battery control is also not possible via the API. Control of the inverter and battery is only possible via a local Modbus connection (RTU or TCP).
📌 Prerequisites
- SolarEdge inverter that is commissioned and connected to the SolarEdge monitoring platform
- Internet connection on the inverter (via Ethernet, WiFi, or cellular network)
- An account on the SolarEdge monitoring portal (
https://monitoring.solaredge.com) - Admin access to the portal (to create an API key)
1️⃣ Step 1: Verify the inverter is online
The inverter must be sending data to the SolarEdge monitoring servers. Verify this as follows:
- Go to
https://monitoring.solaredge.comand log in - Select your site
- Check if recent data is visible in the dashboard
- Check if the communication status is green
If the inverter is not online, check whether the server connection is correctly configured. The inverter sends data via Ethernet, WiFi, or a cellular connection to the SolarEdge servers.
2️⃣ Step 2: Note the Site ID
You need the Site ID for the API. You can find it as follows:
- Log in at
https://monitoring.solaredge.com - Navigate to your site
- Look at the URL bar of your browser: the number in the URL is your Site ID
- Example:
https://monitoring.solaredge.com/solaredge-web/p/site/123456/-> Site ID = 123456
- Example:
3️⃣ Step 3: Create an API key
Site API key (access to 1 site)
- Log in at
https://monitoring.solaredge.com - Click Admin in the top navigation bar
- Go to Site Access > Access Control
- Scroll to the API Access heading
- Check the agreement checkbox ("I have read, understood...")
- Click Save and confirm the popup
- Copy the generated API key
Account API key (access to all sites)
An Account API key provides access to all sites within an account. This is available for installer accounts:
- Log in at
https://monitoring.solaredge.com - Go to Admin > Account Details
- Generate an Account Level API Key
Creating a new API key invalidates the previous one. Existing integrations using the old key will stop working.
4️⃣ Step 4: Test the API
Test whether the API key works by opening the following URL in your browser (replace the values):
https://monitoringapi.solaredge.com/site/{SITE_ID}/overview?api_key={API_KEY}
You should receive a JSON response containing, among other things:
- currentPower - the current power (W)
- lastDayData - energy from today (Wh)
- lastMonthData - energy from this month (Wh)
- lifeTimeData - total energy (Wh)
5️⃣ Step 5: Configuration in the Currentt Navigator
After obtaining the API key, the device must be added in the Currentt Navigator. This can be done in two ways:
🪄 Via the setup wizard (recommended)
- Click the settings icon (top right of the screen)
- Choose Setup Wizard
- Follow the on-screen steps
The setup wizard guides you step by step through the complete configuration process.
⚙️ Manual configuration
- Click the settings icon (top right of the screen)
- Go to Components
- Click the + button in the Inverters section
- Select SolarEdge
- Under Communication, select API and fill in the following details:
| Parameter | Value |
|---|---|
| Site ID | (your Site ID, e.g. 123456) |
| API key | (your API key) |
📋 Summary
| Parameter | Value |
|---|---|
| API Base URL | https://monitoringapi.solaredge.com |
| Authentication | API key as query parameter (api_key=...) |
| Site ID | Found in the URL of the monitoring portal |
| Data latency | 10-15 minutes |
| Max requests/day | 300 |
| Data format | JSON |
| Firmware requirement | None (API is independent of local firmware) |
| Internet required | Yes (inverter and Navigator) |