Skip to content

Tibber Binding ​

The Tibber Binding retrieves prices from the Tibber API. If you have Tibber Pulse hardware, you can also use the live group and statistics group. Historical energy data (consumption, cost, and production) is available in the history group for all users.

Supported Things ​

TypeIDDescription
ThingtibberapiConnection to Tibber API

Thing Configuration ​

NameTypeDescriptionDefaultRequired
tokentextTibber Personal TokenN/Ayes
homeidtextTibber Home IDN/Ayes
updateHourintegerLocal hour when spot prices are updated13yes

Note: The Tibber token is retrieved from your Tibber account: Tibber Account

Note: The Tibber Home ID is retrieved from developer.tibber.com:

  • Sign in (Tibber user account) and "load" personal token.
  • Copy query from below and paste into the Tibber API Explorer, and run query.
  • If Tibber Pulse is connected, the Tibber API Explorer will report "true" for "realTimeConsumptionEnabled"
  • Copy the Home ID from the Tibber API Explorer, without quotation marks, and use it in the binding configuration.
graphql
{
  viewer {
    homes {
      id
      features {
        realTimeConsumptionEnabled
      }
    }
  }
}

If you have multiple Home IDs/Pulse devices, create separate Things for each Home ID.

Channels ​

price group ​

Current and forecast Tibber price information. All values are read-only.

Channel IDTypeDescriptionTime Series
totalNumber:EnergyPriceTotal price including energy and taxesyes
spotNumber:EnergyPriceSpot prices for energy today and tomorrowyes
taxNumber:EnergyPriceTaxes and additional expensesyes
levelNumberPrice levels for today and tomorrowyes
averageNumber:EnergyPriceAverage price from last 24 hoursyes

Channel spot-price is deprecated and will be removed in the next major update. It's still available as an advanced channel. The naming was misleading as it reflected the total price and not the Nord Pool spot price used by Tibber.

The level number maps the Tibber Rating into numbers. Zero reflects normal price, while values above 0 are expensive and values below 0 are cheap.

Mapping:

  • Very Cheap: -2
  • Cheap: -1
  • Normal: 0
  • Expensive: 1
  • Very Expensive: 2

The average values are not delivered by the Tibber API. They are calculated by the binding to provide a trend line for the last 24 hours. After the initial setup, the average values will remain NULL until the next day because the previous 24 h prices cannot be obtained by the Tibber API.

Please note that time series are not supported by the default rrd4j persistence. The items connected to the above channels need to be stored in, e.g., InfluxDB or InMemory.

Trigger Channels ​

Channel event can trigger the following events:

EventDescription
DAY_AHEAD_AVAILABLEDay-ahead prices are available

live group ​

Live information from Tibber Pulse. All values are read-only.

Channel IDTypeDescription
consumptionNumber:PowerConsumption at the moment in watts
minimum-consumptionNumber:PowerMinimum power consumption since midnight in watts
peak-consumptionNumber:PowerPeak power consumption since midnight in watts
average-consumptionNumber:PowerAverage power consumption since midnight in watts
productionNumber:PowerNet power production at the moment in watts
minimum-productionNumber:PowerMinimum net power production since midnight in watts
peak-productionNumber:PowerMaximum net power production since midnight in watts
power-balanceNumber:PowerCurrent power consumption (as positive value) and production (as negative value)
voltage1Number:ElectricPotentialElectric potential on phase 1
voltage2Number:ElectricPotentialElectric potential on phase 2
voltage3Number:ElectricPotentialElectric potential on phase 3
current1Number:ElectricCurrentElectric current on phase 1
current2Number:ElectricCurrentElectric current on phase 2
current3Number:ElectricCurrentElectric current on phase 3

statistics group ​

Statistical information about total, daily, and last-hour energy consumption and production. All values are read-only.

