# Spotpuls (https://spotpuls.app)
> Open European Day-Ahead Electricity Spot Price Tracker, Self-Learning 7-Day Regional Forecast (40 Bidding Zones), Postal Grid Tariff Calculator & Universal Automation REST API.

## Overview
Spotpuls (`https://spotpuls.app`) provides live hourly day-ahead electricity spot prices together with an empirically calibrated 7-day (168 h) Log-Merit + Hist-GBDT hourly forecast (supporting negative spot prices and conformal probability bands) for all 40 European spot-electricity bidding zones across 28 native languages.

## Universal Public REST API (Free, No API Key, CORS `*`)
- **Primary Endpoint**:
  - `GET https://spotpuls.app/api/v1/prices?zone=FI&vat=1&currency=local&window=3&format=json`
- **Supported Query Parameters**:
  - `zone`: Any of 40 European bidding zones (`FI`, `SE1`..`SE4`, `NO1`..`NO5`, `DK1`, `DK2`, `EE`, `LV`, `LT`, `DE-LU`, `AT`, `CH`, `NL`, `BE`, `FR`, `GB`, `IE-SEM`, `ES`, `PT`, `IT-North`..`IT-Sardinia`, `PL`, `CZ`, `SK`, `HU`, `RO`, `BG`, `SI`, `HR`, `GR`).
  - `vat`: `1` (incl. national electricity VAT, default) or `0` (VAT 0 %).
  - `currency`: `local` (native subunit/kWh, e.g. `snt/kWh`, `öre/kWh`, `øre/kWh`, `ct/kWh`, `p/kWh`, `gr/kWh`, `Kč/kWh`, `Ft/kWh`), `eur_cents` (`ct/kWh`), `eur_kwh` (`EUR/kWh`), or `eur_mwh` (`EUR/MWh`).
  - `window`: `1..24` (default `3`) — computes optimal cheapest contiguous N-hour block (`cheapestContiguousWindow`) and N cheapest individual hours (`cheapestHours`) in the next 24h.
  - `margin` / `transfer`: Optional add-ons to compute `totalPrice` per hour.
  - `threshold`: Optional price threshold returning `belowThresholdNow` boolean.
- **10 Plug-and-Play Application Output Formats (`format=...` or Clean URL Shortcuts)**:
  - `json` (default): Full JSON with `meta`, `market`, `current`, `summary`, `automation`, and 192-hour `series`.
  - `compact` / `shelly` (`/api/v1/shelly/FI.json`): Ultra-compact `< 500 B` JSON for Shelly Gen2/Gen3 scripts, ESPHome, ESP32, Arduino, and PLCs.
  - `ha` (`/api/v1/ha/FI.json`): Native Home Assistant RESTful sensor + ApexCharts-Card payload (`state`, `raw_today`, `raw_tomorrow`, `forecast_7d`, `run_contiguous_now`).
  - `evcc` (`/api/v1/evcc/DE-LU.json`): Native evcc.io open-source EV/solar charger tariff array `[{start, end, value}]`.
  - `victron` (`/api/v1/victron/NL.json`): Node-RED & Victron VenusOS Dynamic ESS schedule payload.
  - `csv` (`?format=csv`): Spreadsheet feed for Google Sheets `=IMPORTDATA(...)`, Excel PowerQuery, and Pandas.
  - `ical` (`/api/v1/ical/FI.ics`): RFC 5545 calendar subscription feed for Apple Calendar, Google Calendar, and Outlook.
  - `prometheus` (`/api/v1/metrics?zone=FI`): Native Prometheus / Grafana / VictoriaMetrics metrics.
  - `plain` (`/api/v1/plain/FI?field=spot` or `field=run_now`): Single plain-text value (`1`/`0` or numeric price) for Apple Shortcuts, Tasker, curl, Loxone, and KNX.
  - `badge` (`/api/v1/badge/FI.svg`) & `widget` (`/api/v1/widget/FI?theme=light`): Live SVG status badge and responsive `<iframe>` 24h mini-chart widget.
- **Zone Directory**: `https://spotpuls.app/api/v1/zones`
- **OpenAPI 3.1 Specification**: `https://spotpuls.app/openapi.json`
- **Developer & Smart-Home Integration Guide**: `https://spotpuls.app/api-docs/`

## Localized Country & Language Editions (28 Languages)
- Finland (Suomi): `https://spotpuls.app/`
- Europe / International (English): `https://spotpuls.app/en/`
- Sweden (Svenska, SE1–SE4): `https://spotpuls.app/se/`
- Norway (Norsk, NO1–NO5): `https://spotpuls.app/no/`
- Denmark (Dansk, DK1–DK2): `https://spotpuls.app/dk/`
- Estonia (Eesti, EE): `https://spotpuls.app/ee/`
- Latvia (Latviešu, LV): `https://spotpuls.app/lv/`
- Lithuania (Lietuvių, LT): `https://spotpuls.app/lt/`
- Germany (Deutsch, DE-LU): `https://spotpuls.app/de/`
- Austria (Deutsch, AT): `https://spotpuls.app/at/`
- Switzerland (Deutsch, CH): `https://spotpuls.app/ch/`
- Netherlands (Nederlands, NL): `https://spotpuls.app/nl/`
- Belgium (Nederlands, BE): `https://spotpuls.app/be/`
- France (Français, FR): `https://spotpuls.app/fr/`
- United Kingdom (English, GB): `https://spotpuls.app/gb/`
- Ireland (English, IE-SEM): `https://spotpuls.app/ie/`
- Spain (Español, ES / PVPC / OMIE): `https://spotpuls.app/es/`
- Portugal (Português, PT / OMIE): `https://spotpuls.app/pt/`
- Italy (Italiano, 6 GME zones): `https://spotpuls.app/it/`
- Poland (Polski, PL / TGE): `https://spotpuls.app/pl/`
- Czechia (Čeština, CZ / OTE): `https://spotpuls.app/cz/`
- Slovakia (Slovenčina, SK / OKTE): `https://spotpuls.app/sk/`
- Hungary (Magyar, HU / HUPX): `https://spotpuls.app/hu/`
- Romania (Română, RO / OPCOM): `https://spotpuls.app/ro/`
- Bulgaria (Български, BG / IBEX): `https://spotpuls.app/bg/`
- Slovenia (Slovenščina, SI / BSP): `https://spotpuls.app/si/`
- Croatia (Hrvatski, HR / CROPEX): `https://spotpuls.app/hr/`
- Greece (Ελληνικά, GR / HEnEx): `https://spotpuls.app/gr/`