{"repo":"simonlin1212/global-stock-data","free":true,"listed":false,"github":"https://github.com/simonlin1212/global-stock-data","clone":"git clone https://github.com/simonlin1212/global-stock-data.git","description":"US stock market data for AI coding assistants — zero-auth, official sources. CBOE options with full Greeks + 0DTE flow, FINRA market-wide short volume, SEC EDGAR filing stream, and a free market-wide screener. 13 layers, 30+ endpoints, 11 sources. Every source labeled with its compliance tier.","language":null,"stars":1474,"topics":["0dte","ai-skill","cboe","claude-code","financial-data","finra","fintech","llm-tools","market-data","options-data","python","sec-edgar","trading","us-stocks"],"license":"Apache-2.0","category":"financial_data_toolkit","readme_excerpt":"

简体中文 | English

\n\n

global-stock-data

\n\n

\n US Market Data for AI Coding Assistants
\n Options Greeks · 0DTE Flow · SEC Filings · Short Volume · Fundamentals · Screener\n

\n\n

\n \"License:\n \"Python\n \"GitHub\n \"Layers\"\n \"Endpoints\"\n \"Sources\"\n \"Zero-Auth\"\n

\n\n

\n Architecture ·\n Compliance ·\n Quick Start ·\n Endpoints ·\n Data Sources ·\n FAQ\n

\n\n> **Full-stack market data for US equities** — 13 layers · 30+ endpoints · 11 sources · zero-auth · only `requests`.\n>\n> **Official-source-first (V2.0):** CBOE options with full Greeks + **0DTE** flow, FINRA market-wide short volume, SEC EDGAR filing stream + a free market-wide screener, Treasury / CFTC / earnings calendar. **Every source is labeled with its compliance tier, terms quoted verbatim** — \"official\" does not mean \"free to use\".\n\nA single self-contained Skill file that turns raw US stock data — scattered across many sources — into a toolkit an AI coding assistant can call directly. You no longer memorize Eastmoney secid prefixes, Yahoo crumb auth flows, or SEC EDGAR CIK mappings. That's all handled.\n\n> *This project distributes **code, not market data**. Data is fetched by the user under each source's own terms. For commercial use, rely only on tier-S sources.*\n\n> Compatible with [Claude Code](https://github.com/anthropics/claude-code) · [Codex](https://github.com/openai/codex) · [OpenClaw](https://github.com/anthropics/openclaw). The Skill file is structured Markdown + embedded Python — any AI coding assistant with context injection can use it.\n\n---\n\n## Architecture\n\n```\nUS Full-Stack Data · 13-layer architecture · V2.0\n│\n├── Market Data Sina + Tencent + Eastmoney push2 Real-time quotes, 25-78 fields\n├── K-line Sina(back to 1984) + Yahoo chart Daily / weekly / monthly / minute\n├── Technical Ind. MA/EMA + MACD + RSI + KDJ + Bollinger Pure Python, zero extra deps\n├── Fundamentals Eastmoney + Yahoo + SEC XBRL Statements + key metrics + holdings\n├── Fund Flow Eastmoney push2his Daily main/large/medium/small flow\n├── Options Yahoo crumb Options chain (US only)\n├── SEC Filing EDGAR submissions + XBRL 10-K/10-Q/8-K + 503 GAAP metrics (US)\n└── Tools Eastmoney + Yahoo + SEC CIK Search + market list + news + ticker↔CIK\n\n━━━ New in V2.0 (official-source-first) ━━━\n├── Options·CBOE cdn.cboe.com official feed ⭐ full chain + IV + delta/gamma/vega/theta/rho + 0DTE + flow\n├── Short Volume FINRA Reg SHO ⭐ market-wide daily short volume (12,112 symbols) + series\n├── Filing Stream EDGAR daily index + FTS ⭐ Form 4 / 8-K / 13F same-day + full-text since 2001\n├── Market Screener EDGAR frames ⭐ any XBRL tag across the whole market (1,842~5,309 co.) — free\n└── Macro / Calendar Treasury + CFTC + Nasdaq ⭐ yield curve (1M~30Y) + COT + earnings calendar\n```\n\n---\n\n## Compliance tiers\n\nSource terms differ a lot. **\"Official\" does not mean \"free to use\".** These tiers come from reading each source's actual terms of service on 2026-07-24. Quotes are verbatim.\n\n| Tier | Commercial | Redistribute | Sources | Basis (quoted) |\n|---|---|---|---|---|\n| **S** | ✅ | ✅ | SEC EDGAR / Treasury / CFTC | EDGAR: *\"Anyone can access and download this information **for free**\"*, *\"We **allow scripted access**\"*. Hard limit **10 req/s**, User-Agent required |\n| **B** | ⚠️ verify first | ❌ | FINRA | Files are published for download, but terms prohibit *\"data mining, scraping or harvesting tools (including robots)\"* and state *\"**non-commercial use**\"* |\n| **C** | ❌ needs permission | ❌ | CBOE / Nasdaq / Yahoo / Eastmoney / Sina / Tencent | CBOE requires *\"**approval in advance**\"* + *\"**execution of a license agreement**\"*; Yahoo states **personal use only** |\n| **⛔ Excluded** | — | — | HKEX (CCASS) | Terms prohibit *\"any '**robot**', '**bot**', '**spider**', '**scraper**'...\"* and apply *\"**whether or not for gain**\"* → **this tool ships no scraper for it** |\n\nA working HKEX shareholding layer was built, then removed. Shipping code that violates a source's terms would defeat the point of grading sources in the first place. **This project distributes code, not data.** For commercial use, rely only on tier S.\n\n---\n\n## Quick start\n\n**3 steps, 2 minutes.**\n\n```bash\n# 1. Create the skill directory\nmkdir -p ~/.claude/skills/global-stock-data\n\n# 2. Download SKILL.md\ncurl -o ~/.claude/skills/global-stock-data/SKILL.md \\\n https://raw.githubusercontent.com/simonlin1212/global-stock-data/main/SKILL.md\n\n# 3. Install the dependency\npip install requests\n```\n\n⚠️ **Before using the SEC layers, set `SEC_CONTACT` in SKILL.md to your real name and email.** SEC requires a declared User-Agent; requests without one are rejected as an *Undeclared Automated Tool*. The code raises a clear error if you forget.\n\nLaunch Claude Code and say \"check AAPL's financials\" — the skill activates on its own. **Codex / OpenClaw users:** paste SKILL.md into your system prompt or project context file; the embedded Python runs as-is.\n\n---\n\n## Endpoints\n\n**Price** — Sina / Tencent / Eastmoney quotes (25-78 fields) · Sina & Yahoo K-line (US back to 1984, daily→minute) · MA/EMA/MACD/RSI/KDJ/Bollinger computed locally.\n\n**Value** — Eastmoney three statements + GMAININDICATOR (US 49 / HK 75 fields) · Yahoo quoteSummary (23 modules: financials, analysts, institutional holdings) · SEC EDGAR XBRL (503 GAAP metrics).\n\n**Flow & positioning ⭐** — CBOE options with full Greeks + IV + **0DTE** + unusual-flow detection · FINRA market-wide daily short volume (12,112 symbols) · Eastmoney daily fund flow.\n\n**Filings & events ⭐** — EDGAR daily index (same-day **Form 4 insider / 8-K / 13F**, one day: 547 / 370 / 261) · full-text search since 2001 · 10-K/10-Q/8-K list.\n\n**Screener & macro ⭐** — EDGAR frames (any XBRL tag across the whole market, free — net income CY2025Q1 = 5,309 companies) · Treasury yield curve (1M~30Y) · CFTC COT · Nasdaq earnings calendar.\n\n**Tools** — stock search (CN+EN) · full-market list (US 5925+ / HK 18000+) · news by ticker · ticker↔CIK.\n\n
\nFull endpoint tables\n\n
\n\n### Options ⭐ (US only)\n\n| Endpoint | Data |\n|----------|------|\n| **CBOE official** | Full chain + **IV + delta/gamma/vega/theta/rho**, plus **0DTE filtering** and **unusual-flow** detection (vol/OI > 1 = new positioning) |\n| Yahoo (fallback) | Options chain, all expiries — **no Greeks** |\n\n### Short volume ⭐ (US only)\n\n| Endpoint | Data |\n|----------|------|\n| FINRA Reg SHO | Market-wide **daily short volume** (12,112 symbols), per-symbol series, ratio ranking |\n\n### Filing stream ⭐ (US only)\n\n| Endpoint | Data |\n|----------|------|\n| EDGAR daily index | Same-day **Form 4 / 8-K / 13F / 144** — one day: 547 / 370 / 261 / 118 |\n| EDGAR full-text | Search every filing body back to 2001 |\n| EDGAR submissions / XBRL | Filing list + structured financials (503 GAAP metrics) |\n\n### Market screener ⭐ (US only)\n\n| Endpoint | Data |\n|----------|------|\n| EDGAR frames | One XBRL tag across the whole market in one call — a free screener |\n\n### Macro / calendar ⭐\n\n| Endpoint | Data |\n|----------|------|\n| Treasury / CFTC / Nasdaq | Yield curve (1M~30Y) · COT · earnings calendar (pre/post-market + EPS est.) |\n\n### Price / value / flow / tools\n\n| Endpoint | Data |\n|----------|------|\n| Sina / Tencent / Eastmoney push2 | US/HK real-time quotes, 25-78 fields |\n| Sina / Yahoo chart | K-line, daily→minute, US back to 1984 |\n| Eastmoney datacenter / GMAININDICATOR | Statements + key metrics (bilingual) |\n| Yahoo quoteSummary | 23 modules: financials / analysts / institutional holdings |\n| Eastmoney push2his | Daily main/large/medium/small fund flow |\n| Eastmoney search / push2 list / Yahoo search / SEC CIK | Search / full-market list / news / ticker↔CIK |\n\nEvery source is free, no API key. Yahoo crumb is auto-managed; SEC EDGAR only needs a declared User-Agent.\n\n
\n\n---\n\n## Usage examples\n\nJust tell your AI assistant:\n\n| Scenario | Prompt |\n|----------|--------|\n| 0DTE options flow ⭐ | \"Show NVDA's 0DTE options flow — unusual activity\" |\n| Short volume ⭐ | \"TSLA's short volume ratio trend this week\" |\n| Insider filings ⭐ | \"Any Form 4 insider filings today for my watchlist\" |\n| Full-text filings ⭐ | \"Which companies first mentioned 'HBM4' in an 8-K\" |\n| Market screener ⭐ | \"Rank all filers by R&D expense for CY2025Q1\" |\n| Macro ⭐ | \"What's the 10Y-2Y Treasury spread right now\" |\n| US / HK quote | \"AAPL's price and PE\" · \"How's Tencent 00700 today\" |\n| K-line | \"Pull TSLA's daily K-line for the past 6 months\" |\n| Statements / valuation | \"Apple's latest income statement\" · \"BABA's PE/PB/ROE + target\" |\n| Institutional holdings | \"Which institutions hold NVDA, and what %\" |\n| Technical analysis | \"AAPL's MACD and RSI — any golden cross?\" |\n| Batch compare | \"Compare","default_branch":"main","files":8,"tree":[".github/FUNDING.yml","CHANGELOG.md","LICENSE","README.md","README_zh.md","SKILL.md","assets/bmc-qr.png","assets/bmc-sponsor.png"],"storefront":"/r/simonlin1212","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/simonlin1212/global-stock-data/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}