Channel IDTypeDescription
total-consumptionNumber:EnergyTotal energy consumption measured by Tibber Pulse meter
daily-consumptionNumber:EnergyEnergy consumed since midnight in kilowatt-hours
daily-costNumber:CurrencyAccumulated cost since midnight
last-hour-consumptionNumber:EnergyEnergy consumed since last hour shift in kilowatt-hours
total-productionNumber:EnergyTotal energy production measured by Tibber Pulse meter
daily-productionNumber:EnergyNet energy produced since midnight in kilowatt-hours
last-hour-productionNumber:EnergyNet energy produced since last hour shift in kilowatt-hours

history group ​

Historical energy consumption, cost, and production delivered as time series. All values are read-only.

The Tibber API only returns completed periods — for example, an annual query run in May 2026 returns data up to end of 2025. The binding automatically fills the gap for the current incomplete period by aggregating data bottom-up: daily entries are summed into the current week, weekly entries into the current month, and monthly entries into the current year. These synthetic entries are transient and will be replaced by real API data once the period closes.

Channel IDTypeDescriptionTime Series
yearly-consumptionNumber:EnergyYearly energy consumptionyes
yearly-costNumber:CurrencyYearly energy costsyes
yearly-productionNumber:EnergyYearly energy productionyes
monthly-consumptionNumber:EnergyMonthly energy consumptionyes
monthly-costNumber:CurrencyMonthly energy costsyes
monthly-productionNumber:EnergyMonthly energy productionyes
weekly-consumptionNumber:EnergyWeekly energy consumptionyes
weekly-costNumber:CurrencyWeekly energy costsyes
weekly-productionNumber:EnergyWeekly energy productionyes
daily-consumptionNumber:EnergyDaily energy consumptionyes
daily-costNumber:CurrencyDaily energy costsyes
daily-productionNumber:EnergyDaily energy productionyes

Persistence Requirement ​

History channels deliver data as time series, which is not supported by the default rrd4j persistence. Items linked to history channels must be configured with a persistence service that supports time series, such as InfluxDB or InMemory. Without a compatible persistence service, history data will not be stored correctly.

When a new item is linked to a history channel, the binding performs an initial fetch for one time window only — for example, the last year for yearly channels or the last month for monthly channels. This keeps the startup load low and avoids requesting the entire available history from the Tibber API at once.

To populate the full available history (all years, months, weeks, or days), trigger the fetchHistory Thing Action manually after linking the item.

Automatic Refresh ​

Once an item is linked, history data is refreshed automatically once per day at 01:00. A full re-fetch for any time window can also be triggered at any time via the fetchHistory Thing Action.

Thing Actions ​

Thing actions can be used to perform calculations on the currently available price information cached by the binding. The cache contains energy prices for today and, after reaching the updateHour, also for tomorrow. This helps plan when to run a device and at what cost.

Performing a calculation requires a parameters object containing, e.g., your boundaries for the calculation. The parameter object allows two types: a Java Map or a JSON String. The result is returned as a JSON-encoded String. See the sections below for the result format. If the action cannot be performed, a warning will be logged and an empty String will be returned. Some real-life scenarios are shown in the Thing Actions section.

priceInfoStart ​

Returns the starting point as an Instant of the first available energy price. Calculations must not start before this timestamp.

In case of error Instant.MAX is returned.

priceInfoEnd ​

Returns the end point as an Instant of the last available energy price. Calculations must not extend beyond this timestamp.

In case of error Instant.MIN is returned.

listPrices ​

List prices in ascending or descending price order. Use persistence extensions if you need time ordering.

Parameters ​

NameTypeDescriptionDefaultRequired
earliestStartInstantEarliest start timenowno
latestEndInstantLatest end timepriceInfoEndno
ascendingbooleanPrice sorting ordertrueno

Example ​

rules
rule "Tibber Price List"
when
    System started // use your trigger
then
    var actions = getActions("tibber","tibber:tibberapi:xyz")
    // parameters empty => default parameters are used = starting from now till end of available price information, ascending
    var parameters = "{}"
    var result = actions.listPrices(parameters)
    val numberOfPrices = transform("JSONPATH", "$.size", result)
    logInfo("TibberPriceList",result)
    for(var i=0; i<Integer.valueOf(numberOfPrices); i++) {
        // get values and convert them into correct format
        val priceString = transform("JSONPATH", "$.priceList["+i+"].price", result)
        val price = Double.valueOf(priceString)
        val startsAtString = transform("JSONPATH", "$.priceList["+i+"].startsAt", result)
        val startsAt = Instant.parse(startsAtString)
        logInfo("TibberPriceList","PriceInfo "+i+" : " + price + " Starts at : " + startsAt.atZone(ZoneId.systemDefault()))
    }
