Import old energy readings for use in energy dashboard

As interesting as this is, i’d LOVE to get a detailed writeup on how to use this websocket API call, so i can write a method to interact with it. I don’t see any documentation on what it expects, examples of usage, anything.

The developer tools shows this for a service call.

1 Like

For that to appear, as you said, you need to install the Spook integration (GitHub - frenck/spook: Spook 👻 Not your homie).

Anyhow, I am not sure how that may work.

I think Spook is the only way to do this.
It has been a long standing decission by developers that import of historic data was not something they wanted to go into.
Frenck has therefore added it to the Spook integration instead, but I guess this is done by a direct SQL call and not through some API that will be available elsewhere.

So after a few days, i finally figured out why i wasn’t getting this service call… I forgot to actually ADD the spook integration (i added it in HCAS, but forgot to do the integration piece). I can now see the screenshot provided above, and the notes in the “Statistics” field tell me what i need to know.

However, i still have questions about the Statistics ID and Source. I believe i can just use my energy sensor, is this correct? Will this overwrite my existing data (not the worst outcome), or create a new entity? Is the “Source” a random field?

The “Has a mean”, “Has a sum” and "Unit of measurement or simple enough to ascertain, as well as what to provide with statistics. I just don’t want to kill my existing database with non-sensical data.

1 Like

@fversteegen, @ahochsteger, @gijbelsy, @slyoldfox

I created a script that can import historical data from the Dutch energy provider Eneco with their Toon thermostat.

The script should be easily adaptable for other providers that use a different export format. The processing logic to change the statistics stays the same.


Did you figured it out ?

Could you provide some same data which you feed into this node.js script as an example? Does the stat just increment the sum for each time stamp?

I got the stats loaded using the websocket recorder API. However, the following morning HA shows a return of the same cumulative amount to the grid. Why is that? I have no sources feeding energy data to HA apart from what I sent.

It’s not really documented, hence the nature of the spook tools, but here’s a sample working data for the service recorder.import_statistics. Seems that you still may need to do more data manipulation once you call this service, but hopefully this can get you started.

service: recorder.import_statistics
  has_mean: false
  has_sum: true
  statistic_id: sensor.gas_meter
  source: recorder
  name: "NULL"
  unit_of_measurement: CCF
    - start: "2023-05-01T00:00:00+06:00"
      state: 517.76
      sum: 0.94
1 Like

So, i was finally able to get this to work!

I use NodeRed to import these statistics, and use the following fuction:

var newmsg={payload:{}}
var smmsg={payload:{}}
var ps=msg.payload.energyData

var c_stat={}
var sum_add = 0

