Aktien, ETFs und Krypto in Home Assistant anzeigen – mit Easy Stock
Wer sein Smart Home nicht nur für Licht, Heizung und Sicherheit nutzt, sondern auch sein Portfolio im Blick behalten möchte, findet mit Easy Stock eine elegante Lösung direkt in Home Assistant. Easy Stock ist meine erste eigene Home Assistant Integration – und ich habe sie von Anfang an so gebaut, wie ich sie selbst haben wollte: Kursdaten von Yahoo Finance, ohne API-Key, ohne YAML-Konfiguration, und mit einer eingebetteten Lovelace-Karte inklusive Sparkline-Charts.
Was ist Easy Stock?
Easy Stock ist eine Community-Integration für Home Assistant, die Aktien, ETFs, Indexfonds, Kryptowährungen und Rohstoffe als Sensor-Entitäten in HA verfügbar macht. Die Kursdaten stammen direkt von Yahoo Finance und werden in konfigurierbaren Intervallen abgerufen – von einmal pro Minute bis einmal täglich.
Das Besondere: Es ist weder ein API-Key noch eine manuelle Ressourcen-Konfiguration notwendig. Die zugehörige Lovelace-Karte wird beim Laden der Integration automatisch registriert. Du findest die Integration hier: https://github.com/derspe/ha-easy-stock
Installation über HACS
Easy Stock ist noch nicht im offiziellen HACS-Store gelistet, lässt sich aber als Custom Repository einbinden:
- HACS in der HA-Seitenleiste öffnen
- Über das ⋮-Menü → Benutzerdefinierte Repositories die Repo-URL eintragen, Kategorie Integration auswählen
- Easy Stock in HACS suchen und herunterladen
- Home Assistant neu starten
Alternativ kann der Ordner custom_components/easy_stock/ auch manuell in das HA-Konfigurationsverzeichnis kopiert werden.
Einrichtung: Ein Asset in wenigen Klicks
Die Konfiguration läuft vollständig über die UI:
Einstellungen → Geräte & Dienste → Integration hinzufügen → Easy Stock
Pro Asset werden drei Felder befüllt: das Yahoo Finance Ticker-Symbol, ein optionaler Anzeigename und das Abfrageintervall in Sekunden (Standard: 300 Sekunden / 5 Minuten).
Jedes Asset wird zu einer eigenen Sensor-Entität. Für europäische ETFs ist das Börsenkürzel entscheidend – EUNL.DE für Frankfurt, IWDA.AS für Amsterdam. Den richtigen Ticker findet man direkt auf finance.yahoo.com.
Einige Beispiel-Symbole:
| Asset | Symbol |
|---|---|
| Apple | AAPL |
| iShares MSCI World (Frankfurt) | EUNL.DE |
| Bitcoin in Euro | BTC-EUR |
| Gold ETC (Frankfurt) | 4GLD.DE |
| S&P 500 ETF | SPY |
Was liefern die Sensor-Entitäten?
Jeder Sensor enthält neben dem aktuellen Kurs als State eine Reihe von Attributen:
- symbol – Ticker-Symbol
- long_name – vollständiger Assetname von Yahoo Finance
- currency – Handelswährung
- market_state – REGULAR, CLOSED, PRE oder POST
- change / change_pct – absolute und prozentuale Veränderung zum Vortagesschluss
- previous_close – Schlusskurs des Vortags
- history – bis zu 252 tägliche Schlusskurse als Liste
- price_is_live – true bei geöffnetem Markt oder 24/7-Assets wie Bitcoin
Da die Sensoren mit SensorStateClass.MEASUREMENT arbeiten, werden die Werte automatisch vom HA Recorder aufgezeichnet – ohne zusätzliche Konfiguration.
Die Lovelace-Karte mit Sparkline-Charts
Die integrierte Karte visualisiert alle konfigurierten Assets in einer Übersicht. Sie wird über Dashboard bearbeiten → Karte hinzufügen → Easy Stock Card eingefügt und lässt sich vollständig über den visuellen Editor konfigurieren – inklusive Drag & Drop zum Umsortieren der Assets.
Fünf Zeitbereiche stehen zur Auswahl:
| Bereich | Datenquelle |
|---|---|
| 1T (1 Tag) | HA Recorder (5-Minuten-Auflösung) |
| 1W (1 Woche) | HA Recorder (5-Minuten-Auflösung) |
| 1M (1 Monat) | Yahoo Finance Tagesschlusskurse |
| YTD | Yahoo Finance Tagesschlusskurse |
| 1J (1 Jahr) | Yahoo Finance Tagesschlusskurse |
Die Kurzfrist-Charts für 1T und 1W nutzen die im HA Recorder gespeicherten Daten für eine hochaufgelöste Darstellung. Solange noch nicht genug History vorliegt, fällt die Karte automatisch auf eine vereinfachte Darstellung zurück – der 1J-Chart ist hingegen sofort ab dem ersten Update vollständig verfügbar.
Währungskonvertierung: Alle Kurse können optional in einer einheitlichen Anzeigewährung dargestellt werden. Unterstützt werden EUR, USD, GBP, CHF, AUD, CAD, JPY, SEK, NOK, DKK, CNY und HKD. Die Wechselkurse werden stündlich von frankfurter.app (EZB-Daten) abgerufen.
Sprachunterstützung: Die Kartenoberfläche passt sich automatisch an die in Home Assistant eingestellte Sprache an. Neben Deutsch und Englisch werden 18 weitere Sprachen unterstützt, darunter Französisch, Spanisch, Japanisch und Arabisch.
Wer die Karte lieber direkt per YAML pflegt:
type: custom:easy-stock-card title: My Portfolio # optional display_currency: EUR # optional — EUR (default), USD, GBP, CHF, AUD, CAD, JPY, SEK, NOK, DKK, CNY, HKD default_range: "1T" # optional — 1T (1D), 1W, 1M, YTD, 1J (1Y) — default: 1T tile_size: small # optional — small (default), medium, large entities: - sensor.aapl - sensor.iwda_as - sensor.btc_eur
Für wen lohnt sich Easy Stock?
Easy Stock ist interessant für alle, die ihr Investmentportfolio bereits in Home Assistant im Blick haben oder es dort integrieren möchten – etwa in einem Dashboard neben Energie-Statistiken, Heizungsdaten und Wetterinformationen. Die Integration benötigt keinen externen Dienst-Account, keine API-Keys und keinen bezahlten Datenzugang. Da Yahoo Finance die Kursdaten für den privaten Gebrauch kostenlos bereitstellt, ist der Betrieb vollständig kostenfrei.
Wer ein komplexeres Portfolio mit vielen Positionen verwaltet, kann für jedes Asset eine eigene Sensor-Entität anlegen und diese dann flexibel in verschiedenen Dashboards oder Automationen nutzen – zum Beispiel für eine Benachrichtigung, wenn ein Kurs eine bestimmte Schwelle unter- oder überschreitet.
GitHub: github.com/derspe/ha-easy-stock
Yahoo Finance: de.finance.yahoo.com