Integrace RichPear Home

Alpha Vantage

Alpha Vantage přidá senzory pro sledování vybraných burzovních symbolů a směnných kurzů. Integrace používá cloudové API služby Alpha Vantage a v ověřené dokumentaci RichPear Home se nastavuje ručně přes configuration.yaml.

Začít nastavení Zpět na integrace

Doména: alpha_vantage
Typ: senzor
Komunikace: cloud polling
Nastavení: configuration.yaml

Co integrace umí

Integrace vytváří senzory z dat služby Alpha Vantage. Pro akciové symboly používá zvolený burzovní symbol, například GOOGL. Pro směnné kurzy používá dvojici měn, například USD na EUR nebo BTC na USD.

V konfiguraci musí být uveden alespoň jeden akciový symbol v symbols, nebo alespoň jeden směnný kurz ve foreign_exchange. Pokud není nastaveno ani jedno, integrace podle zdrojového kódu nevytvoří senzory a zobrazí trvalé upozornění.

Limity API

Bezplatný API klíč Alpha Vantage má limit 25 dotazů za den. Výchozí interval čtení senzoru je 5 minut, takže bez změny intervalu se denní limit vyčerpá zhruba během prvních dvou hodin. Interval je možné upravit pomocí scan_interval.

Připravte API klíč a položky ke sledování

Nejdřív si vytvořte API klíč u služby Alpha Vantage. Potom si připravte seznam burzovních symbolů nebo měnových párů, které chcete v RichPear Home sledovat.

RichPear Home otevřete na http://rphome.local:8123. Pokud tato adresa ve vaší síti nefunguje, použijte http://IP-ADRESA:8123.

Symboly je potřeba zapisovat přesně tak, jak je vrací Alpha Vantage. Pro vyhledání symbolu použijte vyhledávání v API Alpha Vantage, například funkci SYMBOL_SEARCH.

Nastavte senzor v configuration.yaml

Ověřený postup pro Alpha Vantage není průvodce v Nastavení, ale ruční zápis do configuration.yaml. V RichPear Home proto otevřete správu konfiguračních souborů, upravte konfiguraci a po uložení proveďte kontrolu konfigurace.

Po změně configuration.yaml restartujte RichPear Home, aby se integrace načetla. Po restartu se integrace zobrazuje v části Nastavení → Zařízení a služby a její entity najdete na kartě Entity.

Povinné údaje

Povinný je api_key. U akciového senzoru je povinný symbol. U směnného kurzu jsou povinné položky from a to.

Příklad konfigurace

Tento příklad vytvoří senzor pro Google a senzor směnného kurzu USD/EUR. Hodnotu YOUR_API_KEY nahraďte vlastním API klíčem.

sensor:
  - platform: alpha_vantage
    api_key: YOUR_API_KEY
    symbols:
      - symbol: GOOGL
        name: Google
    foreign_exchange:
      - name: USD_EUR
        from: USD
        to: EUR

U akciového symbolu je volitelný název senzoru name a měna currency, výchozí měna je USD. U směnného kurzu je volitelný název senzoru name.

Pokud používáte bezplatný API klíč, nastavte delší scan_interval, aby počet dotazů odpovídal dennímu limitu služby.

Zkontrolujte senzory po restartu

Po restartu otevřete Nastavení → Zařízení a služby → Alpha Vantage a zkontrolujte vytvořené entity. U akciového senzoru zdrojový kód nastavuje stav z poslední hodnoty open a atributy close, high a low. U směnného kurzu nastavuje stav z hodnoty Exchange Rate a atributy from a to.

Pokud se senzor nevytvoří nebo se neaktualizuje, ověřte platnost API klíče, správnost symbolu nebo měnového páru a denní limit Alpha Vantage.

Po nastavení

Nově vytvořené entity pojmenujte česky, přiřaďte je do oblastí a až potom je používejte ve scénách, skriptech nebo automatizacích.