if ( msg.sum != 'unknown'){
    sum_add = msg.sum

function parseDT(rd){
    var stats=[{sum:sum_add}]

    var i=-1
    var hr = 0
    var m=0
        i += 1
        if(i == 0){
            hr = 0
            m = 0
        } else {
            if(m == 0){
                hr += 1
        var val=e.split('-')[0]
        if(i >= 8 && i <=11){
            if (val == ''){
                hr = 1
            } else {
                hr = 2
        if(i >= 12 && i <= 15){
            if(val == '-'){
            } else {
        if(stats.length-1 == hr){
            if (val != '' && val != '-'){
                stats[hr].sum = sum_add
            } else {
                stats[hr].sum = sum_add
        } else {
            if(val != '' && val != '-'){
                sum_add += parseFloat(val)
            } else {
    return stats

var nm=[]
var sm=[]

ps.forEach(function (e){
    var dt = new Date(e.DT)
    var dh = parseDT(e.RD.split(','))
    var ldt = dt

    if (e.RT == "C"){
        for (var i=0;i<=23;i++){
        for (var i = 0; i <= 23; i++) {
            sm.push({ start: dt.toISOString(), sum: dh[i].sum, last_reset: ldt.toISOString() })
return [newmsg,smmsg];

I get the data from SMT via API, into json, and i use jsonata to parse this into the Call Service Node: recorder.import_statistics call:

   "name":"Energy Reading",


This is all on my Dev box, and i still haven’t been able to determine how to get the state of a particular date/time, so that’s my next call.

I will post an update in my github with my flow as soon as get this working in my production.

The statics for any given sensor that has a sum at any given time can be found using this query:

select strftime('%d-%m-%Y %H:%M:%f', ss.start_ts, 'unixepoch') as start_dt, strftime('%d-%m-%Y %H:%M:%f', se.start_ts, 'unixepoch') as end_dt, se.[sum] - ss.[sum] as [difference], m.unit_of_measurement from statistics ss inner join statistics_meta m on = ss.metadata_id inner join statistics se on se.metadata_id = ss.metadata_id and se.start_ts > ss.start_ts and not exists (select * from statistics se2 where se2.metadata_id = ss.metadata_id and se2.start_ts > ss.start_ts and se2.start_ts < se.start_ts) where ss.start_ts <= (julianday('2023-07-06T00:00:00') - 2440587.5)*86400.0 and m.statistic_id = 'sensor.electricity_meter_energy_consumption_tarif_1' order by ss.start_ts desc limit 1;

I have written the query such that you can specify the entity_id of the sensor (stored in statistics_meta.statistic_id) and the date & time of the statistic (stored in statistics.start_ts or statistics_short_term.start_ts) and see the results in human readable format. If you’ve got the exact start_ts value and/or the metadata_id, you don’t need the conversion and/or the join into statistics_meta of course.

The values this query returns are:

  • start_dt - the start of the period the statistic is valid for (in UTC),
  • end_dt - the end of the period the statistic is valid for (in UTC),
  • difference - the amount added or subtracted (when < 0) in this statistic period.
1 Like

Hi everyone,

I have recently created an add-on that uses the recorder/import_statistics route of the WebSocket API to import electric consumption data from french electric meters (AKA Linky).

Because these statistics are not tracked by a sensor, they are considered “external statistics” (there is a : instead of a . in the statistic_id)

However, it looks like I cannot add a static price to my electric consumption (the radio buttons are disabled), and this seems to be by design according to this PR comment:

A price entity or a fixed price is only supported when the consumed gas is tracked by a sensor.

Where can I find more information about this ? I cannot find any other related documentation, and I have no idea how to fix this little problem…


One off my energy sockets died and I have a new one which i like to install. I searched everywhere and see a lot off the same questions but no solution. As I understand from HA 2023.4 there is no option anymore to rename the new entity to the old name and keep the energy history.

Is there a way to migrate the energy data from one entity to another? Just like to keep my energy history.

Why are you under the impression that renaming the entity no longer works? If not mistaken that is still the way to do it…

Yes, you are right! .Was testing with a old device which I no longer needed in the Energy dashboard. When you remove the device and add another, change the entity name to the old one it keeps the energy history.
One thing to keep in mind: If you use a new device with kWh history, this history will be added to the Energy dashboard. So always use a new device without history or delete the history, I resetted the history from that new device in the Zigbee2MQTT manager.

1 Like

There’s still a scenario that simply renaming a sensor does not cover. When you need to split a source sensor into two (for PEAK and OFFPEAK). It’d be great if we could add a sensor to the Energy Dashboard for historical purposes up until a set timestamp, and then new sensors provide the new data. I outlined this in more detail in this post.

1 Like

And what about users that didint know about the renaming scheme and have old and new sensors in the energy dashboard so that they dont lose the information?
I used to have a SDM120 using tasmota and after a few years upgraded to a Shelly EM.
How do users like me merge the information?

sensor.powcasath_energy_total (old sersor)
sensor.shellyem_34945473ec5d_channel_1_energy (new sensor)

You are telling me that if i rename the shelly sensor to the old name it will work and merge?
Do i have to delete the old sensor? wont i lose my data?

I just created an integration to import historical data from csv/tsv-files via a service. Maybe this can help one or the other, see this post.

I did not yet try it with data from the energy dashboard, but as the historical cards work, this should work as well.

Feedback welcome!

Hi, I know it’s an old post, but can you tell me where can I find documentations or instructions on the api async_import_statistics and async_add_external_statistics?