← all repositories
simonlin1212/global-stock-data

This AI market-data skill actually read the terms of service

A single Markdown skill file turns AI coding assistants into zero-auth terminals for US and HK equities — with every source audited for legal compliance.

1.2k stars Data ToolingOther AI
global-stock-data
Collecting fresh signals — velocity needs a few days of history.
collecting data…
star history

What it does The entire toolkit ships as one Markdown file with embedded Python that drops into AI coding assistants. It wraps roughly 30 HTTP endpoints across 11 free sources into a unified interface for US and Hong Kong equities, handling Yahoo cookie crumbs, SEC CIK mappings, and rate limits so the AI doesn’t have to. You ask the assistant for a quote, an income statement, or unusual 0DTE options flow, and the skill fetches and formats the data on the fly.

The interesting bit The author read every source’s terms of service, quoted them verbatim, and assigned compliance tiers. When HKEX’s terms prohibited scrapers “whether or not for gain,” the working layer was removed rather than shipped. That makes this less a data library and more a legal-paranoid wiring harness.

Key highlights

  • 13 data layers covering quotes, K-lines, technical indicators, fundamentals, fund flow, options, SEC filings, and macro data
  • CBOE official feed for US options with full Greeks, implied volatility, and 0DTE unusual-flow detection
  • FINRA market-wide daily short volume across 12,112 symbols, plus same-day SEC EDGAR Form 4/8-K/13F filing streams
  • Free market-wide screener via SEC EDGAR frames: query any XBRL tag across thousands of companies in one call
  • Zero API keys; only dependency is requests. Yahoo cookie/crumb and SEC User-Agent handling are built in.

Caveats

  • Most real-time and options sources (CBOE, Yahoo, Eastmoney, Sina, Tencent) are tier C: personal/research use only, and CBOE explicitly requires prior approval plus a license agreement for commercial use
  • HK options data is unavailable; HKEX was excluded entirely due to restrictive terms, and Yahoo doesn’t cover HK options
  • Running from mainland China may hit connectivity snags with overseas sources like Yahoo or SEC EDGAR

Verdict Worth a look if you want your AI assistant to fetch live market data without wiring up a dozen auth flows yourself, but treat it as a research convenience rather than a production trading stack — most real-time sources carry personal-use-only restrictions.

Frequently asked

What is simonlin1212/global-stock-data?
A single Markdown skill file turns AI coding assistants into zero-auth terminals for US and HK equities — with every source audited for legal compliance.
Is global-stock-data open source?
Yes — simonlin1212/global-stock-data is open source, released under the Apache-2.0 license.
How popular is global-stock-data?
simonlin1212/global-stock-data has 1.2k stars on GitHub.
Where can I find global-stock-data?
simonlin1212/global-stock-data is on GitHub at https://github.com/simonlin1212/global-stock-data.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.