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
  [email protected].
type: Index
position: Provider
access: 3rd-Party
image: https://kinlane-productions2.s3.amazonaws.com/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
      - type: NaftikoCapability
        url: capabilities/gridshare-partner-sites.yaml
      - type: NaftikoCapability
        url: capabilities/gridshare-partner-devices.yaml
      - type: NaftikoCapability
        url: capabilities/gridshare-partner-flex-groups.yaml
      - type: NaftikoCapability
        url: capabilities/gridshare-partner-flex-events.yaml
      - type: NaftikoCapability
        url: capabilities/gridshare-partner-tariffs.yaml
      - type: NaftikoCapability
        url: capabilities/gridshare-partner-visits.yaml
    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
      - type: NaftikoCapability
        url: capabilities/gridshare-customer-devices.yaml
      - type: NaftikoCapability
        url: capabilities/gridshare-customer-sites.yaml
      - type: NaftikoCapability
        url: capabilities/gridshare-customer-plans.yaml
    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: [email protected]
    url: mailto:[email protected]
  - type: Support
    name: [email protected]
    url: mailto:[email protected]
  - 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: [email protected]
    X: apievangelist
    url: https://apievangelist.com