Skip to content

Services

All services are registered under the kilowahti domain. When only one Kilowahti instance is configured, config_entry_id can be omitted.

Price query services

All price query services accept a formatted parameter (default true). When false, prices are returned as raw c/kWh at full precision regardless of your display unit setting.

kilowahti.get_active_prices

Returns all price slots for today and tomorrow (default), or a custom time range.

service: kilowahti.get_active_prices
data: {}

service: kilowahti.get_active_prices
data:
  start: "2026-03-10T00:00:00"
  end: "2026-03-10T23:59:59"
  formatted: false

Response: 

{
  "unit": "c/kWh",
  "price_periods": [
    {
      "time": "2026-03-10T00:00:00+02:00",
      "price": 4.32,
      "total_price": 6.87,
      "rank": 3,
      "is_fixed": false
    }
  ]
}

kilowahti.get_prices

Returns raw spot price slots for a time range.

service: kilowahti.get_prices
data:
  start: "2026-03-10T00:00:00"
  end: "2026-03-10T23:59:59"

kilowahti.cheapest_hours

Finds the cheapest consecutive window of a given length within a time range.

service: kilowahti.cheapest_hours
data:
  start: "2026-03-10T18:00:00"
  end: "2026-03-11T08:00:00"
  hours: 3

Response: 

{
  "start": "2026-03-10T22:00:00+02:00",
  "end": "2026-03-11T00:45:00+02:00",
  "average_price": 3.21,
  "unit": "c/kWh",
  "price_periods": [...]
}

Scheduling appliances at the cheapest time

Call this service once per day (e.g. at 17:00 after tomorrow's prices arrive), store the result in an input_datetime helper, and trigger your automation at that time.

alias: Find cheapest 3-hour window overnight
trigger:
  - platform: time
    at: "17:00:00"
action:
  - service: kilowahti.cheapest_hours
    data:
      start: "{{ now() }}"
      end: "{{ (now() + timedelta(hours=15)).isoformat() }}"
      hours: 3
    response_variable: result
  - service: input_datetime.set_datetime
    data:
      timestamp: "{{ result['start'] }}"
    target:
      entity_id: input_datetime.cheapest_window_start

Then use a separate automation triggered by input_datetime.cheapest_window_start to turn on your appliance.

kilowahti.average_price

Returns aggregate price statistics for a time range.

service: kilowahti.average_price
data:
  start: "2026-03-10T00:00:00"
  end: "2026-03-10T23:59:59"

Response: 

{
  "average_price": 5.14,
  "min_price": 1.23,
  "max_price": 12.87,
  "unit": "c/kWh",
  "slot_count": 96
}

Fixed-period management services

kilowahti.add_fixed_period

Adds a fixed-price contract period. Periods cannot overlap.

service: kilowahti.add_fixed_period
data:
  label: "Winter fixation"
  start_date: "2026-01-01"
  end_date: "2026-03-31"
  price: 8.5

Note

price is entered gross (VAT included). It is used as-is — no VAT is added.

kilowahti.remove_fixed_period

Removes a fixed-price period by its ID (returned by list_fixed_periods).

service: kilowahti.remove_fixed_period
data:
  period_id: "3f4a1b2c-..."

kilowahti.list_fixed_periods

Lists all configured fixed-price periods.

service: kilowahti.list_fixed_periods
data: {}