OpenParable
Skip to content
← Back to skills

Stock API

Business
stock-api

Stock API is an Agent Skill for business published in the zhangxiangliang/stock-api repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/zhangxiangliang/stock-api/blob/HEAD/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/stock-api, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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.