API Reference · Enterprise · Storage

Storage Revenue Stack & Flexibility Value API

Forward BESS revenue across DAM, RTM, ancillary services and DSM avoidance, for any asset, any node, any duration. Probabilistic by design; replayable by model version.

Status: roadmap · ETA 2027 Q1

Endpoints respond with 501 until launch. Layered onto the same backbone as the Curtailment & Capture-Rate API — capture rates feed directly into revenue projections. Product overview.

Overview

Five endpoints cover the BESS underwriting workflow — from a forward-curve lookup to a full-stack dispatch co-optimisation. Every response carries model_version; investors can replay any past projection against any later model.

Authentication

X-API-Key header, Enterprise tier. See energymap.in/pricing.

POST /v1/storage/revenue-stack

bash

curl -X POST https://api.energymap.in/v1/storage/revenue-stack \
  -H 'X-API-Key: $KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "asset": { "capacity_mw": 100, "duration_hr": 4, "location_node": "node-Bhadla-PS1" },
    "market_mix": { "dam": true, "rtm": true, "asm": true, "dsm_avoidance": true },
    "horizon_years": 15
  }'

json

{
  "asset": { "capacity_mw": 100, "duration_hr": 4, "location_node": "node-Bhadla-PS1" },
  "model_version": "srs-v0.2",
  "annual_revenue_inr_per_kw_year": [
    { "year": 2027, "p50": 3200, "p10": 2800, "p90": 3600,
      "by_market": { "dam": 0.62, "rtm": 0.18, "asm": 0.15, "dsm_avoidance": 0.05 } }
  ]
}

POST /v1/storage/optimal-duration

Solve dispatch for 1hr / 2hr / 4hr / 8hr at the same node. Returns revenue per MWh of storage and IRR on each — sizing as a markets decision, not a hardware default.

GET /v1/market/forward-curve/{node}

Forward 15-min price curve at a node, with confidence bands.

POST /v1/dispatch/co-optimisation

Co-optimised dispatch across DAM, RTM, ASM, and DSM avoidance, with per-market attribution.

GET /v1/ancillary/clearing-prices

ASM clearing-price history and forecast. Use for revenue modelling and ASM-specific bid sizing.