À propos du projet
global-stock-data regroupe l'accès aux données de marché des actions américaines et du marché hongkongais dans un seul fichier SKILL.md contenant des instructions Markdown et du Python intégré. Il est conçu pour des assistants de codage IA tels que Claude Code, Codex et OpenClaw, mais le Python peut aussi être copié dans des scripts classiques. Le projet nécessite Python 3.9+ et la bibliothèque requests ; aucune clé API distincte n'est requise. La gestion des cookies/crumb Yahoo est automatisée, tandis que SEC EDGAR exige un User-Agent déclaré avec de véritables informations de contact.
La boîte à outils est organisée en 13 couches. Les endpoints de données de marché fournissent des cotations US/HK depuis Sina, Tencent et Eastmoney, avec 25 à 78 champs selon la source. La prise en charge des K-lines inclut les intervalles journaliers, hebdomadaires, mensuels et minute, avec un historique Sina/Yahoo pour les symboles américains décrit comme remontant à 1984. Les indicateurs techniques — MA, EMA, MACD, RSI, KDJ et bandes de Bollinger — sont calculés localement sans dépendances supplémentaires.
Les données fondamentales incluent les états financiers et indicateurs clés d'Eastmoney, les modules quoteSummary de Yahoo couvrant les finances, les analystes et les participations institutionnelles, ainsi que les données SEC XBRL avec 503 métriques GAAP. Eastmoney est également utilisé pour les flux de fonds quotidiens par ordres principaux, gros, moyens et petits. Les fonctions utilitaires couvrent la recherche d'actions, les listes de marchés US/HK, les actualités par ticker et la correspondance ticker-vers-CIK.
La version 2.0 met l'accent sur les données issues en priorité de sources officielles. La prise en charge des options CBOE fournit une chaîne complète, la volatilité implicite, delta, gamma, vega, theta, rho, le filtrage 0DTE et la détection de flux inhabituels basée sur le volume/open interest ; Yahoo est disponible comme chaîne de repli sans les Grecs. FINRA Reg SHO fournit le volume à découvert quotidien à l'échelle du marché, des séries par symbole et un classement par ratio. Les fonctionnalités SEC EDGAR incluent l'accès le jour même à l'index quotidien pour des formulaires tels que Form 4, 8-K, 13F et 144, la recherche en texte intégral remontant à 2001, des listes de dépôts et des états financiers XBRL structurés. Les frames EDGAR servent de screener à l'échelle du marché pour n'importe quel tag XBRL. Les endpoints macro et calendrier couvrent la courbe des taux du Trésor américain, les rapports Commitments of Traders de la CFTC et les calendriers de résultats du Nasdaq.
Une caractéristique notable est l'étiquetage de conformité des sources. Le niveau S couvre les sources SEC EDGAR, Trésor américain et CFTC, décrites comme adaptées à un usage commercial et à une redistribution dans le cadre de leurs règles. FINRA est de niveau B et le README conseille une vérification avant tout usage commercial. CBOE, Nasdaq, Yahoo, Eastmoney, Sina et Tencent sont de niveau C car leurs conditions exigent une approbation, limitent l'usage à des fins personnelles/de recherche, ou n'ont pas été vérifiées. Le projet indique qu'il distribue du code plutôt que des données de marché, conseille de ne s'appuyer que sur les sources de niveau S pour un usage commercial, et n'inclut aucun scraper HKEX en raison des restrictions de cette source.
Les requêtes utilisent HTTP direct et un limiteur de débit thread-safe intégré, avec le trafic SEC plafonné sous la limite annoncée d'EDGAR. Le dépôt est sous licence Apache-2.0 et inclut un avertissement précisant qu'il s'agit d'un outil d'accès aux données, et non d'un conseil en investissement.
Comments
0 people shared their preference · Deer Point appears after 10 participants
Sign in to join the discussion.