How do I install the Stock API skill?

Run npx skillmds@latest add zhangxiangliang/stock-api in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Stock API safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Stock API?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Stock API free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Stock API?

zhangxiangliang (@zhangxiangliang) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Stock API by zhangxiangliang — Agent Skill

Name: Stock API
Author: zhangxiangliang

Stock API

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.

zhangxiangliang 0ebd5d4 16 files · 417.4 KB Updated Sep 17, 2026

File contents

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.

---name: stock-apidescription: 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-apiGet normalized stock market data by running the `stock-api` CLI. It coversChina A-shares, Hong Kong, and US markets, with automatic provider fallbackacross 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 runUse `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```bashnpx stock-api get-stock SH510500```### Get several quotes at once```bashnpx stock-api get-stocks SH510500 SZ000651```### Get K-line (candlestick) history```bashnpx 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```bashnpx 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.

Frequently asked questions