Aller au contenu principal

Intégration domotique Yahoo Finance, gratuite et open source

Intégration Yahoo Finance pour Gladys Assistant

Cours d'actions, indices, ETF, devises et cryptos dans Gladys, via Yahoo Finance.

Voir sur GitHubToutes les intégrations

Suivez des cours dans Gladys : actions, indices (CAC 40, S&P 500…), ETF, paires de devises (EUR/USD…) et cryptomonnaies (BTC-EUR…), lus sur les pages publiques de Yahoo Finance. Pas de compte, pas de clé d'API.

Les cours sont différés (souvent de 15 minutes, selon la place) et indicatifs : cette intégration sert à garder un œil sur les marchés depuis la maison, pas pour passer des ordres. Non affiliée à Yahoo.

Ce que vous obtenez​

  • Un appareil par symbole, au nom de l'instrument (CAC 40 (^FCHI)) : cours, variation du jour (en valeur et en pourcentage), clôture précédente, devise et état du marché (ouvert ou fermé), avec leur historique.
  • Un widget de tableau de bord listant les symboles suivis avec leur cours et leur variation du jour, vert en hausse, rouge en baisse.
  • Deux déclencheurs de scène : une alerte de cours franchie (AIR.PA > 200), et une forte variation du jour (1, 2, 3, 5 ou 10 %, à la hausse ou à la baisse).
  • Deux actions de scène : lire le cours d'un symbole, ou de tous les symboles suivis, en une phrase à envoyer par message ou à faire lire à voix haute.

Prérequis​

  • Gladys Assistant 5.1 ou plus récent.
  • Un accès Internet depuis la machine de Gladys (l'intégration lit query1.finance.yahoo.com).

Configuration​

Réglages​

RéglageEffet
SymbolesSymboles Yahoo Finance séparés par des virgules, 20 au plus. Par défaut : ^FCHI, EURUSD=X, BTC-EUR.
Alertes de coursPour le déclencheur « alerte de cours », séparées par des points-virgules : AIR.PA > 200; BTC-EUR < 50000 (virgule acceptée).
Fréquence de mise à jour5 à 60 minutes (10 par défaut) pendant l'ouverture du marché.
Langue des textesNoms des fonctionnalités (à leur création) et textes envoyés aux scènes. Français par défaut.

Enregistrez, puis ouvrez l'onglet Découverte de l'intégration et créez les appareils voulus. Un symbole ajouté plus tard y apparaît après la lecture suivante.

Le bouton Afficher les cours actuels de la configuration lit tous les symboles d'un coup et dit lesquels Yahoo ne connaît pas.

Trouver un symbole​

Cherchez le nom sur finance.yahoo.com : le symbole figure à côté. Quelques exemples :

TypeSymboles
ActionsAIR.PA (Airbus, Paris), SAP.DE (SAP, Xetra), AAPL (Apple, Nasdaq)
Indices^FCHI (CAC 40), ^GDAXI (DAX), ^IBEX (IBEX 35), ^GSPC (S&P 500)
ETFCW8.PA (Amundi MSCI World), IWDA.AS (iShares Core MSCI World)
Paires de devisesEURUSD=X (un euro en dollars), EURGBP=X, EURCHF=X
CryptomonnaiesBTC-EUR, ETH-EUR, BTC-USD

Les actions de Londres sont cotées en pence (GBp) : la fonctionnalité de cours n'a alors pas d'unité, et la fonctionnalité de devise indique GBp.

Appareils​

FonctionnalitéContenu
CoursDernier cours, en euros, dollars ou livres quand c'est la devise.
Variation du jourCours moins la clôture précédente.
Variation du jour (%)La même, en pourcentage.
Clôture précédenteLa référence de la variation. Pour une cryptomonnaie, le cours à 00:00 UTC.
DeviseLe code de devise donné par Yahoo (EUR, USD, GBp, JPY…).
MarchéOuvert ou Fermé. Une paire de devises s'échange 24 h sur 24 en semaine, une cryptomonnaie toujours.

Les noms des fonctionnalités sont figés à la création de l'appareil : changez la langue avant de le créer.

Widget de tableau de bord​

Cours de bourse liste les symboles suivis (8 au plus) dans l'ordre de la configuration : l'instrument, son cours et l'état du marché, et la variation du jour en pastille colorée. Touchez une ligne pour voir le symbole, la clôture précédente, la variation et l'heure du cours, avec un lien vers Yahoo Finance.

Déclencheurs de scène​

Bourse : alerte de cours — une alerte de cours de la configuration est franchie. Filtres : le symbole (un appareil) et le sens (passe au-dessus, passe en dessous). Il se déclenche une fois, puis à nouveau seulement après un retour du cours de 0,5 % de l'autre côté du seuil : un cours qui hésite autour du seuil n'inonde pas votre téléphone. Une alerte déjà franchie quand vous l'enregistrez ne déclenche rien avant d'être franchie à nouveau.

Bourse : forte variation du jour — la variation depuis la clôture précédente atteint le niveau choisi : 1, 2, 3, 5 ou 10 %, à la hausse ou à la baisse. Une fois par niveau et par séance. Filtres : le symbole, le sens et le niveau.

Les deux transmettent aux actions : le symbole, le nom de l'instrument, le cours, la devise, le seuil ou le niveau, le sens et une phrase toute prête. Ce qui a déjà été déclenché est gardé : un redémarrage ne déclenche rien deux fois.

Actions de scène​

Bourse : lire un cours — choisissez un symbole ; l'action donne une phrase (« CAC 40 : 7 934,70 € (+0,78 % aujourd'hui) »), le cours, la variation en pourcentage et la devise.

