whatisgithub

What is global-stock-data?

simonlin1212/global-stock-data — explained in plain English

Analysis updated 2026-05-18

69Audience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

A Claude Code skill file that pulls real-time quotes, price history, financials, and SEC filings for US and Hong Kong stocks from five free data sources, no API key required.

Mindmap

mindmap
  root((global-stock-data))
    What it does
      Stock data skill file
      Five free data sources
      No API keys needed
    Tech stack
      Python
      requests
    Use cases
      Real time quotes
      Technical indicators
      SEC filings and XBRL
    Coverage
      US stocks
      Hong Kong stocks
      Options chains
    Audience
      Developers
      AI assistant users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Ask an AI coding assistant for a stock's current price, P/E ratio, or financial statements in plain language.

USE CASE 2

Pull historical price charts and calculate technical indicators like MACD, RSI, and Bollinger Bands without extra libraries.

USE CASE 3

Screen the full US or Hong Kong stock market by price change or trading volume, or pull SEC filing and XBRL data for US companies.

What is it built with?

Pythonrequests

How does it compare?

simonlin1212/global-stock-data8bit64k/cronalyticsclashconnectrules/egern
Stars696969
LanguagePython
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencedeveloperops devopsgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Only needs the requests library, Yahoo and SEC authentication is handled automatically by the code.

Apache 2.0 license, free to use for any purpose including commercial, as long as you keep attribution notices.

So what is it?

This is a collection of stock market data tools packaged as a single skill file for AI coding assistants like Claude Code. It provides access to real-time and historical price data, financial statements, technical indicators, and institutional holdings for US and Hong Kong-listed stocks, pulling from five different data sources without requiring any API keys or subscriptions. The project wraps five external sources (Eastmoney, Sina Finance, Tencent Finance, Yahoo Finance, and the SEC EDGAR system) into 18 ready-to-use functions. Data ranges from real-time quotes (25 to 78 fields per stock depending on the source) to daily, weekly, and monthly price history going back to 1984. Financial statements covering income, balance sheet, and cash flow are available in both Chinese and English formats. Technical indicators such as moving averages, MACD, RSI, KDJ, and Bollinger Bands are calculated in pure Python with no additional library dependencies. Installing it takes three steps: create a directory in your Claude Code skills folder, download a single SKILL.md file, and run pip install requests. Once loaded, you talk to your AI assistant in natural language, for example asking for a current price and P/E ratio or requesting a fund flow breakdown for a specific ticker, and the assistant runs the appropriate function. The skill also covers options chains for US stocks, including Greeks and all expiration dates, SEC filing history with structured XBRL financial data containing over 500 GAAP metrics, and a full-market screener that can list all US or HK stocks sorted by price change or volume. Authentication is handled automatically: Yahoo Finance cookies and crumbs are fetched by the code itself, and SEC EDGAR only needs a standard User-Agent header. The README is primarily in Mandarin Chinese with a full English translation included. The project is released under the Apache 2.0 license and accepts feature requests via GitHub issues.

Copy-paste prompts

Prompt 1
Install this skill in Claude Code and show me AAPL's current price and P/E ratio.
Prompt 2
Pull TSLA's daily price history for the last six months and calculate its MACD and RSI.
Prompt 3
Show me the latest 10-K filing and key GAAP metrics for a US ticker using the SEC EDGAR endpoints in this skill.
Prompt 4
Compare the valuation metrics, ROE, and EPS across three US tickers using this toolkit's fundamentals functions.

Frequently asked questions

What is global-stock-data?

A Claude Code skill file that pulls real-time quotes, price history, financials, and SEC filings for US and Hong Kong stocks from five free data sources, no API key required.

What license does global-stock-data use?

Apache 2.0 license, free to use for any purpose including commercial, as long as you keep attribution notices.

How hard is global-stock-data to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is global-stock-data for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.