| name | stock-api |
| description | Fetch real-time stock quotes, K-line (candlestick) history, and search symbols for China A-shares, Hong Kong, and US markets. Use when the user asks for a stock price, a quote, market data, candlestick/K-line data, or to look up a stock code by company name. |
stock-api
Get normalized stock market data by running the stock-api CLI. It covers
China A-shares, Hong Kong, and US markets, with automatic provider fallback
across Tencent, Sina, and Eastmoney.
When to use
- The user wants a current price or quote for one or more stocks.
- The user wants K-line / candlestick history for charting or analysis.
- The user knows a company name but not its code (search first, then quote).
How to run
Use npx stock-api <command>. Every command prints JSON to stdout.
Stock codes use a market prefix: SH / SZ (China), HK (Hong Kong),
US (US). Examples: SH510500, SZ000651, HK02020, USDJI.
Get one quote
npx stock-api get-stock SH510500
Get several quotes at once
npx stock-api get-stocks SH510500 SZ000651
Get K-line (candlestick) history
npx stock-api get-klines SH600519 --period week --count 20
--period — day (default), week, or month.--count — number of rows (defaults to the provider default).--adjust — none (default), qfq (forward), or hfq (backward).
Search a code by keyword
npx stock-api search-stocks 格力电器
Options (all commands)
--source — auto (default), tencent, sina, or eastmoney.
Leave it on auto unless the user asks for a specific provider; auto
falls back across providers if one fails.
Notes
- Output is JSON — parse it, don't reformat by hand, before showing the user.
- If a code returns no data, try
search-stocks to confirm the correct code.
- For programmatic/persistent use, this same engine is also available as an
MCP server:
npx stock-api mcp. Prefer the CLI commands above for one-off
lookups.