Bourse : lire tous les cours — tous les symboles suivis en un texte, et leur nombre.

Les deux relisent Yahoo quand la dernière lecture date de plus d'une période de mise à jour.

Exemples de scènes​

  • Résumé du matin : à 9 h 30 en semaine, lire tous les cours puis envoyer le texte par Telegram.
  • Objectif atteint : avec l'alerte AIR.PA > 200, sur alerte de cours pour Airbus, envoyer « {{text}} » sur votre téléphone.
  • Tempête crypto : sur forte variation du jour pour BTC-EUR, à la baisse, 10 %, faire clignoter en rouge la lampe du salon.

Source des données, conditions et limites d'utilisation​

L'intégration lit le point d'accès public « chart » de Yahoo Finance, une requête par symbole, espacées :

  • pendant l'ouverture d'un marché, à chaque période de mise à jour ;
  • marché fermé, toutes les 30 minutes (son cours ne bouge pas) ;
  • un symbole inconnu, toutes les 6 heures.

Cet accès est non officiel : Yahoo ne publie pas d'API pour lui et peut le modifier ou le refuser à tout moment. Quand Yahoo refuse les requêtes (HTTP 429), l'intégration attend deux périodes, puis plus longtemps à chaque nouveau refus, jusqu'à une heure. Les données sont à usage personnel, selon les conditions d'utilisation de Yahoo : cours différés et indicatifs, pas pour passer des ordres.

Dépannage​

  • Aucun appareil dans l'onglet Découverte : vérifiez les symboles, puis utilisez Afficher les cours actuels : il liste ceux que Yahoo ne connaît pas. L'état de l'intégration le dit aussi.
  • « Yahoo Finance refuse les requêtes pour le moment » : patientez, les lectures reprennent seules. Réduisez le nombre de symboles ou allongez la fréquence si cela revient souvent.
  • Le marché reste « Fermé » pendant la séance : la place est peut-être fériée, ou l'instrument ne s'est pas encore échangé aujourd'hui.
  • Une alerte de cours ne se déclenche pas : le symbole doit aussi figurer dans la liste des symboles, et l'alerte doit être franchie après son enregistrement.
  • Journaux : LOG_LEVEL=debug montre chaque lecture.

Limites​

  • Cours différés et indicatifs ; aucun historique importé (l'historique commence à la création de l'appareil).
  • Un cours par symbole : ni quantités ni valeur de portefeuille.
  • 20 symboles au plus.
  • La variation d'une cryptomonnaie se compte depuis 00:00 UTC, pas sur 24 heures.
  • Le premier jour d'un symbole, une variation déjà là à la première lecture de la séance ne déclenche rien.
  • Accès non officiel à Yahoo : il peut cesser de fonctionner sans préavis.

Paramètres de configuration​

Voici les paramètres demandés par Yahoo Finance dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Symboles suivissectionNonIndiquez les symboles Yahoo Finance à suivre, enregistrez, puis créez leurs appareils dans l'onglet Découverte. Trouvez un symbole avec la recherche de finance.yahoo.com : il figure à côté du nom.
Sources et limitessectionNonPages publiques de Yahoo Finance, lues sans compte. Cours différés (souvent 15 minutes) et indicatifs : pas pour passer des ordres. Accès non officiel, que Yahoo peut modifier ou refuser. Non affiliée à Yahoo.
SymbolesstringNonSéparés par des virgules, 20 au plus : AIR.PA (Airbus à Paris), ^FCHI (CAC 40), CW8.PA (un ETF), EURUSD=X (euro en dollars), BTC-EUR (bitcoin en euros).
Alertes de coursstringNonPour le déclencheur de scène « alerte de cours », séparées par des points-virgules : un symbole suivi, > ou <, un cours dans sa devise. Se déclenche une fois, à nouveau après un retour du cours.
Fréquence de mise à jourselectNonPendant l'ouverture du marché. Un marché fermé est lu toutes les 30 minutes. Les cours de Yahoo sont différés de toute façon : inutile d'aller plus vite.
Langue des textesselectNonNoms des fonctionnalités (à leur création) et textes envoyés aux scènes.

Comment installer Yahoo Finance dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Yahoo Finance apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/guim31/gladys-bourse:1.0.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-bourse.

Yahoo Finance nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes​

Yahoo Finance est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le