Lunar Energy is a Mountain View, California residential clean-energy company founded in August 2020 by former Tesla Energy executive Kunal Girotra. The company sells the Lunar System — a modular 15–30 kWh home battery (9.6 kW continuous / 15 kW peak), Lunar Inverter, Lunar Maximizers, Lunar Bridge, and Eaton AbleEdge smart breakers — controlled by the Lunar App with Lunar AI optimization. Its Gridshare platform is a grid-edge DERMS and virtual power plant engine that manages 130,000+ residential distributed energy resources representing 1.2 GWh of connected storage across multiple manufacturers and third-party operators.
URL: Visit APIs.yml
Run: Capabilities Using Naftiko
- Energy, Home Battery, Solar, Virtual Power Plant, DERMS, Distributed Energy Resources, Grid Services, Demand Response, Storage, Inverter, Smart Home, Energy Management, Tariffs, Telemetry, VPP, Flex Events
- Created: 2026-05-25
- Modified: 2026-05-25
The operator-facing surface for utilities, retailers, and DER aggregators managing residential distributed energy resources at fleet scale. Covers Sites, Devices, Telemetry, Operation Mode, Overlay Plans, Periodical Tariffs, Dynamic Tariffs, Flex Groups, Flex Events, Flex Dispatches, Prognoses with Diff Requests and Diff Orders, Counterfactuals, and on-site Visits. OAuth 2.0 client-credentials against an Amazon Cognito user pool.
Human URL: https://developers.gridshare.com/reference/authentication
- Documentation — Authentication
- Documentation — Fleet Management
- Documentation — Virtual Power Plants
- OpenAPI
- Naftiko Capability — Sites
- Naftiko Capability — Devices
- Naftiko Capability — Flex Groups
- Naftiko Capability — Flex Events
- Naftiko Capability — Tariffs
- Naftiko Capability — Visits
The homeowner-delegated surface that lets partner apps read or control devices on behalf of a specific Lunar Energy customer once consent has been granted via OAuth 2.0 Authorization Code flow against the lunar-customer Cognito pool. v2 endpoints cover Sites, Site Topology, Devices, Telemetry, Operation Mode, and Overlay Plans. Four scopes: lunar/device.read, lunar/device.write, lunar/plan.read, lunar/plan.write.
Human URL: https://developers.gridshare.com/reference/authentication-customer
- Documentation — Customer Authentication
- Documentation — Topology Key Concepts
- Documentation — Telemetry Key Concepts
- Documentation — Home Energy Management
- OpenAPI
- Naftiko Capability — Sites
- Naftiko Capability — Devices
- Naftiko Capability — Plans
Gridshare publishes a remote Model Context Protocol (MCP) server that exposes the Customer API as MCP tools for AI agents. Authenticated with the same Cognito-issued bearer tokens as the Customer API.
Human URL: https://developers.gridshare.com/reference/customer-remote-mcp
- Website — lunarenergy.com
- Portal — gridshare.com
- Portal — Gridshare Developer Portal
- Documentation — API Reference
- GettingStarted
- Product — Lunar System (Home Battery)
- Product — Gridshare DERMS / VPP
- Documentation — Installer Hub
- Documentation — Telemetry Key Concepts
- Documentation — Topology Key Concepts
- Documentation — Fleet Management
- Documentation — Home Energy Management
- Documentation — Virtual Power Plants
- Documentation — WebSocket Connections
- Documentation — Remote MCP
- Support — developers@gridshare.com
- Support — business@lunarenergy.com
- Contact
- Careers
- YouTube
- GitHubOrganization
Machine-readable API specifications organized by format.
Partner API:
Customer API:
FN: Kin Lane
Email: info@apievangelist.com