Household action window(s) (Home+)

post/v1/optimize/cheapest-window

Request

  • Base URL: https://voltcast.com/api
  • URL: https://voltcast.com/api/v1/optimize/cheapest-window
  • Auth: HTTP bearer

Request body

zonestring required
duration_minutesinteger required
fromstring date-time
tostring date-time
countinteger
objective'cost' | 'carbon' | 'balanced'

Cost is the production default. Carbon/balanced are experimental trailing historical production-profile heuristics, not forward carbon forecasts or emissions-reduction claims.

Response

Ranked non-overlapping windows with wholesale price, user-entered bill context and source basis. Experimental carbon/balanced modes add a historical profile estimate with explicit no-forecast/no-emissions-claim metadata.

Changes

No recorded changes to this operation across all 1 revision of this API.