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 nastavuje se ručně v souboru configuration.yaml.

Začít nastavení Zpět na integrace

Doména: alpha_vantage
Typ: senzor
Komunikace: cloudové dotazování
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. Bez jedné z těchto částí nebude mít integrace žádná data, ze kterých by vytvořila senzory.

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 čtení lze prodloužit pomocí scan_interval.

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

Nejdřív si vytvořte vlastní bezplatný 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

Alpha Vantage se nastavuje ručním zápisem 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ých položek sledujte, zda senzor načetl aktuální hodnotu pro zadaný symbol. U měnových párů ověřte, že odpovídá směr převodu, například USD na EUR.

Pokud se senzor nevytvoří nebo se neaktualizuje, ověřte platnost API klíče, správnost symbolu nebo měnového páru, odsazení v YAML 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.