end

Console output ​

text
2025-05-29 15:52:31.345 [INFO ] [ab.core.model.script.TibberPriceList] - PriceInfo 0 : 0.1829 Starts at : 2025-05-30T13:00+02:00[Europe/Berlin]
2025-05-29 15:52:31.349 [INFO ] [ab.core.model.script.TibberPriceList] - PriceInfo 1 : 0.183 Starts at : 2025-05-30T14:00+02:00[Europe/Berlin]
2025-05-29 15:52:31.352 [INFO ] [ab.core.model.script.TibberPriceList] - PriceInfo 2 : 0.1842 Starts at : 2025-05-29T15:52:31.341193101+02:00[Europe/Berlin]
...

Result ​

JSON-encoded String result with keys

KeyTypeDescription
sizeintSize of price list
priceListJSON arrayArray of priceInfo entries

JSON Object priceInfo

KeyTypeDescription
startsAtStringString encoded Instant
durationintPrice duration in seconds
pricedoublePrice in your currency

Example ​

json
{
    "size": 4,
    "priceList": [
        {
            "price": 0.1623,
            "duration": 3600,
            "level": -1,
            "startsAt": "2025-06-01T12:00:00Z"
        },
        {
            "price": 0.168,
            "duration": 3600,
            "level": -1,
            "startsAt": "2025-06-01T13:00:00Z"
        },
        {
            "price": 0.1712,
            "duration": 3600,
            "level": -1,
            "startsAt": "2025-06-01T11:00:00Z"
        },
        {
            "price": 0.1794,
            "duration": 3600,
            "level": -1,
            "startsAt": "2025-06-01T14:00:00Z"
        }
    ]
}

bestPricePeriod ​

Calculates the lowest cost for a consecutive period. For use cases like a dishwasher or laundry.

Parameters ​

NameTypeDescriptionDefaultRequired
earliestStartInstantEarliest start timenowno
latestStopInstantLatest end timepriceInfoEndno
powerintPower in wattsN/Ano
durationStringDuration as String with units h,m or sN/Atrue
curveJsonArrayArray with curveEntry elementsN/Ano

Provide either

  • power and duration for constant consumption or
  • curve for sophisticated use cases like a recorded laundry power time series

JSON Object curveEntry

KeyTypeDescription
timestampStringString encoded Instant
powerintPower in watts
durationintDuration in seconds

Example ​

rules
import java.util.Map;

var Timer bestPriceTimer = null

rule "Tibber Best Price"
when
    System started // use your trigger
then
    // get actions
    var actions = getActions("tibber","tibber:tibberapi:xyz")
    //create parameters for calculation
    var parameters = Map.of("duration", "1 h 34 m")
    // perform calculation
    var result = actions.bestPricePeriod(parameters)
    // log result, no prices given because no power value given
    logInfo("TibberBestPrice",result)
    
    // parameters with power value - as example use java Map instead of JSON  
    parameters = Map.of("duration", "1 h 34 m","power",423,"latestEnd",Instant.now().plusSeconds(7200))
    result = actions.bestPricePeriod(parameters)
    logInfo("TibberBestPrice",result)
    // calculate time between now and cheapest start and start timer to execute action
    val startsAt = transform("JSONPATH", "$.cheapestStart", result)
    var secondsTillStart = Duration.between(Instant.now(), Instant.parse(startsAt)).getSeconds()
    // if the start should happen immediately, avoid negative values
    secondsTillStart = Math::max(0,secondsTillStart) 
    bestPriceTimer = createTimer(now.plusSeconds(secondsTillStart), [
        logInfo("TibberBestPrice","Start your device")
    ])
end

Console output:

