Lunar Energy

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
position: Provider
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
tags:
  - 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
url: https://raw.githubusercontent.com/api-evangelist/lunar-energy/refs/heads/main/apis.yml
created: '2026-05-25'
modified: '2026-05-25'
specificationVersion: '0.20'
apis:
  - aid: lunar-energy:gridshare-partner-api
    name: Gridshare Partner API
    tags:
      - Partner
      - Fleet Management
      - Virtual Power Plant
      - Flex Groups
      - Flex Events
      - Tariffs
      - Devices
      - Sites
    humanURL: https://developers.gridshare.com/reference/authentication
    properties:
      - 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: OpenAPI
        url: openapi/gridshare-partner-api-openapi.yml
    description: >-
      The Gridshare Partner API is the operator-facing surface for utilities, DER aggregators, and energy retailers to
      manage residential distributed energy resources at fleet scale. v1 endpoints cover Sites, Devices, Telemetry,
      Operation Mode, Overlay Plans, Periodical Tariffs, Dynamic Tariffs, Flex Groups (participants and bulk
      membership), Flex Events and Flex Dispatch opt-outs, Prognoses with Diff Requests and Diff Orders,
      Counterfactuals, and on-site Visits. Authenticated via OAuth 2.0 client-credentials against Amazon Cognito; tokens
      expire after 1 hour. Regional production servers are developer-api.partner.us.mygridshare.com (US) and
      developer-api.partner.mygridshare.com (rest of world).
  - aid: lunar-energy:gridshare-customer-api
    name: Gridshare Customer API
    tags:
      - Customer
      - Home Energy Management
      - Devices
      - Telemetry
      - Topology
      - Operation Mode
      - Overlay Plans
    humanURL: https://developers.gridshare.com/reference/authentication-customer
    properties:
      - 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
      - type: OpenAPI
        url: openapi/gridshare-customer-api-openapi.yml
    description: >-
      The Gridshare Customer API is the homeowner-delegated surface for partners that need to read or control devices on
      behalf of a specific Lunar Energy customer. It implements OAuth 2.0 Authorization Code flow against the
      lunar-customer Amazon Cognito user pool with four scopes — `lunar/device.read`, `lunar/device.write`,
      `lunar/plan.read`, `lunar/plan.write`. v2 endpoints expose lightweight Site listing, Site Topology (a sensor tree
      usable to drive telemetry queries), Device listing and retrieval, Telemetry (per-sensor time-bucketed readings
      with energy_Wh_increment / energy_Wh_decrement when include=energy), Operation Mode (Simple / Schedule / Smart),
      Overlay Plans for short-term device control, and partial device updates. Production servers
      developer-api.customer.mygridshare.com.
  - aid: lunar-energy:gridshare-remote-mcp
    name: Gridshare Remote MCP Server
    tags:
      - 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.
common:
  - 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
maintainers:
  - FN: Kin Lane
    email: info@apievangelist.com
    X: apievangelist
    url: https://apievangelist.com