Skip to main content

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).

EndpointPOST /api/energy/battery/optimize
Authapi-key
Rate limit30/min
Categoryenergy

Parameters

NameTypeRequiredDescription
capacityKwhnumberYesBattery capacity in kWh.
currentSocnumberYesCurrent state of charge (0–1).
gridPriceProfilearrayNo24-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.