global-stock-data  by simonlin1212

US & HK Stock Data Toolkit for AI Assistants

Created 3 weeks ago

New!

263 stars

Top 96.9% on SourcePulse

GitHubView on GitHub
Project Summary

Summary This project offers a unified, zero-authentication toolkit for US and Hong Kong stock data, targeting AI coding assistants and technical users. It consolidates data from five sources (Sina, Tencent, Eastmoney, Yahoo, SEC EDGAR), abstracting authentication and parsing complexities to simplify financial data retrieval.

How It Works An 8-layer architecture integrates data via direct HTTP API calls, minimizing dependencies to requests. It automatically handles Yahoo's crumb authentication and uses a standard User-Agent for SEC EDGAR, eliminating the need for API keys. Technical indicators are computed in pure Python.

Quick Start & Requirements

  1. Create directory: mkdir -p ~/.claude/skills/global-stock-data
  2. Download SKILL.md: curl -o ~/.claude/skills/global-stock-data/SKILL.md https://raw.githubusercontent.com/simonlin1212/global-stock-data/main/SKILL.md
  3. Install dependency: pip install requests

The skill integrates seamlessly with AI assistants like Claude Code. Codex/OpenClaw users can paste SKILL.md content into their system prompts.

Highlighted Details

  • All five data sources are free, requiring no API keys.
  • Yahoo Finance authentication (cookie + crumb) is auto-managed.
  • Provides comprehensive US/HK data: real-time quotes, historical K-lines (US back to 1984), fundamentals, fund flows, US options, and US SEC filings.
  • Features 18 endpoints, including pure Python technical indicators (MA, MACD, RSI, etc.).
  • Offers full market lists: US (5925+ stocks) and HK (18000+ stocks).
  • Deep SEC EDGAR integration for filings and 503 GAAP metrics.

Maintenance & Community Authored by Simon Lin. Links to author's social media (TikTok, Douyin, WeChat) are provided. No specific community channels or roadmap details were found.

Licensing & Compatibility Licensed under Apache License 2.0, permitting free commercial use with attribution.

Limitations & Caveats

  • Hong Kong options data is unavailable.
  • Users in mainland China may face instability accessing Yahoo/SEC; proxies or alternative sources are recommended.
  • Sina's HK K-line data is reported as down.
  • SEC EDGAR rate limits (10 req/sec) are managed by the tool's User-Agent.
Health Check
Last Commit

3 weeks ago

Responsiveness

Inactive

Pull Requests (30d)
1
Issues (30d)
0
Star History
263 stars in the last 23 days

Explore Similar Projects

Feedback? Help us improve.