stock-api

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.