Об этом проекте

global-stock-data упаковывает доступ к рыночным данным по акциям США и Гонконга в единый файл SKILL.md, содержащий инструкции на Markdown и встроенный Python. Он предназначен для ИИ-ассистентов программирования, таких как Claude Code, Codex и OpenClaw, но Python также можно скопировать в обычные скрипты. Проекту требуются Python 3.9+ и библиотека requests; отдельный API-ключ не нужен. Обработка cookie/crumb Yahoo автоматизирована, тогда как SEC EDGAR требует объявленного User-Agent с реальной контактной информацией. Набор инструментов организован в 13 слоёв. Эндпоинты рыночных данных предоставляют котировки США/Гонконга из Sina, Tencent и Eastmoney, с 25–78 полями в зависимости от источника. Поддержка K-линий включает дневные, недельные, месячные и минутные интервалы, при этом история Sina/Yahoo для символов США, как указано, достигает 1984 года. Технические индикаторы — MA, EMA, MACD, RSI, KDJ и полосы Боллинджера — рассчитываются локально без дополнительных зависимостей. Фундаментальные данные включают отчётность Eastmoney и ключевые показатели, модули Yahoo quoteSummary, охватывающие финансы, аналитиков и институциональные holdings, а также данные SEC XBRL с 503 метриками GAAP. Eastmoney также используется для ежедневного потока средств по основным, крупным, средним и малым ордерам. Утилитарные функции охватывают поиск акций, списки рынков США/Гонконга, новости по тикерам и сопоставление тикера с CIK. Версия 2.0 делает акцент на данных из официальных источников в первую очередь. Поддержка опционов CBOE предоставляет полную цепочку, подразумеваемую волатильность, delta, gamma, vega, theta, rho, фильтрацию 0DTE и обнаружение необычного потока на основе объёма/открытого интереса; Yahoo доступен как резервная цепочка без греков. FINRA Reg SHO предоставляет общерыночный ежедневный объём коротких продаж, серии по отдельным символам и рейтинг по коэффициенту. Возможности SEC EDGAR включают доступ к ежедневному индексу в тот же день для форм, таких как Form 4, 8-K, 13F и 144, полнотекстовый поиск с 2001 года, списки filings и структурированную финансовую отчётность XBRL. Фреймы EDGAR используются как общерыночный скринер для любого тега XBRL. Макро- и календарные эндпоинты охватывают кривую доходности Казначейства США, отчёты CFTC Commitments of Traders и календари прибыли Nasdaq. Заметная особенность — маркировка соответствия источников. Уровень S охватывает источники SEC EDGAR, Казначейства США и CFTC, описанные как подходящие для коммерческого использования и распространения в рамках их правил. FINRA относится к уровню B, и README советует проверить перед коммерческим использованием. CBOE, Nasdaq, Yahoo, Eastmoney, Sina и Tencent относятся к уровню C, поскольку их условия требуют одобрения, ограничивают использование личными/исследовательскими целями или не были проверены. Проект заявляет, что распространяет код, а не рыночные данные, советует для коммерческого использования полагаться только на источники уровня S и не включает скрапер HKEX из-за ограничений этого источника. Запросы используют прямой HTTP и встроенный потокобезопасный ограничитель частоты, при этом трафик SEC ограничен ниже заявленного лимита EDGAR. Репозиторий лицензирован под Apache-2.0 и включает отказ от ответственности о том, что это инструмент доступа к данным, а не инвестиционный совет.