text
2025-05-29 16:07:40.858 [TRACE] [.internal.calculator.PriceCalculator] - Calculation time 2 ms for 1819 iterations
2025-05-29 16:07:40.860 [INFO ] [ab.core.model.script.TibberBestPrice] - {"cheapestStart":"2025-05-30T11:00:40.856950656Z","mostExpensiveStart":"2025-05-30T18:25:40.856950656Z"}
2025-05-29 16:07:40.861 [TRACE] [.internal.calculator.PriceCalculator] - Calculation time 0 ms for 26 iterations
2025-05-29 16:07:40.863 [INFO ] [ab.core.model.script.TibberBestPrice] - {"highestPrice":0.138712416,"lowestPrice":0.13126169399999998,"cheapestStart":"2025-05-29T14:07:40.861730141Z","averagePrice":0.134152053,"mostExpensiveStart":"2025-05-29T14:32:40.861730141Z"}
2025-05-29 16:07:40.967 [INFO ] [ab.core.model.script.TibberBestPrice] - Start your device

Result ​

JSON-encoded String result with keys

KeyTypeDescription
cheapestStartStringTimestamp of cheapest start
lowestPricedoublePrice of the cheapest period
mostExpensiveStartStringTimestamp of most expensive start
highestPricedoublePrice of the most expensive period
averagePricedoubleAverage price within the period

Result Example ​

json
{
    "highestPrice": 0.18921223574999999,
    "lowestPrice": 0.17497929625,
    "cheapestStart": "2025-05-31T15:12:58.135876781Z",
    "averagePrice": 0.1810258046730769,
    "mostExpensiveStart": "2025-05-31T15:37:58.135876781Z"
}

bestPriceSchedule ​

Calculates the lowest cost for a non-consecutive schedule. For use cases like a battery electric vehicle or a heat pump.

Parameters ​

NameTypeDescriptionDefaultRequired
earliestStartInstantEarliest start timenowno
latestStopInstantLatest end timepriceInfoEndno
powerintNeeded powerN/Ano
durationintDuration in seconds or String (8h 15m)N/Ayes

Example ​

rules
rule "Tibber Schedule Calculation"
when
    System started // use your trigger
then
    var actions = getActions("tibber","tibber:tibberapi:xyz")
    // long period with constant power value
    var parameters = "{\"power\": 11000, \"duration\": \"8h 15m\"}"
    var result = actions.bestPriceSchedule(parameters)
    // get cost and convert it into double value
    val costString = transform("JSONPATH", "$.cost", result)
    val cost = Double.valueOf(costString)
    val scheduleSize = transform("JSONPATH", "$.size", result)
    logInfo("TibberSchedule",result)
    logInfo("TibberSchedule","Cost : " + cost+" Number of schedules : " + scheduleSize)
    for(var i=0; i<Integer.valueOf(scheduleSize); i++) {
        val schedule = transform("JSONPATH", "$.schedule["+i+"]", result)
        logInfo("TibberSchedule","Schedule "+i+": " + schedule)
        val scheduleStartString = transform("JSONPATH", "$.schedule["+i+"].start", result)
        val scheduleStart = Instant.parse(scheduleStartString)
        logInfo("TibberSchedule","Schedule "+i+" start: " + scheduleStart.atZone(ZoneId.systemDefault()).toString)
    }
end

Console output

dsl
2025-05-29 19:42:38.223 [INFO ] [hab.core.model.script.TibberSchedule] - {"cost":17.004625,"size":2,"schedule":[{"start":"2025-05-30T08:00:00Z","stop":"2025-05-30T16:00:00Z","duration":28800,"cost":16.407600000000002},{"start":"2025-05-29T23:00:00Z","stop":"2025-05-29T23:15:00Z","duration":900,"cost":0.5970249999999999}]}
2025-05-29 19:42:38.225 [INFO ] [hab.core.model.script.TibberSchedule] - Cost : 17.004625 Number of schedules : 2
2025-05-29 19:42:38.227 [INFO ] [hab.core.model.script.TibberSchedule] - Schedule 0: {start=2025-05-30T08:00:00Z, stop=2025-05-30T16:00:00Z, duration=28800, cost=16.407600000000002}
2025-05-29 19:42:38.230 [INFO ] [hab.core.model.script.TibberSchedule] - Schedule 0 start: 2025-05-30T10:00+02:00[Europe/Berlin]
2025-05-29 19:42:38.232 [INFO ] [hab.core.model.script.TibberSchedule] - Schedule 1: {start=2025-05-29T23:00:00Z, stop=2025-05-29T23:15:00Z, duration=900, cost=0.5970249999999999}
2025-05-29 19:42:38.234 [INFO ] [hab.core.model.script.TibberSchedule] - Schedule 1 start: 2025-05-30T01:00+02:00[Europe/Berlin]

