WyckoffTradingAgent : un agent conversationnel de sélection pour l'analyse volume-prix de Wyckoff
Ce projet transforme « Open-source Wyckoff trading agent and AI stock screener for volume-price analysis, A-share screening, CLI workflows, and MCP tools. trader @Hoyooyoo. » en une solution open source exploitable, avec une chaîne d’outils réutilisable et des moyens d’intégration pour des cas d’usage concrets.
En bref
- De quoi s’agit-il ?
- Un agent Python pour l'analyse volume-prix des actions chinoises, hongkongaises et américaines, accessible via CLI, Web et MCP, avec un entonnoir de sélection en cinq couches et une automatisation planifiée.
- À qui s’adresse-t-il ?
- Le projet est sous licence AGPL-3.0, le droit d'auteur appartenant à youngcan pour 2024-2026. La clause de risque du README précise que l'outil est destiné à un usage éducatif, de recherche et d'information, qu'il ne fournit pas de conseils en investissement et ne garantit pas les performances futures.
- Puis-je l’utiliser commercialement ?
- Oui, sous conditions strictes. AGPL-3.0 est une licence à copyleft réseau : si des personnes utilisent une version modifiée via un réseau, par exemple comme service hébergé, vous devez leur proposer son code source sous la même licence.
- Est-il encore maintenu ?
- Oui. Les derniers commits datent d’il y a 2 jours.
- En quel langage est-il écrit ?
- Principalement Python, d’après les statistiques de langage de GitHub.
Ces réponses reposent sur les données GitHub du projet (dernière synchronisation le 14 septembre 2026) et sur notre analyse. Elles ne constituent pas un avis juridique.
ANALYSE OPEN SOURCE APPROFONDIE
Un agent conversationnel pour l'analyse volume-prix
Le README présente WyckoffTradingAgent comme une interface en langage naturel avec un expert de l'analyse Wyckoff. L'agent dispose de 10 outils professionnels et de 5 capacités générales, et enchaîne des raisonnements en plusieurs étapes avant de rendre un verdict. Le périmètre couvre les actions chinoises, hongkongaises et américaines. La liste des outils comprend la recherche par nom ou par pinyin, le diagnostic Wyckoff, la gestion de portefeuille, la vue d'ensemble du marché, le filtrage par entonnoir, la génération de rapports IA, les décisions stratégiques, les requêtes historiques, le backtesting et le suivi des tâches en arrière-plan. Les capacités générales décrites dans le tableau sont l'exécution de commandes shell, la lecture et l'écriture de fichiers, et la recherche web via Chrome CDP local. Le README indique que l'ordre et la fréquence des appels d'outils sont décidés par le LLM à l'exécution, sans chorégraphie préétablie.
Trois voies d'accès : Web, CLI et MCP
L'application web React sur wyckoff-analysis.pages.dev ne nécessite aucune installation et comprend un chat avec agent IA, la gestion de portefeuille, le filtrage par entonnoir, le suivi des recommandations, l'export de données, la sortie en streaming et la visualisation des appels d'outils. La CLI est présentée comme le workflow terminal natif recommandé avec l'ensemble de fonctionnalités le plus complet, incluant les tâches en arrière-plan, la mémoire de l'agent, les compétences, le serveur MCP et le stockage local SQLite. Le serveur MCP expose 10 outils via le protocole MCP, utilisables directement par Claude Code, Cursor ou tout client MCP. Le README note que l'ancien MVP Streamlit est retiré ; son code d'exécution est conservé sur la branche release/streamlit, et les captures d'architecture et notes du MVP sont archivées dans STREAMLIT_MVP_ARCHITECTURE.md.
L'entonnoir principal en cinq couches
Le moteur de sélection est structuré en entonnoir à cinq couches. L1 retire les valeurs ST, BSE et STAR Market et applique des filtres de capitalisation minimale et de volume quotidien moyen, avec un seuil de capitalisation de 3,5 milliards de CNY et un volume quotidien d'au moins 50 millions de CNY. L2 mesure la force de huit canaux : Rally, Ignition, Stealth, Accumulation, Dry Volume, Support, Trend Continuation et Breakout Acceleration. La couche principale utilise un moteur thématique avec chaleur de concept dynamique, radar thématique, qualité financière et portes de timing. L3 filtre les secteurs faibles tout en permettant aux actions fortes et aux thèmes vérifiés de contourner les limites fixes Top-N de secteurs. L4 recherche des micro-déclencheurs : Spring, LPS, SOS, EVR, Compression et Trend Pullback. L5 applique un examen par LLM, une confirmation de signal sur plusieurs jours et des portes de risque OMS. Seuls les candidats confirmés dont l'ouverture du lendemain se situe dans la fourchette d'entrée OMS unique peuvent être achetés. NEUTRAL est le principal terrain de jeu, et RISK_ON bloque les nouveaux achats.
Sources de données et chaîne de repli
Les données quotidiennes passent par une chaîne de cinq sources : tickflow, tushare, akshare, baostock et efinance. Lorsqu'une source est indisponible, le système bascule automatiquement sur la suivante, sans intervention manuelle. Le README recommande de connecter TickFlow pour des capacités temps réel et intraday plus fortes sur les actions chinoises, américaines et hongkongaises, et fournit un lien vers sa page d'inscription. Dans le tableau de configuration, TUSHARE_TOKEN est répertorié comme obligatoire pour les données de marché, tandis que TICKFLOW_API_KEY est optionnel. Le README ne précise pas de limites de débit, de frais ou de latence pour ces sources ; ces informations devraient être vérifiées séparément.
Installation et exécution de la CLI
Le README présente trois méthodes d'installation locale. L'installation en une ligne récupère install.sh depuis le dépôt et le transmet à bash ; elle détecte Python, installe uv et crée un environnement isolé, après quoi la commande wyckoff est disponible. Les utilisateurs de Homebrew peuvent exécuter brew tap YoungCan-Wang/wyckoff et brew install wyckoff. Une voie pip utilise uv venv, uv pip install youngcan-wyckoff-analysis, puis wyckoff. Après le lancement, deux étapes sont nécessaires : /model pour choisir un modèle comme Gemini, Claude ou OpenAI et saisir une clé API, puis commencer à poser des questions. Aucune inscription n'est requise et les données de portefeuille restent locales. Le tableau de bord local se lance avec wyckoff dashboard sur le port par défaut 8765. Un déploiement React local est documenté sous web/apps/web avec pnpm install et pnpm dev.
Automatisation planifiée via GitHub Actions
Le dépôt documente un ensemble de tâches d'automatisation quotidiennes exécutées via GitHub Actions et Codex Automation, toutes en heure de Pékin. L'entonnoir, le rapport IA et le rééquilibrage s'exécutent du dimanche au jeudi à 17h17, les résultats étant poussés vers Feishu ou Telegram. Le diagnostic des positions est un déclencheur manuel workflow_dispatch. La surveillance du risque avant ouverture s'exécute du lundi au vendredi à 08h20 avec des alertes sur les futures A50 et le VIX à quatre niveaux d'alerte. Une revue des mouvements forts s'exécute en semaine à 19h25 pour les actions avec un rendement de clôture supérieur à 7 pour cent après une clôture précédente inférieure à 3 pour cent. Le reprice des recommandations s'exécute en semaine à 23h00. La grille de backtest s'exécute le 1er et le 15 de chaque mois à 04h00, couvrant 8 combinaisons de paramètres. La maintenance de la base de données s'exécute du mardi au samedi à 06h20, supprimant les cotations, ordres, signaux, signaux de marché et autres données de fenêtre glissante obsolètes.
Licence, avertissements et questions ouvertes
Le projet est sous licence AGPL-3.0, le droit d'auteur appartenant à youngcan pour 2024-2026. L'extrait de licence la décrit comme une licence copyleft libre conçue pour les logiciels de serveur réseau ; elle exige que les opérateurs de serveurs accessibles au public qui exécutent une version modifiée fournissent le code source de cette version aux utilisateurs. C'est l'une des obligations centrales de la licence. Le README contient une clause de risque indiquant que l'agent est destiné à un usage éducatif, de recherche et d'information, ne fournit pas de conseils en investissement et ne garantit pas les performances futures. Les sources fournies ne mentionnent pas de garanties de sécurité, de canaux de support formels ou de conditions de garantie au-delà du texte de licence ; ces détails devraient être vérifiés ailleurs.
Conclusion éditoriale
Le projet est sous licence AGPL-3.0, le droit d'auteur appartenant à youngcan pour 2024-2026. La clause de risque du README précise que l'outil est destiné à un usage éducatif, de recherche et d'information, qu'il ne fournit pas de conseils en investissement et ne garantit pas les performances futures. Les sources fournies ne mentionnent pas de garanties de sécurité, de support formel ou de conditions de garantie au-delà de ce que le texte de licence accorde lui-même. Pour WyckoffTradingAgent, le premier contrôle doit porter sur la commande d’installation et la configuration indiquées dans le README, puis sur la sortie attendue dans votre environnement.
Notes de la communauté