SPOTPULS OPEN REST API (V1) — FREE, NO API KEY, CORS *

GET https://spotpuls.app/api/v1/prices?zone=FI&vat=1&window=3&format=json

• zone — Any of 40 European zones (FI, SE1..SE4, NO1..NO5, DK1..DK2, EE, LV, LT, DE-LU, FR, NL, ES, IT-North, PL, GB).
• vat — 1 (incl. national electricity VAT, default) or 0 (VAT 0 %).
• currency — local (snt, öre, øre, ct, p, gr, Ft, Kč), eur_cents, eur_kwh, or eur_mwh.
• window — 1..24 (default 3): computes cheapestContiguousWindow and cheapestHours for relays, boilers, heat pumps, and EVs.
• margin / transfer / threshold — Optional contract add-ons & price trigger threshold.
• format — json, compact (shelly), ha, evcc, victron, csv, ical, prometheus, plain, badge, or widget.

GET https://spotpuls.app/api/v1/zones
GET https://spotpuls.app/api/v1/ha/FI.json?window=3
GET https://spotpuls.app/api/v1/shelly/FI.json?window=3
GET https://spotpuls.app/api/v1/evcc/DE-LU.json
GET https://spotpuls.app/api/v1/ical/FI.ics?window=3
GET https://spotpuls.app/api/v1/metrics?zone=FI
GET https://spotpuls.app/api/v1/plain/FI?field=run_now&window=3

<iframe src="https://spotpuls.app/api/v1/widget/FI?theme=light" width="100%" height="198" style="border:0;max-width:460px;" loading="lazy"></iframe>

rest:
  - resource: "https://spotpuls.app/api/v1/ha/FI.json?window=3&transfer=6.80"
    scan_interval: 300
    sensor:
      - name: "Spotpuls Spot Price"
        value_template: "{{ value_json.state }}"
        unit_of_measurement: "snt/kWh"
        json_attributes:
          - total_price
          - today_min
          - today_max
          - raw_today
          - raw_tomorrow
          - forecast_7d
    binary_sensor:
      - name: "Spotpuls Cheapest 3h Window Active"
        value_template: "{{ value_json.run_contiguous_now }}"

// Runs on Shelly Plus 1PM / Pro 3EM — switches relay ON during cheapest 3h window
const URL = "https://spotpuls.app/api/v1/shelly/FI.json?window=3";
function pollSpotpuls() {
  Shelly.call("HTTP.GET", { url: URL, timeout: 10 }, function (res, err) {
    if (err || !res || res.code !== 200) return;
    const d = JSON.parse(res.body);
    const shouldRun = d.runContig === 1; // or d.runCheap === 1
    Shelly.call("Switch.Set", { id: 0, on: shouldRun });
  });
}
pollSpotpuls();
Timer.set(300000, true, pollSpotpuls);

tariffs:
  currency: EUR
  grid:
    type: custom
    forecast:
      source: http
      uri: https://spotpuls.app/api/v1/evcc/DE-LU.json?vat=1
      jq: .
      cache: 15m

# Single numeric value (current spot price):
curl -s "https://spotpuls.app/api/v1/plain/FI?field=spot"

# Binary 1 / 0 relay trigger (1 if inside cheapest 4h block):
curl -s "https://spotpuls.app/api/v1/plain/FI?field=run_now&window=4"

# Google Sheets live 192-hour table:
=IMPORTDATA("https://spotpuls.app/api/v1/prices?zone=FI&vat=1&format=csv")

# Apple / Google / Outlook Calendar live subscription URL:
https://spotpuls.app/api/v1/ical/FI.ics?window=3

const res = await fetch("https://spotpuls.app/api/v1/prices?zone=SE3&vat=1&window=4");
const data = await res.json();
console.log(data.current.spotPrice, data.meta.unit);
console.log("Cheapest 4h:", data.automation.cheapestContiguousWindow);

import pandas as pd
df = pd.read_csv("https://spotpuls.app/api/v1/prices?zone=FI&vat=1&format=csv", comment="#")
print(df.head())

# Prometheus scrape config (prometheus.yml):
# metrics_path: /api/v1/metrics
# params: { zone: ["FI"] }