Result ​

JSON encoded String result with keys

KeyTypeDescription
sizeintNumber of schedules
scheduleJSON arrayArray of scheduleEntry elements

JSON Object scheduleEntry

KeyTypeDescription
startStringStart time (Instant as string)
stopStringStop time (Instant as string)
durationintDuration in seconds
costdoubleCost in your currency

Result Example ​

json
{
    "cost": 16.092450000000003,
    "size": 2,
    "schedule": [
        {
            "start": "2025-06-01T08:00:00Z",
            "stop": "2025-06-01T16:00:00Z",
            "duration": 28800,
            "cost": 15.579300000000002
        },
        {
            "start": "2025-06-01T07:00:00Z",
            "stop": "2025-06-01T07:15:00Z",
            "duration": 900,
            "cost": 0.51315
        }
    ]
}

fetchHistory ​

Triggers a full history fetch for a specific time window and stores the result persistently. Use this action to manually refresh history data, for example after the binding has been offline for an extended period.

Parameters ​

NameTypeDescriptionRequired
windowStringTime window to fetch: ANNUAL, MONTHLY, WEEKLY, DAILYyes

Example ​

rules
rule "Tibber Fetch Full History"
when
    System started // use your trigger
then
    var actions = getActions("tibber","tibber:tibberapi:xyz")
    actions.fetchHistory("ANNUAL")
    actions.fetchHistory("MONTHLY")
    actions.fetchHistory("WEEKLY")
    actions.fetchHistory("DAILY")
end

Full Example ​

Full example with demo.things and demo.items

demo.things Example ​

dsl
Thing tibber:tibberapi:xyz [ homeid="xxx", token="xxxxxxx", updateHour=13 ]

demo.items Example ​

dsl
Number:EnergyPrice          Tibber_API_Spot_Prices              "Spot Prices"                {channel="tibber:tibberapi:xyz:price#spot"}
Number                      Tibber_API_Price_Level              "Price Level"                {channel="tibber:tibberapi:xyz:price#level"}
Number:EnergyPrice          Tibber_API_Average                  "Average Price"              {channel="tibber:tibberapi:xyz:price#average"}

Number:Power                Tibber_API_Live_Consumption         "Live Consumption"           {channel="tibber:tibberapi:xyz:live#consumption"}
Number:Power                Tibber_API_Minimum_Consumption      "Minimum Consumption"        {channel="tibber:tibberapi:xyz:live#minimum-consumption"}
Number:Power                Tibber_API_Peak_Consumption         "Peak Consumption"           {channel="tibber:tibberapi:xyz:live#peak-consumption"}
Number:Power                Tibber_API_Average_Consumption      "Average Consumption"        {channel="tibber:tibberapi:xyz:live#average-consumption"}
Number:Power                Tibber_API_Live_Production          "Live Production"            {channel="tibber:tibberapi:xyz:live#production"}
Number:Power                Tibber_API_Minimum_Production       "Minimum Production"         {channel="tibber:tibberapi:xyz:live#minimum-production"}
Number:Power                Tibber_API_Peak_Production          "Peak Production"            {channel="tibber:tibberapi:xyz:live#peak-production"}
Number:Power                Tibber_API_Power_Balance            "Power Balance"              {channel="tibber:tibberapi:xyz:live#power-balance"}
Number:ElectricPotential    Tibber_API_Voltage_1                "Voltage 1"                  {channel="tibber:tibberapi:xyz:live#voltage1"}
Number:ElectricPotential    Tibber_API_Voltage_2                "Voltage 2"                  {channel="tibber:tibberapi:xyz:live#voltage2"}
Number:ElectricPotential    Tibber_API_Voltage_3                "Voltage 3"                  {channel="tibber:tibberapi:xyz:live#voltage3"}
Number:ElectricCurrent      Tibber_API_Current_1                "Current 1"                  {channel="tibber:tibberapi:xyz:live#current1"}
Number:ElectricCurrent      Tibber_API_Current_2                "Current 2"                  {channel="tibber:tibberapi:xyz:live#current2"}
Number:ElectricCurrent      Tibber_API_Current_3                "Current 3"                  {channel="tibber:tibberapi:xyz:live#current3"}

