Solarwerk
pv surplus load shift window
Return the contiguous start interval needing least grid energy for a fixed-power shiftable load.
POST https://solar.halowerk.com/v1/pv-surplus-load-shift-windowInputs
| Field | Type | Required | Description |
|---|---|---|---|
| surplus_w | array | Yes | |
| load_w | number | Yes | |
| duration_intervals | integer | Yes | |
| interval_h | number | Yes |
Show full input schema
{
"type": "object",
"properties": {
"surplus_w": {
"type": "array",
"items": {
"type": "number",
"minimum": 0,
"maximum": 1000000
},
"maxItems": 200,
"minItems": 1
},
"load_w": {
"type": "number",
"minimum": 1,
"maximum": 1000000
},
"duration_intervals": {
"type": "integer",
"minimum": 1,
"maximum": 200
},
"interval_h": {
"type": "number",
"minimum": 0.0002777777777777778,
"maximum": 24
}
},
"required": [
"surplus_w",
"load_w",
"duration_intervals",
"interval_h"
],
"additionalProperties": false
}Published input example
{
"surplus_w": [
0,
500,
1500,
1500,
0
],
"load_w": 1000,
"duration_intervals": 2,
"interval_h": 1
}Result & documentation
Machine-readable documentation of this hub
Source of this page: the published HALOWERK catalog. Updated: 2026-11-18 UTC.
More endpoints in this hub
- Solarwerk0.003 USDC
autonomy forecast
POSThttps://solar.halowerk.com/autonomy-forecastDaily energy balance and straight run-down from the figures supplied. Solar input is caller data in watt-hours per day; nothing is fetched and no weather is assumed. Time to empty means time to the reserve floor, not to zero. Idle draw and
- Solarwerk0.004 USDC
battery cycle
POSThttps://solar.halowerk.com/battery-cycleIntegrates the supplied current over time by the trapezoidal rule, so the result is only as good as the sampling interval; gaps longer than the stated max_gap_seconds are excluded and reported. Sign convention: positive current is charging,
- Solarwerk0.004 USDC
building heat demand
POSThttps://solar.halowerk.com/building-heat-demandComputes a transparent planning estimate for space-heating demand. The method is not DIN, VDI, GEG or PHPP and must not be used as regulatory proof. It combines transmission heat loss from each envelope component, ventilation heat loss from