aid: lunar-energy name: Lunar Energy description: >- Lunar Energy is a Mountain View, California-based residential clean-energy company founded in August 2020 by former Tesla Energy executive Kunal Girotra. The company designs and manufactures the Lunar System — a modular home battery (15–30 kWh, 9.6 kW continuous / 15 kW peak), Lunar Inverter, Lunar Maximizers (module-level power optimizers), Lunar Bridge meter socket adapter, and Eaton AbleEdge smart-breaker integration — controlled by the Lunar App with Lunar AI optimization. Its Gridshare platform is a grid-edge DERMS (Distributed Energy Resource Management System) 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. Gridshare powers utility demand response and VPP programs through flex groups, flex dispatches, prognoses, dynamic and periodical tariffs, and per-device remote operation-mode control. Lunar Energy is backed by SunPower and Sunrun partnerships; SoftBank Energy is a major investor. The Gridshare Partner API and Customer API are gated behind business onboarding — credentials are issued by Lunar Energy after contacting developers@gridshare.com. type: Index deliveryModel: model: saas open_source: false commercial: true callable_host: false label: Hosted service · you call their endpoint confidence: medium source: - openapi - pricing generated: '2026-08-28' method: derived accessModel: pricing: unknown onboarding: self-serve trial: false try_now: false public: false label: Self-serve signup confidence: high source: - plans - authentication generated: '2026-07-22' method: derived position: Producing access: 3rd-Party image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/lunar-energy.png x-docs-platform: readme x-docs-platform-confidence: high x-docs-platform-checked: 2026-10-03 tags: - Energy - Home Battery - Solar - Virtual Power Plant - DERMS - Distributed Energy Resources - Grid Services - Demand Response - Storage - Inverters - Smart Home - Energy Management - Tariffs - Telemetry - VPP - Flex Events - Energy Storage tags_raw: - 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 - Energy Storage url: https://raw.githubusercontent.com/api-evangelist/lunar-energy/refs/heads/main/apis.yml created: '2026-05-25' modified: '2026-05-25' specificationVersion: '0.23' apis: - aid: lunar-energy:gridshare-remote-mcp name: Gridshare Remote MCP Server tags: - MCP - Remote MCP - AI Agents - Customers tags_raw: - MCP - Model Context Protocol - Remote MCP - AI Agents - Customer humanURL: https://developers.gridshare.com/reference/customer-remote-mcp properties: - type: Documentation url: https://developers.gridshare.com/reference/customer-remote-mcp description: >- 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. - aid: lunar-energy:lunar-energy-devices-api name: Lunar Energy Devices API description: List, get, and partially update customer devices humanURL: https://developers.gridshare.com/reference/authentication tags: - Devices properties: - type: OpenAPI url: openapi/lunar-energy-devices-api-openapi.yml - type: Documentation url: https://developers.gridshare.com/reference/authentication - type: Documentation url: https://developers.gridshare.com/reference/fleet-management - type: Documentation url: https://developers.gridshare.com/reference/vpp - type: Documentation url: https://developers.gridshare.com/reference/authentication-customer - type: Documentation url: https://developers.gridshare.com/reference/topology-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/telemetry-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/energy-management - aid: lunar-energy:lunar-energy-diff-requests-api name: Lunar Energy Diff Requests API description: Request and commit differential adjustments to a prognosis humanURL: https://developers.gridshare.com/reference/authentication tags: - Diff Requests properties: - type: OpenAPI url: openapi/lunar-energy-diff-requests-api-openapi.yml - type: Documentation url: https://developers.gridshare.com/reference/authentication - type: Documentation url: https://developers.gridshare.com/reference/fleet-management - type: Documentation url: https://developers.gridshare.com/reference/vpp - type: Documentation url: https://developers.gridshare.com/reference/authentication-customer - type: Documentation url: https://developers.gridshare.com/reference/topology-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/telemetry-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/energy-management - aid: lunar-energy:lunar-energy-dynamic-tariffs-api name: Lunar Energy Dynamic Tariffs API description: Manage dynamic time-series tariffs with 7-day pagination humanURL: https://developers.gridshare.com/reference/authentication tags: - Dynamic Tariffs properties: - type: OpenAPI url: openapi/lunar-energy-dynamic-tariffs-api-openapi.yml - type: Documentation url: https://developers.gridshare.com/reference/authentication - type: Documentation url: https://developers.gridshare.com/reference/fleet-management - type: Documentation url: https://developers.gridshare.com/reference/vpp - type: Documentation url: https://developers.gridshare.com/reference/authentication-customer - type: Documentation url: https://developers.gridshare.com/reference/topology-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/telemetry-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/energy-management - aid: lunar-energy:lunar-energy-flex-dispatches-api name: Lunar Energy Flex Dispatches API description: Opt participants out of an active flex dispatch humanURL: https://developers.gridshare.com/reference/authentication tags: - Flex Dispatches properties: - type: OpenAPI url: openapi/lunar-energy-flex-dispatches-api-openapi.yml - type: Documentation url: https://developers.gridshare.com/reference/authentication - type: Documentation url: https://developers.gridshare.com/reference/fleet-management - type: Documentation url: https://developers.gridshare.com/reference/vpp - type: Documentation url: https://developers.gridshare.com/reference/authentication-customer - type: Documentation url: https://developers.gridshare.com/reference/topology-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/telemetry-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/energy-management - aid: lunar-energy:lunar-energy-flex-events-api name: Lunar Energy Flex Events API description: Schedule and update flex events for a flex group humanURL: https://developers.gridshare.com/reference/authentication tags: - Flex Events properties: - type: OpenAPI url: openapi/lunar-energy-flex-events-api-openapi.yml - type: Documentation url: https://developers.gridshare.com/reference/authentication - type: Documentation url: https://developers.gridshare.com/reference/fleet-management - type: Documentation url: https://developers.gridshare.com/reference/vpp - type: Documentation url: https://developers.gridshare.com/reference/authentication-customer - type: Documentation url: https://developers.gridshare.com/reference/topology-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/telemetry-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/energy-management - aid: lunar-energy:lunar-energy-flex-groups-api name: Lunar Energy Flex Groups API description: Define and manage groups of DERs participating in flex programs humanURL: https://developers.gridshare.com/reference/authentication tags: - Flex Groups properties: - type: OpenAPI url: openapi/lunar-energy-flex-groups-api-openapi.yml - type: Documentation url: https://developers.gridshare.com/reference/authentication - type: Documentation url: https://developers.gridshare.com/reference/fleet-management - type: Documentation url: https://developers.gridshare.com/reference/vpp - type: Documentation url: https://developers.gridshare.com/reference/authentication-customer - type: Documentation url: https://developers.gridshare.com/reference/topology-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/telemetry-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/energy-management - aid: lunar-energy:lunar-energy-operation-mode-api name: Lunar Energy Operation Mode API description: Read or change the Gridshare operation mode of a device humanURL: https://developers.gridshare.com/reference/authentication tags: - Operation Mode properties: - type: OpenAPI url: openapi/lunar-energy-operation-mode-api-openapi.yml - type: Documentation url: https://developers.gridshare.com/reference/authentication - type: Documentation url: https://developers.gridshare.com/reference/fleet-management - type: Documentation url: https://developers.gridshare.com/reference/vpp - type: Documentation url: https://developers.gridshare.com/reference/authentication-customer - type: Documentation url: https://developers.gridshare.com/reference/topology-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/telemetry-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/energy-management - aid: lunar-energy:lunar-energy-periodical-tariffs-api name: Lunar Energy Periodical Tariffs API description: Manage periodical (recurring) tariffs humanURL: https://developers.gridshare.com/reference/authentication tags: - Periodical Tariffs properties: - type: OpenAPI url: openapi/lunar-energy-periodical-tariffs-api-openapi.yml - type: Documentation url: https://developers.gridshare.com/reference/authentication - type: Documentation url: https://developers.gridshare.com/reference/fleet-management - type: Documentation url: https://developers.gridshare.com/reference/vpp - type: Documentation url: https://developers.gridshare.com/reference/authentication-customer - type: Documentation url: https://developers.gridshare.com/reference/topology-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/telemetry-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/energy-management - aid: lunar-energy:lunar-energy-plans-api name: Lunar Energy Plans API description: Read or set overlay plans for short-term device dispatch humanURL: https://developers.gridshare.com/reference/authentication tags: - Plans properties: - type: OpenAPI url: openapi/lunar-energy-plans-api-openapi.yml - type: Documentation url: https://developers.gridshare.com/reference/authentication - type: Documentation url: https://developers.gridshare.com/reference/fleet-management - type: Documentation url: https://developers.gridshare.com/reference/vpp - type: Documentation url: https://developers.gridshare.com/reference/authentication-customer - type: Documentation url: https://developers.gridshare.com/reference/topology-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/telemetry-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/energy-management - aid: lunar-energy:lunar-energy-prognoses-api name: Lunar Energy Prognoses API description: Forecasted aggregate power profiles for flex groups humanURL: https://developers.gridshare.com/reference/authentication tags: - Prognoses properties: - type: OpenAPI url: openapi/lunar-energy-prognoses-api-openapi.yml - type: Documentation url: https://developers.gridshare.com/reference/authentication - type: Documentation url: https://developers.gridshare.com/reference/fleet-management - type: Documentation url: https://developers.gridshare.com/reference/vpp - type: Documentation url: https://developers.gridshare.com/reference/authentication-customer - type: Documentation url: https://developers.gridshare.com/reference/topology-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/telemetry-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/energy-management - aid: lunar-energy:lunar-energy-sites-api name: Lunar Energy Sites API description: List sites and read site topology humanURL: https://developers.gridshare.com/reference/authentication tags: - Sites properties: - type: OpenAPI url: openapi/lunar-energy-sites-api-openapi.yml - type: Documentation url: https://developers.gridshare.com/reference/authentication - type: Documentation url: https://developers.gridshare.com/reference/fleet-management - type: Documentation url: https://developers.gridshare.com/reference/vpp - type: Documentation url: https://developers.gridshare.com/reference/authentication-customer - type: Documentation url: https://developers.gridshare.com/reference/topology-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/telemetry-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/energy-management - aid: lunar-energy:lunar-energy-telemetry-api name: Lunar Energy Telemetry API description: Time-bucketed per-sensor telemetry readings humanURL: https://developers.gridshare.com/reference/authentication tags: - Telemetry properties: - type: OpenAPI url: openapi/lunar-energy-telemetry-api-openapi.yml - type: Documentation url: https://developers.gridshare.com/reference/authentication - type: Documentation url: https://developers.gridshare.com/reference/fleet-management - type: Documentation url: https://developers.gridshare.com/reference/vpp - type: Documentation url: https://developers.gridshare.com/reference/authentication-customer - type: Documentation url: https://developers.gridshare.com/reference/topology-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/telemetry-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/energy-management - aid: lunar-energy:lunar-energy-visits-api name: Lunar Energy Visits API description: Record on-site visits for installation or service humanURL: https://developers.gridshare.com/reference/authentication tags: - Visits properties: - type: OpenAPI url: openapi/lunar-energy-visits-api-openapi.yml - type: Documentation url: https://developers.gridshare.com/reference/authentication - type: Documentation url: https://developers.gridshare.com/reference/fleet-management - type: Documentation url: https://developers.gridshare.com/reference/vpp - type: Documentation url: https://developers.gridshare.com/reference/authentication-customer - type: Documentation url: https://developers.gridshare.com/reference/topology-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/telemetry-key-concepts - type: Documentation url: https://developers.gridshare.com/reference/energy-management common: - type: CapabilityMap url: capabilities/lunar-energy-capability-edges.yml name: Lunar Energy Business Capability Map - type: AgenticAccess url: agentic-access/lunar-energy-agentic-access.yml - type: TrustCenter url: security/lunar-energy-trust-center.yml - type: DomainSecurity url: security/lunar-energy-domain-security.yml - type: Authentication url: authentication/lunar-energy-authentication.yml - type: OAuthScopes url: scopes/lunar-energy-scopes.yml - type: Website url: https://www.lunarenergy.com - type: Portal url: https://www.gridshare.com - type: Portal name: Gridshare Developer Portal url: https://developers.gridshare.com - type: Documentation url: https://developers.gridshare.com/reference - type: GettingStarted url: https://developers.gridshare.com/reference/authentication - type: Product name: Lunar System (Home Battery) url: https://www.lunarenergy.com/lunar-system - type: Product name: Gridshare DERMS / VPP url: https://www.gridshare.com - type: Documentation name: Installer Hub url: https://installerhub.lunarenergy.com - type: Documentation name: Telemetry Key Concepts url: https://developers.gridshare.com/reference/telemetry-key-concepts - type: Documentation name: Topology Key Concepts url: https://developers.gridshare.com/reference/topology-key-concepts - type: Documentation name: Fleet Management url: https://developers.gridshare.com/reference/fleet-management - type: Documentation name: Home Energy Management url: https://developers.gridshare.com/reference/energy-management - type: Documentation name: Virtual Power Plants url: https://developers.gridshare.com/reference/vpp - type: Documentation name: WebSocket Connections url: https://developers.gridshare.com/reference/websocket-connection - type: Documentation name: Remote MCP url: https://developers.gridshare.com/reference/customer-remote-mcp - type: Support name: developers@gridshare.com url: mailto:developers@gridshare.com - type: Support name: business@lunarenergy.com url: mailto:business@lunarenergy.com - type: Contact url: https://www.lunarenergy.com/contact - type: Careers url: https://www.lunarenergy.com/careers - type: LinkedIn url: https://www.linkedin.com/company/lunar-energy - type: Twitter url: https://twitter.com/Lunar_Energy - type: YouTube url: https://www.youtube.com/@lunar_energy - type: GitHubOrganization url: https://github.com/lunarenergy - type: Features data: - Lunar System home battery — 15–30 kWh modular wall-mounted tower - 9.6 kW continuous / 15 kW peak (5s) per battery; 12.5-year warranty - Lunar Inverter and Lunar Maximizers (650 W module-level power optimizers) - Lunar Bridge (200 A meter socket adapter) connects the home to the grid - Eaton AbleEdge smart breakers for automatic load-shedding during outages - Lunar App for real-time monitoring and control - Lunar AI generates daily energy plans from utility rates, weather, and home patterns - Solar-ready — Maximizers attach to existing panels without relocation - Virtual Power Plant participation — earn revenue by sharing storage with the grid - Gridshare DERMS manages 130,000+ residential DERs and 1.2 GWh of storage - Multi-vendor support — Gridshare manages devices from different manufacturers and 3rd-party operators - Partner API for fleet operators (utilities, retailers, DER aggregators) - Customer API for app developers acting on behalf of homeowners - OAuth 2.0 — client-credentials for Partner, Authorization Code for Customer - Per-device Operation Mode — Simple, Schedule, Smart (AI-optimized), Unknown - Overlay Plans for short-term device dispatch - Periodical Tariffs and Dynamic Tariffs (7-day pagination windows) - Flex Groups, Flex Events, Flex Dispatches, and Flex Dispatch opt-outs - Prognoses, Prognosis Diff Requests, and Diff Orders for coordinated network flex - Counterfactual telemetry — what the device would have done un-managed - WebSocket telemetry streams - Remote MCP server exposes the Customer API as agent tools - Octopus Energy partnership — battery electricity plans in Texas - Sunrun and SunPower installer Okta SSO sources: - https://www.lunarenergy.com - https://www.gridshare.com - https://developers.gridshare.com - https://www.lunarenergy.com/lunar-system - https://developers.gridshare.com/llms.txt updated: '2026-05-25' - type: Plans url: plans/lunar-energy-plans-pricing.yml - type: RateLimits url: rate-limits/lunar-energy-rate-limits.yml - type: FinOps url: finops/lunar-energy-finops.yml - url: https://www.lunarenergy.com/blog type: Blog maintainers: - FN: Kin Lane email: info@apievangelist.com X: apievangelist url: https://apievangelist.com