À propos du projet

Installez avec `pip install tradingview-screener`, puis construisez des requêtes à l'aide de l'objet `Query`. Une requête de base sélectionne des champs tels que name, close, volume et market capitalization et appelle `get_scanner_data()`, qui renvoie un nombre de résultats et des lignes tabulaires. Les résultats sont limités à 50 lignes par défaut, avec des limites et des offsets configurables. Le package couvre les actions d'environ 70 pays ainsi que les options, les marchés crypto centralisés et décentralisés, les coins, le forex, les futures, les obligations et les CFD. Des helpers dédiés tels que `stocks()`, `crypto()`, `options()`, `forex()` et `futures()` renvoient des objets `Query` chaînables. Les champs de données disponibles incluent les prix OHLC, le volume, les indicateurs techniques, les métriques fondamentales telles que le P/E et l'EPS, ainsi que des champs internes à TradingView. Les champs de prix et d'indicateurs peuvent utiliser des unités de temps allant de 1 minute à mensuelle en ajoutant des suffixes tels que `|1`, `|5`, `|60`, `|1W` ou `|1M`, et différents champs peuvent utiliser différentes unités de temps dans une même requête. Le filtrage utilise une syntaxe de type SQL avec des comparaisons de colonnes, des vérifications de plage et une logique AND/OR. Les requêtes peuvent également être ordonnées, décalées et limitées. En interne, la bibliothèque traduit les méthodes chaînées en la charge utile JSON attendue par le point de terminaison `/screener` de TradingView, évitant le web scraping ou l'analyse HTML. Les données de marché en temps réel ou en streaming nécessitent une authentification via les cookies de session TradingView. Le README décrit le passage manuel des cookies, leur chargement depuis un navigateur local avec `rookiepy`, ou l'authentification via l'API de connexion, tout en avertissant que des connexions fréquentes à l'API peuvent déclencher des CAPTCHAs ou des restrictions de compte. Une requête avec `update_mode` peut être utilisée pour vérifier si un exchange renvoie des données en streaming ou différées. Le projet se positionne comme un wrapper d'API de bas niveau plutôt qu'une stratégie de trading opinionated ou une bibliothèque de sentiment. Sa documentation liste les champs, marchés et types de screeners disponibles.