Number:Energy               Tibber_API_Total_Consumption        "Total Consumption"          {channel="tibber:tibberapi:xyz:statistics#total-consumption"}
Number:Energy               Tibber_API_Daily_Consumption        "Daily Consumption"          {channel="tibber:tibberapi:xyz:statistics#daily-consumption"}
Number:Currency             Tibber_API_Daily_Cost               "Daily Cost"                 {channel="tibber:tibberapi:xyz:statistics#daily-cost"}
Number:Energy               Tibber_API_Last_Hour_Consumption    "Last Hour Consumption"      {channel="tibber:tibberapi:xyz:statistics#last-hour-consumption"}
Number:Energy               Tibber_API_Total_Production         "Total Production"           {channel="tibber:tibberapi:xyz:statistics#total-production"}
Number:Energy               Tibber_API_Daily_Production         "Daily Production"           {channel="tibber:tibberapi:xyz:statistics#daily-production"}
Number:Energy               Tibber_API_Last_Hour_Production     "Last Hour Production"       {channel="tibber:tibberapi:xyz:statistics#last-hour-production"}

Number:Energy               Tibber_API_Yearly_Consumption       "Yearly Consumption"         {channel="tibber:tibberapi:xyz:history#yearly-consumption"}
Number:Currency             Tibber_API_Yearly_Cost              "Yearly Cost"                {channel="tibber:tibberapi:xyz:history#yearly-cost"}
Number:Energy               Tibber_API_Yearly_Production        "Yearly Production"          {channel="tibber:tibberapi:xyz:history#yearly-production"}
Number:Energy               Tibber_API_Monthly_Consumption      "Monthly Consumption"        {channel="tibber:tibberapi:xyz:history#monthly-consumption"}
Number:Currency             Tibber_API_Monthly_Cost             "Monthly Cost"               {channel="tibber:tibberapi:xyz:history#monthly-cost"}
Number:Energy               Tibber_API_Monthly_Production       "Monthly Production"         {channel="tibber:tibberapi:xyz:history#monthly-production"}
Number:Energy               Tibber_API_Weekly_Consumption       "Weekly Consumption"         {channel="tibber:tibberapi:xyz:history#weekly-consumption"}
Number:Currency             Tibber_API_Weekly_Cost              "Weekly Cost"                {channel="tibber:tibberapi:xyz:history#weekly-cost"}
Number:Energy               Tibber_API_Weekly_Production        "Weekly Production"          {channel="tibber:tibberapi:xyz:history#weekly-production"}
Number:Energy               Tibber_API_History_Daily_Consumption "History Daily Consumption" {channel="tibber:tibberapi:xyz:history#daily-consumption"}
Number:Currency             Tibber_API_History_Daily_Cost       "History Daily Cost"         {channel="tibber:tibberapi:xyz:history#daily-cost"}
Number:Energy               Tibber_API_History_Daily_Production "History Daily Production"   {channel="tibber:tibberapi:xyz:history#daily-production"}

Rule listen to day-ahead price update ​

rules
rule "Tibber day-ahead prices available"
when
    Channel 'tibber:tibberapi:xyz:price#event' triggered
then
    logInfo("Tibber Update","Price event {}", receivedEvent)
end