China Stocks MCP server

@pipeworx/china-stocks

Live data for the Chinese A-share market (Shanghai / Shenzhen / STAR / ChiNext) — real-time quotes, daily OHLCV history, the limit-up board, market-wide turnover ranking, and company earnings guidance/analyst consensus.

Part of Pipeworx — an MCP gateway connecting AI agents to 1679+ live data sources.

Tools

• asharesmarketsnapshot() — headline index levels (Shanghai Composite, Shenzhen Component, ChiNext, STAR 50, CSI 300) plus limit-up count as a sentiment gauge.
• ashareslimitup({ date?, limit? }) — the daily limit-up board (涨停板): how many stocks hit their daily price limit and the ranked pool with consecutive-board count, seal fund, industry, turnover.
• ashares_quote({ symbols }) — real-time quote(s) by 6-digit code, comma-separated.
• asharesdailyhistory({ codes, start, end?, adjust? }) — daily OHLCV history (open/high/low/close/volume, day-over-day change %) for up to 20 codes over a date range. adjust: qfq (forward-adjusted, default), hfq (backward-adjusted), or none (raw). Turnover amount (成交额) is not exposed by the daily-bar source, so amountcny reports "notavailable" per row rather than being estimated — use asharesquote or asharesturnover_ranking for same-day turnover amount.
• asharesturnoverranking({ limit?, sort?, order?, board? }) — market-wide ranking by turnover amount, change %, or volume, server-side sorted, with turnover in CNY.
• asharesearningsforecast({ symbol, limit? }) — company-issued earnings guidance (业绩预告): predicted profit range, YoY change %, forecast type, stated reason.
• asharesanalystconsensus({ symbol }) — analyst consensus estimates (盈利预测) per forecast year: EPS, PE, net profit, revenue.

Auth

Keyless. All upstreams are public, unauthenticated endpoints.

Data sources

• https://push2ex.eastmoney.com/getTopicZTPool — limit-up pool (涨停板).
• https://hq.sinajs.cn/list=... — real-time quotes and index levels (GBK-encoded; decode with TextDecoder('gbk')).
• https://vip.stock.finance.sina.com.cn/quotesservice/api/jsonv2.php/Market_Center.getHQNodeData — market-wide ranked node listing (turnover/volume/change % ranking); no industry field.
• https://datacenter-web.eastmoney.com/api/data/v1/get — earnings guidance / analyst consensus datacenter reports. Note: this is a different Eastmoney host from push2.eastmoney.com, which is empty from any IP — don't lump them together.
• https://web.ifzq.gtimg.cn/appstock/app/fqkline/get — Tencent/gtimg daily K-line bars. param=,day,,,, where is sh/sz/bj + 6-digit code and is qfq/hfq/empty (unadjusted, still needs the trailing comma or the request 400s). Response key is qfqday/hfqday/day matching the adjust arg; an invalid code returns HTTP 200 with an empty day array rather than an error, so treat empty rows as found: false, not a fetch failure. Rows are [date, open, close, high, low, volume] — note the volume unit is 手 (lots of 100 shares), not raw shares, and there is no turnover-amount field in any adjust variant. A single request only accepts one param= (repeating the query param keeps only the last), so multi-code history is N parallel requests, not a batch call.

Turnover amount is deliberately absent from asharesdailyhistory: checked both the gtimg row form (all three adjust variants) and Sina's hisdata/klckl.js second-leg endpoint (binary-encoded, not a usable JSON leg) — neither exposes daily amount, so it is reported as notavailable rather than derived from price × volume.

Quick Start

Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "china-stocks": {
      "url": "https://gateway.pipeworx.io/china-stocks/mcp"
    }
  }
}

What this endpoint actually serves

Shortened. The full README is on GitHub.