ZeqBattery — Storage Optimization
Battery charge/discharge optimization synchronized to grid R(t). Charge during generation surplus (R_t peaks), discharge during demand peaks (R_t troughs).
| Endpoint | POST /api/energy/battery/optimize |
| Auth | api-key |
| Rate limit | 30/min |
| Category | energy |
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
capacityKwh | number | Yes | Battery capacity in kWh. |
currentSoc | number | Yes | Current state of charge (0–1). |
gridPriceProfile | array | No | 24-hour price profile array. |
Returns
{ schedule: [{ hour, action, ratekW, soc }], savingsEstimate, cyclesUsed }
Example
curl -sS -X POST \
-H "Authorization: Bearer zsm_..." \
-H "Content-Type: application/json" \
-d '{
"capacityKwh": 0,
"currentSoc": 0,
"gridPriceProfile": []
}' \
"https://zeqsdk.com/api/energy/battery/optimize"
This protocol is a named building block — one of the operations you
compose inside a state contract. Call it directly with
the request above, or invoke it from a contract that fires on your machine's
clock. Browse the whole library at GET /api/protocols; fetch this one at
GET /api/protocols/zeq-battery.