PandaStock
pandaData — A 股实时数据 SDK + MCP Server
A 股数据 API + AI 选股 · 开源客户端
基于 NATS 的 A 股实时数据通道 —— 行情、Level2、DDX 大单、资金流、选股信号主动推给你,不是让你轮询 REST。
⚡ 30 秒上手
免注册:内置公共测试账号,装完直接跑,无需申请。
pip install pandastock-mcpfrom panda_stock import PandaStock
# 公共测试账号(配额说明见下方「公共测试账号」)
ps = PandaStock(phone="pandastock", nid="pandastock")
ps.connect_server()
print(ps.get_ch_stock()) # 全市场股票列表
print(ps.get_ch_one_stock_real("600519")) # 单只实时行情
print(ps.get_ch_select_stock()) # AI 选股Related MCP server: Real-time Stock MCP Service
🤖 MCP 接入(Claude / Cursor / OpenClaw)
pip install pandastock-mcp{
"mcpServers": {
"panda-stock": {
"command": "pandastock-mcp",
"env": {
"PANDA_PHONE": "pandastock",
"PANDA_NID": "pandastock"
}
}
}
}升级:pip install --upgrade pandastock-mcp · 详见 mcp/config_example.json
📞 接口咨询 / 专属 key 申请:加微信
onestock188或pandastock888📅 最后更新:2026-09-26
✨ 特性
免注册试用:公共测试账号装完即可调用,先验证再申请专属 key
实时快照(请求/响应):4 个 CurReal 主题通过请求获取 A 股实时行情 / 指数 / 概念 / 行业,无需订阅
AI 选股:
get_ch_select_stock()等 AI 选股接口22 个开放接口:全部为请求/响应接口;服务端共 176 个接口覆盖全量数据(完整清单见 INTERFACES.md)
MCP ready:本地 stdio MCP Server 暴露 22 个工具,Claude / Cursor / OpenClaw 直接调用
📡 实时快照(请求/响应)
4 个 CurReal 主题通过请求方式获取实时快照,无需订阅:
# A股实时行情
print(ps.get_ch_stock_real())
# 指数实时
print(ps.get_ch_market_real())
# 概念板块实时
print(ps.get_ch_concept_real())
# 行业板块实时
print(ps.get_ch_industry_real())🎁 公共测试账号
开放一个公共测试账号,无需申请即可直接试玩:
字段 | 值 |
phone |
|
nid |
|
公共账号按来源 IP 限频、限接口、含全局日上限,仅供评估试玩。 正式 / 高频 / 全量接口,请申请专属 phone/nid:加微信 onestock188 或 pandastock888
初始化示例:
PandaStock(phone="pandastock", nid="pandastock")(与专属账号同一套服务端鉴权,仅配额不同)
🔑 测试账号可调用的 22 个接口(服务端共 176 个,完整清单 + 返回字段见 INTERFACES.md)
接口按成本/价值分档,客户端不含限制逻辑,鉴权/配额/频率/分级全部在服务端(NATS 网关)执行。
18 个请求/响应接口:
主题 | 方法 | 说明 |
chStockList |
| 股票列表 |
chConceptList |
| 概念板块列表 |
chIndustryList |
| 行业板块列表 |
ChStockCurReal |
| A股实时快照 |
ChMarketCurReal |
| 指数实时快照 |
ChConceptCurReal |
| 概念板块实时快照 |
ChIndustryCurReal |
| 行业板块实时快照 |
ChOneStockReal |
| 单只股票实时 |
chStockFrontDayHistory |
| 个股前复权日线 |
chConceptDayHistory |
| 概念日线 |
chIndustryDayHistory |
| 行业日线 |
chStockMinuteHistory |
| 分钟历史 |
ChMarketDayHistory |
| 指数日线 |
ChCoreNews |
| 核心资讯 |
ChDomesticNews |
| 国内要闻 |
ChGlobalNews |
| 全球要闻 |
ChOptionNews |
| 期权资讯 |
ChLimitUpDown |
| 涨跌停统计 |
ChLhbData |
| 龙虎榜 |
ChMarketFundFlow |
| 市场资金流 |
chAllMarketBearCompare |
| 全市场多空对比 |
chDdxStockData |
| 个股 DDX |
服务端共 176 个接口,完整清单(含「是否可测试」+ 每个接口返回的字段明细)见
INTERFACES.md(「接口返回字段详情」一节)。上表 22 个为已对公开 key 开放的请求接口。
全部 176 个接口一览(测试账号可调用标记)
完整返回字段见
INTERFACES.md的「接口返回字段详情」。标 ✅ 可调用 的即上方 22 个公开测试账号可调用接口;其余需专属 key 后使用。
分类 | 接口名称 | 方法(function) | 测试账号 |
Levle2和大单 | 订阅Level2实时数据通道 |
| — |
Levle2和大单 | 获取Level2实时数据 |
| — |
Levle2和大单 | 订阅大单数据(DDE)通道 |
| — |
Levle2和大单 | 获取大单数据(DDE) |
| — |
Levle2和大单 | 获取个股历史大单历史数据 |
| — |
Levle2和大单 | 个股千档数据 |
| — |
Levle2和大单 | 个股实时资金流数据 |
| — |
Levle2和大单 | 获取个股最新逐笔成交 |
| — |
Levle2和大单 | 获取个股全部逐笔成交数据 |
| — |
Levle2和大单 | 市场实时资金流数据 |
| — |
Levle2和大单 | 上证指数实时资金流数据 |
| — |
Levle2和大单 | 深圳市场实时资金流数据 |
| — |
Levle2和大单 | 创业板实时资金流数据 |
| — |
Levle2和大单 | 科创板实时资金流数据 |
| — |
Levle2和大单 | 个股实时大单成交明细 |
| — |
Levle2和大单 | 订阅Level2单只股成交明细 |
| — |
Levle2和大单 | 订阅Level2多只股成交明细 |
| — |
Levle2和大单 | 订阅Level2所有股成交明细 |
| — |
Levle2和大单 | 个股l2分价成交明细 |
| — |
Levle2和大单 | 订阅l2单只股十档行情通道 |
| — |
Levle2和大单 | 订阅l2多只股十档行情通道 |
| — |
Levle2和大单 | 订阅l2所有股票十档行情通道 |
| — |
Levle2和大单 | 订阅l2单只个股买 一卖一明细 |
| — |
Levle2和大单 | 订阅l2多只个股买 一卖一明细 |
| — |
Levle2和大单 | 订阅l2所有股票买 一卖一明细 |
| — |
Levle2和大单 | 日内实时暗盘资金 |
| — |
Levle2和大单 | 历史暗盘资金 |
| — |
Levle2和大单 | 个股DDE实时数据 |
| — |
新闻资讯 | 重点资讯新闻 |
| ✅ 可调用 |
新闻资讯 | 国内主要新闻 |
| ✅ 可调用 |
新闻资讯 | 国际主要新闻 |
| ✅ 可调用 |
新闻资讯 | 时评类新闻 |
| ✅ 可调用 |
新闻资讯 | 个股新闻 |
| — |
新闻资讯 | 财经快讯(数据源sn) |
| — |
新闻资讯 | 财经快讯(数据源SA) |
| — |
新闻资讯 | 个股公告 |
| — |
新闻资讯 | 个股研报 |
| — |
特色数据 | 每日ST股信息 |
| — |
特色数据 | 沪深300成分股权重 |
| — |
特色数据 | 上证50成分股权重 |
| — |
特色数据 | 中证500成分股权重 |
| — |
特色数据 | 中证1000成分股权重 |
| — |
特色数据 | 个股除权除息历史 |
| — |
特色数据 | 年度高送转/分红 |
| — |
特色数据 | 个股股本变化历史 |
| — |
特色数据 | 个股资金流明细历史 |
| — |
特色数据 | 年度解禁数据 |
| — |
特色数据 | 1日融资买入排行 |
| — |
特色数据 | 5日融资买入排行 |
| — |
特色数据 | 20日融资买入排行 |
| — |
特色数据 | 个股一致行动人信息 |
| — |
特色数据 | 市场每个交易日涨跌平数量 |
| — |
特色数据 | 上证A股每个交易日涨跌平数量 |
| — |
特色数据 | 深圳A股每个交易日涨跌平数量 |
| — |
特色数据 | 创业板每个交易日涨跌平数量 |
| — |
特色数据 | 科创板每个交易日涨跌平数量 |
| — |
特色数据 | 北证每个交易日涨跌平数量 |
| — |
特色数据 | 市场每个交易周涨跌平数量 |
| — |
特色数据 | 上证A股每个交易周涨跌平数量 |
| — |
特色数据 | 深圳A股每个交易周涨跌平数量 |
| — |
特色数据 | 创业板每个交易周涨跌平数量 |
| — |
特色数据 | 科创板每个交易周涨跌平数量 |
| — |
特色数据 | 北证每个交易周涨跌平数量 |
| — |
特色数据 | 市场每个交易月涨跌平数量 |
| — |
特色数据 | 上证A股每个交易月涨跌平数量 |
| — |
特色数据 | 深圳A股每个交易月涨跌平数量 |
| — |
特色数据 | 创业板每个交易月涨跌平数量 |
| — |
特色数据 | 科创板每个交易月涨跌平数量 |
| — |
特色数据 | 北证每个交易月涨跌平数量 |
| — |
特色数据 | 中国全社会用电量同比 |
| — |
特色数据 | 全市场PE/PB 月数据历史 |
| — |
特色数据 | 全市场PE/PB 日数据历史 |
| — |
特色数据 | 中国年度GDP同比增长率 |
| — |
特色数据 | 中国季度GDP同比增长率 |
| — |
特色数据 | 中国季度GDP环比增长率 |
| — |
特色数据 | 个股l2分价成交明细历史 |
| — |
特色数据 | 交易日涨跌停时序数据 |
| — |
特色数据 | 交易日涨跌分布时序数据 |
| — |
特色数据 | 交易日涨停股信息 |
| — |
特色数据 | 交易日全天成交额数据 |
| — |
特色数据 | 中国GDP 季度数据 |
| — |
港股行情 | 订阅港股实时行情通道 |
| — |
港股行情 | 获取港股实时行情 |
| — |
港股行情 | 订阅港股指数实时行情通道 |
| — |
港股行情 | 获取港股指数实时行情 |
| — |
港股行情 | 港股股票列表 |
| — |
港股行情 | 港股个股历史日线 |
| — |
港股行情 | 港股个股历史周线 |
| — |
港股行情 | 港股个股历史月线 |
| — |
港股行情 | 港股指数历史日线 |
| — |
港股行情 | 港股指数历史周线 |
| — |
港股行情 | 港股指数历史月线 |
| — |
港股行情 | 港股主要财务指标 |
| — |
港股行情 | 港股资产负债表 |
| — |
港股行情 | 港股利润表 |
| — |
港股行情 | 港股现金流表 |
| — |
个股数据 | 获取股票列表 |
| ✅ 可调用 |
个股数据 | 订阅实时行情通道 |
| — |
个股数据 | 获取所有个股实时行情 |
| ✅ 可调用 |
个股数据 | 获取单只个股实时行情 |
| ✅ 可调用 |
个股数据 | 个股实时分钟K线 |
| — |
个股数据 | 个股实时逐笔成交 |
| — |
个股数据 | 前复权日线 |
| ✅ 可调用 |
个股数据 | 前复权周线 |
| — |
个股数据 | 前复权月线 |
| — |
个股数据 | 后复权日线 |
| — |
个股数据 | 后复权周线 |
| — |
个股数据 | 后复权月线 |
| — |
个股数据 | 历史分笔 |
| — |
个股数据 | 主力评分数据 |
| — |
个股数据 | 个股资金流 |
| — |
个股数据 | 人气排名数据 |
| — |
个股数据 | 股东人数历史 |
| — |
个股数据 | 大宗交易历史 |
| — |
个股数据 | 增减持历史 |
| — |
个股数据 | 等比前复权日线 |
| — |
个股数据 | 等比前复权周线 |
| — |
个股数据 | 等比前复权月线 |
| — |
个股数据 | 等比后复权日线 |
| — |
个股数据 | 历史分钟数据 |
| ✅ 可调用 |
个股数据 | 个股分时图 |
| — |
个股数据 | 个股昨日分时图 |
| — |
个股数据 | 个股五日分时 |
| — |
个股数据 | 个股竞价分时数据 |
| — |
板块数据 | 获取概念板块列表 |
| ✅ 可调用 |
板块数据 | 获取行业板块列表 |
| ✅ 可调用 |
板块数据 | 订阅概念板块实时行情通道 |
| — |
板块数据 | 获取概念板块实时行情 |
| ✅ 可调用 |
板块数据 | 订阅行业板块实时行情通道 |
| — |
板块数据 | 获取行业板块实时行情 |
| ✅ 可调用 |
板块数据 | 概念板块日线 |
| ✅ 可调用 |
板块数据 | 概念板块周线 |
| — |
板块数据 | 概念板块月线 |
| — |
板块数据 | 行业板块日线 |
| ✅ 可调用 |
板块数据 | 行业板块周线 |
| — |
板块数据 | 行业板块月线 |
| — |
市场数据 | 获取融资融券余额 |
| — |
市场数据 | 上交所每日统计信息 |
| — |
市场数据 | 上交所每周统计信息 |
| — |
市场数据 | 上交所每月统计信息 |
| — |
市场数据 | 订阅指数实时行情通道 |
| — |
市场数据 | 获取指数实时行情 |
| ✅ 可调用 |
市场数据 | 涨跌停数量历史 |
| ✅ 可调用 |
市场数据 | 指数日线 |
| ✅ 可调用 |
市场数据 | 指数周线 |
| — |
市场数据 | 指数月线 |
| — |
市场数据 | 龙虎榜数据 |
| ✅ 可调用 |
市场数据 | 市场资金流历史 |
| ✅ 可调用 |
市场数据 | 全市场买卖对比 |
| ✅ 可调用 |
市场数据 | 上证买卖对比 |
| — |
市场数据 | 深证买卖对比 |
| — |
市场数据 | 创业板买卖对比 |
| — |
市场数据 | 科创板买卖对比 |
| — |
市场数据 | 北证买卖对比 |
| — |
市场数据 | 市场实时涨跌分布时序数据 |
| — |
市场数据 | 市场实时涨跌停数量 |
| — |
市场数据 | 市场实时涨停股列表 |
| — |
市场数据 | 市场全天实时成交额 |
| — |
财务数据 | 利润表 |
| — |
财务数据 | 现金流表 |
| — |
财务数据 | 财务主表 |
| — |
财务数据 | 资产负债表 |
| — |
财务数据 | 财务辅助表 |
| — |
财务数据 | 股东表 |
| — |
财务数据 | 业绩预告 |
| — |
财务数据 | 财务核心指标(数据源SI) |
| — |
财务数据 | 利润表(数据源SI) |
| — |
财务数据 | 资产负债表(数据源SI) |
| — |
财务数据 | 现金流表(数据源SI) |
| — |
财务数据 | 个股财务核心指标(数据源Ea) |
| — |
财务数据 | 个股资产负债表(数据源Ea) |
| — |
财务数据 | 个股利润表(数据源Ea) |
| — |
财务数据 | 个股现金流量表(数据源Ea) |
| — |
可转债 | 订阅可转债实时行情通道 |
| — |
可转债 | 获取可转债实时行情 |
| — |
可转债 | 获取可转债列表 |
| — |
Tools
本地 MCP Server(mcp/server.py)暴露 22 个请求/响应工具,与公开测试账号的 22 个开放接口一一对应。
Tool | Description |
| A股实时行情快照 / Realtime snapshot of ALL A-share stocks |
| 指数实时快照 / Realtime snapshot of market indices |
| 概念板块实时快照 / Realtime snapshot of concept sectors |
| 行业板块实时快照 / Realtime snapshot of industry sectors |
| 股票列表 / List of all A-share stocks |
| 概念板块列表 / List of concept sectors |
| 行业板块列表 / List of industry sectors |
| 单只股票实时行情 / Realtime quote for ONE stock (e.g. "600519") |
| 个股前复权日线 / Forward-adjusted daily K-line for one stock |
| 概念板块日线 / Concept sector daily K-line |
| 行业板块日线 / Industry sector daily K-line |
| 个股分钟历史 / Minute-level K-line (1/5/15/30/60) |
| 指数日线 / Index daily K-line |
| 核心资讯 / Core market news |
| 国内财经要闻 / Domestic financial news |
| 全球财经要闻 / Global financial news |
| 期权资讯 / Options-related news |
| 涨跌停统计 / Limit-up & limit-down statistics |
| 龙虎榜数据 / Dragon-Tiger list data |
| 市场资金流向 / Whole-market capital flow |
| 全市场多空对比 / Bull/bear comparison of the whole market |
| 个股DDX / DDX large-order tracking for one stock |
🤖 SKILL.md
仓库根目录 SKILL.md 供 Claude Code / OpenClaw 直接激活。
⚖️ 许可证
MIT(见 LICENSE)。客户端开源,调用后端需有效 phone/nid,按量计费。
📰 已收录渠道
Available Tools
22 toolschAllMarketBearCompareB
获取全市场多空对比。Get bull/bear (long/short) comparison of the whole market. No arguments.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It states there are no arguments and describes the scope, but omits whether this is a read-only snapshot, how fresh the data is, or any rate limits or side effects. For a market data retrieval tool, freshness and read-only nature are notable gaps.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short sentences, front-loaded with the core purpose and immediately clarifying the argument situation. The bilingual phrasing is compact and every part earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity (zero parameters) and the presence of an output schema, the description need not explain return values. It states the scope and that no arguments are required, which is sufficient for an agent to invoke it. The lack of any behavioral or usage context keeps it from a 5.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool takes zero parameters, and the schema is empty. The description confirms 'No arguments,' matching the schema. With no parameters to document, the baseline of 4 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource: get bull/bear (long/short) comparison for the whole market. It is more specific than the tool name alone and distinguishes itself from sibling data tools by focusing on market-wide sentiment comparison. However, it does not explicitly differentiate itself from related market tools like ChMarketCurReal or ChMarketFundFlow.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description says 'No arguments' but provides no guidance on when to use this tool versus the many sibling market data tools. There are no conditions, prerequisites, or alternatives mentioned, leaving the agent to infer usage entirely from the name.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ChConceptCurRealB
获取概念板块实时快照。Get realtime snapshot of concept sectors. No arguments.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It doesn't disclose whether this is read-only (inferable from 'get' but not stated), whether it requires auth, whether data is cached/delayed, or anything about freshness despite the 'realtime' claim.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Very short and front-loaded, with the purpose stated first. The trailing 'No arguments' is redundant given the empty parameter schema, a minor waste but nothing egregious.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so return values needn't be explained, and the tool's zero-parameter nature keeps complexity low. Still, for a 'realtime' data source, the absence of any note on scope, refresh behavior, or how it differs from the three parallel realtime siblings leaves an agent guessing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool takes zero parameters, so the baseline is 4. The description's 'No arguments' note is accurate but redundant with the empty schema, adding no real meaning.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource ('Get realtime snapshot of concept sectors'), which is unambiguous about what the tool returns. However, it makes no attempt to distinguish itself from siblings like ChStockCurReal, ChIndustryCurReal, and ChMarketCurReal, which follow the identical naming/description pattern with a different resource.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance on when to use this tool versus the many parallel realtime snapshot siblings. The only usage hint is 'No arguments,' which describes invocation mechanics rather than selection context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
chConceptDayHistoryC
获取概念板块日线历史。Get daily K-line history for a concept sector. Args: code (str): sector code like "300502".
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, so the description carries the full burden. It implies a read operation but says nothing about date-range limits, pagination, history depth, or permissions. An output schema exists, so return shape is covered, but behavioral constraints are not.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Very short and front-loaded, leading with the purpose before the argument list. The bilingual duplication adds length without new information, but it is not wasteful enough to hurt.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple single-parameter read tool with an output schema, the essentials are present, so an agent can call it. However, the odd code example and absent usage or behavioral context leave it only minimally complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0% and the single 'code' parameter has no schema description. The description partially compensates by labeling it 'str' and giving a sample value ('300502'), but that example is ambiguous since it resembles a stock code rather than a sector identifier.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource: 'Get daily K-line history for a concept sector.' The 'concept sector' qualifier distinguishes it from the parallel siblings chIndustryDayHistory, chStockFrontDayHistory and ChMarketDayHistory, though it never names those alternatives directly.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no when-to-use guidance, no condition selecting this over the concept-related siblings (ChConceptCurReal, chConceptList), and no prerequisites stated. An agent must infer usage purely from the tool name.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
chConceptListB
获取概念板块列表。Get list of concept sectors. No arguments.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the burden. 'No arguments' usefully signals a zero-input call, and the name/verb imply a read-only listing, but nothing states authentication needs, rate limits, or result size. With an output schema present, the return-format gap is partially mitigated.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Very short and front-loaded, with the purpose stated first and the no-argument note last. The bilingual restatement is mildly redundant but costs little.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a zero-parameter listing tool with a full output schema, the description covers what an agent needs to invoke it: what it returns (concept sectors) and that no inputs are required. Only the when-to-use context against siblings is missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool takes zero parameters, so per the calibration the baseline is 4. The description's 'No arguments' correctly confirms there is nothing to supply.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource ('Get list of concept sectors'), which is enough to separate it from sibling chIndustryList and the various *CurReal tools by resource. It is clear but does not explicitly name or contrast with the nearest sibling.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The only usage information is 'No arguments.' There is no indication of when to call this versus chConceptCurReal, chConceptDayHistory, or chIndustryList, nor any prerequisite or exclusion guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ChCoreNewsC
获取核心资讯。Get core market news. Args: date (str): YYYYMMDD like "20260818".
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral burden. It implies a read-only retrieval and specifies the date format, but says nothing about return contents, date-range validity, whether future dates are accepted, or rate limits. For a news-fetching tool with zero annotation coverage this is thin.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Very short and front-loaded, with the purpose stated before the argument spec. The bilingual duplication ('获取核心资讯' / 'Get core market news') is mildly redundant but not costly given the overall brevity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so return values need not be explained. For a one-parameter retrieval tool this is close to adequate, but the ambiguity of 'core news' against four sibling news tools, and the unclear semantics of the date (is it a retrieval day? a filter?) leave real gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must compensate, and it does: it names the date parameter, its type, the YYYYMMDD format, and gives a concrete example ('20260818'). That fully documents the single required parameter, exceeding the schema's bare 'string' declaration.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a clear verb+resource ('Get core market news'), so the agent knows it retrieves news. However, 'core' is undefined and nothing distinguishes it from siblings like ChDomesticNews, ChGlobalNews, or ChOptionNews, which likely retrieve overlapping content. An agent cannot confidently pick this over those alternatives.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance on when to use this tool versus the many other news tools in the sibling list. The only operational hint is the date format, which is a parameter detail rather than usage context. The agent must infer the selection criteria entirely.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
chDdxStockDataC
获取个股DDX数据。Get DDX (large order tracking) data for one stock. Args: code (str): ticker like "600519".
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. 'Get' implies a read-only operation, but the description does not state authentication needs, rate limits, data freshness, or any behavior beyond the basic retrieval action.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is compact and front-loads the purpose. The bilingual Chinese/English wording repeats the same information, but the overall size is appropriate for a simple one-parameter retrieval tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so the description need not explain return values. For a one-parameter tool with no annotations, however, the description remains thin on usage context and behavioral expectations, leaving some gaps for an agent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0% for the single required parameter, so the description must compensate. It provides a useful ticker example ('600519'), but it does not explain exchange prefixes, market suffixes, or other valid identifier formats.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource: get DDX (large order tracking) data for one stock. It clarifies the DDX acronym and the single-stock scope, but it does not distinguish this tool from sibling real-time or historical stock-data tools such as ChOneStockReal or chStockFrontDayHistory.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is given on when to use this tool versus alternatives. The description implies it is for a single stock's DDX data, but there are no exclusions, prerequisites, or sibling comparisons.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ChDomesticNewsB
获取国内财经要闻。Get domestic (China) financial news. Args: date (str): YYYYMMDD.
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden, yet it discloses nothing about behavior: no auth requirements, no rate limits, no coverage window, and no indication of what the returned news contains.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Very short and front-loaded: purpose first, then the argument. The bilingual duplication is slightly redundant but standard for a Chinese-market tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so return values need not be described, and the single parameter is documented. However, with no annotations and a crowded news-tool family, the absence of usage routing leaves a real gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0% and the schema gives no format hint, so the description's 'date (str): YYYYMMDD' is the sole source of format semantics for the one parameter. That is genuine added value over the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a clear verb+resource: fetch domestic (China) financial news. The parenthetical 'domestic (China)' helpfully scopes it away from the global sibling ChGlobalNews, though it never names any sibling explicitly.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus the many sibling news tools (ChGlobalNews, ChCoreNews, ChOptionNews). The only usage hint is the required date argument.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ChGlobalNewsB
获取全球财经要闻。Get global financial news. Args: date (str): YYYYMMDD.
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden, and it discloses essentially nothing beyond the surface purpose. It does not say whether this is a read-only fetch, how results are scoped or ordered, whether the date must be today/past, or any rate/availability limits.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single terse line and front-loads the purpose before the argument note. The Chinese/English restatement is slightly redundant but adds negligible length.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so return values need not be explained, and the single required parameter's format is covered. However, for a news-retrieval tool with many sibling news variants and zero annotations, the description is thin — no scope, ordering, or differentiation guidance for correct selection.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0% — the `date` property has no description in the schema — but the description compensates by giving the exact format 'YYYYMMDD'. That is the key semantic detail an agent needs and it is not available from structured data.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a clear verb+resource: retrieve global financial news ('获取全球财经要闻 / Get global financial news'). The word 'global' implicitly distinguishes it from sibling news tools like ChDomesticNews and ChCoreNews, but no explicit sibling differentiation is offered.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance on when to choose this tool over ChDomesticNews, ChCoreNews, or ChOptionNews, and no mention of prerequisites or date constraints. Only the argument format is given, which is parameter documentation rather than usage guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ChIndustryCurRealB
获取行业板块实时快照。Get realtime snapshot of industry sectors. No arguments.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the burden. 'Realtime snapshot' does convey that this is a non-persistent read returning current state, which is genuine behavioral context, but it omits freshness/latency expectations, rate limits, and any auth or entitlement requirements.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two clipped clauses, front-loaded with the resource and scope. The bilingual duplication is somewhat redundant but standard for this tool family and costs little.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so return values need no explanation, and there are no parameters to document. The description is adequately complete for a no-arg snapshot endpoint, with only usage routing left unstated.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Zero parameters, so the baseline is 4. 'No arguments' confirms the empty schema and removes any doubt about supplying inputs.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description gives a specific verb+resource in two languages: '获取行业板块实时快照 / Get realtime snapshot of industry sectors.' An agent can identify this as the industry-sector counterpart to ChMarketCurReal/ChConceptCurReal/ChStockCurReal, though it never names those siblings explicitly.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No when-to-use, when-not-to-use, or alternative routing is offered. The agent must infer from the name alone that this is the industry-scope variant of the realtime family.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
chIndustryDayHistoryB
获取行业板块日线历史。Get daily K-line history for an industry sector. Args: code (str): sector code like "300502".
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full disclosure burden. It implies a read-only historical fetch but says nothing about data range, granularity beyond 'daily', pagination, or availability, leaving notable behavioral gaps.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Front-loaded with the core purpose, followed by a compact args note. The bilingual duplication is mildly redundant but the whole thing is short and wastes little space.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so return values needn't be explained, and this is a simple one-parameter read tool. However, with no annotations and no sibling differentiation, an agent lacks enough context to confidently pick this tool over the adjacent history tools.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0%, so the description must compensate, and it does name the single required parameter 'code' with a concrete example value ('300502'). It still doesn't clarify format constraints or whether the code must exist, but the example adds real value over the bare schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description gives a specific verb (get) and resource (daily K-line history), and the 'industry sector' scope distinguishes it from concept/stock/market siblings. It does not explicitly name those siblings, so an agent must infer the boundary from the scope noun alone.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance on when to use this versus the many sibling history tools (chConceptDayHistory, chStockFrontDayHistory, ChMarketDayHistory) or any preconditions. Usage must be inferred entirely from the sector-scope phrasing.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
chIndustryListB
获取行业板块列表。Get list of industry sectors. No arguments.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden, yet it discloses nothing behavioral beyond 'No arguments' — no indication of data source/provider, read-only nature, pagination, or result cardinality. For a zero-arg list tool with an output schema this is a modest but real gap.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three short, front-loaded fragments with no filler. The bilingual restatement is slightly redundant but serves a purpose for mixed-language agents, and 'No arguments' resolves the calling contract immediately.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so return fields need not be explained, and with no parameters there are no inputs to document. The definition is complete for calling the tool, though it omits any routing guidance relative to its many siblings.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool takes zero parameters, which is the baseline-4 case, and the description confirms this with an explicit 'No arguments' statement. There is no parameter ambiguity to resolve.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific verb and resource ('Get list of industry sectors'), clearly distinguishing it from sibling list tools like chStockList and chConceptList. It stops short of explicitly contrasting itself with the real-time sibling chIndustryCurReal, so it is clear but not fully differentiated.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
'No arguments' is the only usage note; there is no statement of when to use this instead of chIndustryCurReal, chIndustryDayHistory, or the other list tools. The intended usage is only inferable from the name.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ChLhbDataC
获取龙虎榜数据。Get Dragon-Tiger list (top traded stocks) data. Args: date (str): YYYYMMDD.
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It confirms the tool returns data but discloses nothing about permissions, rate limits, return shape, or whether the date is a single trading day—behaviors an agent would need for a market-data tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Very short and front-loaded, with the domain term stated first. The bilingual repetition is somewhat redundant but justified for a Chinese-market tool, and no sentence is wasted.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so return values need not be described. For a single-parameter read tool the description is minimally adequate, but it leaves the usage context and behavioral profile largely unaddressed.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, but the description partially compensates by specifying the date format as YYYYMMDD. However, it adds no semantics about what the date selects (single day vs range) or any constraints, so coverage remains incomplete.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource—fetching 龙虎榜 (Dragon-Tiger list) top-traded stock data—using a well-defined domain term. It is clearer than a vague 'get data' tool, but it does not explicitly distinguish itself from related siblings like ChLimitUpDown or ChDdxStockData.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no when-to-use guidance, no prerequisites, and no mention of alternative tools. The only context is the argument format, which tells the agent nothing about when this tool is the right choice over its many siblings.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ChLimitUpDownB
获取今日涨跌停统计。Get today's limit-up/limit-down statistics. No arguments.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral burden and does little: it does not state whether the figures are real-time or end-of-day, whether the result is cached, or whether any auth is needed. It only confirms a zero-argument invocation shape, which is already evident from the schema.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Very short and front-loaded, with the purpose stated immediately. The Chinese and English sentences duplicate identical content, a minor redundancy, but nothing is bloated or buried.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool is simple (zero params) and an output schema exists, so return values need not be explained. Still, the description omits meaningful context such as data freshness or market scope (A-shares, which exchange), which matters for a statistics tool among many similar siblings.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool takes zero parameters, so the baseline is 4. The explicit 'No arguments' clause correctly reinforces the empty schema, leaving nothing an agent could misconfigure.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb+resource: retrieve today's limit-up/limit-down statistics, which is a concrete market-data artifact an agent can identify. However, it offers no differentiation from the many sibling market snapshot tools such as ChMarketCurReal or ChChStockCurReal, so the agent must infer the niche from the name alone.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description contains no when-to-use or when-not-to-use guidance and names no alternatives, despite ~20 sibling market-data tools. 'No arguments' is a calling detail, not usage context, so the agent is left to guess when this statistic is preferable to a general market snapshot.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ChMarketCurRealA
获取A股指数实时快照。Get realtime snapshot of A-share market indices (SH/SZ/BJ). No arguments.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the behavioral burden. 'Realtime snapshot' implies a non-destructive read, which is useful, but nothing is said about permissions, rate limits, latency, or data freshness beyond the word 'realtime'.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Very short and front-loaded, with the scope and the no-arg nature immediately visible. The bilingual duplication of the same sentence is mild redundancy that slightly costs efficiency.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With zero parameters and an output schema present, the description need not explain return values, and it correctly flags the no-argument calling convention. A brief note on what distinguishes the returned index snapshot from sibling market endpoints would make it fully complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool takes zero parameters, so the schema baseline of 4 applies. 'No arguments' is consistent with the empty properties object and adds a small confirmation rather than new meaning.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb+resource ('realtime snapshot of A-share market indices') and scopes it with exchanges SH/SZ/BJ, which implicitly separates it from siblings like ChStockCurReal, ChConceptCurReal, and ChIndustryCurReal. It never names those alternatives, so full sibling differentiation is not explicit.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
'No arguments' tells the agent how to call it, and 'market indices' implies the use case, but there is no explicit statement of when to pick this over the stock-, concept-, or industry-level snapshot siblings. Usage is inferable rather than stated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ChMarketDayHistoryC
获取指数日线历史。Get daily K-line history for an index. Args: code (str): index code like "000001" (上证指数).
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It does not disclose the history window, default lookback, granularity constraints, or whether the index must be a trading day, and there is no note on auth or limits. A read operation is implied by 'get', but nothing beyond that.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short sentences plus an inline arg note, front-loaded with the Chinese and English statements of purpose. The bilingual duplication is redundant but useful for multilingual agents, so it is not wasteful.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so return values need not be described. For a one-parameter read tool this is close to adequate, but a history tool should say what time span or default period it returns, which is missing here.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The single 'code' parameter has 0% schema description coverage, so the description's example ('000001' for 上证指数) is the only guidance on format and is genuinely useful. However, it omits constraints such as accepted prefixes or whether only index codes (not stock codes) are valid, so it only partially compensates.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource ('Get daily K-line history for an index'), so an agent can distinguish it from the stock/concept/industry history siblings by the word 'index'. It does not explicitly name those alternatives, but the scope is clear.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no when-to-use, when-not-to-use, or alternative-routing guidance. The agent must infer from the word 'index' that this is not the tool for individual stocks (ChStockCurReal, chStockFrontDayHistory) or concepts/industries. That inference is not stated.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ChMarketFundFlowA
获取市场资金流向。Get whole-market capital flow. No arguments.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the behavioral burden. The verb 'Get' implies a read-only retrieval operation, and 'No arguments' confirms a parameterless call, but there is no mention of authentication, rate limits, data freshness, or other operational traits.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely short and front-loaded: it states the resource first and the no-argument fact second. The bilingual repetition is compact and there is no filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a zero-parameter market-data tool with an output schema, the description is nearly complete: it identifies the data returned and confirms no inputs. It lacks usage context and operational details, but the output schema removes the need to explain return values.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
There are zero parameters, and the schema description coverage is already complete. The description's 'No arguments' merely confirms what the schema shows, so the baseline score of 4 for a zero-parameter tool is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description gives a specific verb (获取/Get) and resource (whole-market capital flow), and the word 'whole-market' distinguishes it from sibling tools such as ChStockCurReal, ChConceptCurReal, and ChIndustryCurReal. An agent can identify the tool's general function without opening the schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description says only 'No arguments,' which is invocation information rather than usage guidance. It does not state when to use this tool instead of related market-data siblings or what conditions make it appropriate.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ChOneStockRealB
获取单只股票实时行情。Get realtime quote for ONE stock. Args: code (str): 6-digit ticker, e.g. "600519" (贵州茅台 / Kweichow Moutai).
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are supplied, so the description carries the full burden of behavioral disclosure, yet it says nothing about permissions, rate limits, data freshness/delay, or whether a missing ticker errors or returns empty. For a simple read-only quote fetch the risk is low, but the gap is real.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short bilingual sentences with the identifier and the argument spec front-loaded; essentially no waste. The duplicated Chinese/English phrasing is slightly redundant but useful for matching either language.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so return values need not be explained, and the one parameter is fully described. The only shortfall is the absence of any scope or sibling-routing note for a very crowded tool family.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0% — the property is documented only as 'Code' — but the description compensates well by specifying the format (6-digit ticker) and giving a concrete example ('600519', Kweichow Moutai). The single parameter is fully usable without opening the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb+resource: fetch a realtime quote for a single stock, emphasized by 'ONE'. It does not, however, differentiate itself from the close sibling ChStockCurReal, so an agent cannot tell the two apart from the description alone.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no when-to-use guidance, no mention of alternatives (ChStockCurReal, ChMarketCurReal), and no statement of scope such as which exchanges or markets are covered. Usage must be inferred entirely from the name.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ChOptionNewsC
获取期权资讯。Get options-related news. Args: date (str): YYYYMMDD.
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden, and it discloses essentially nothing: no statement of read-only behavior, no data source, no coverage window, no rate limits, no note on what a given date returns (e.g., non-trading days). Only the minimal implication of a data retrieval call is conveyed.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Very short and front-loaded: purpose first, then the argument format. The bilingual duplication is mildly redundant but costs little, and nothing else is wasted.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a one-parameter news fetch with an output schema present, the definition is minimally viable: return values need not be explained, but key context such as coverage window and how the date is interpreted is missing. An agent can call it, but with some uncertainty about semantics.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0% and the single parameter has no description, but the description compensates by specifying the intended format 'YYYYMMDD'. It adds nothing about timezone, trading-day behavior, or whether the date is required, so this is adequate rather than rich.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource ('Get options-related news'), so an agent can tell it fetches news scoped to options. It does not explicitly distinguish itself from the news siblings (ChCoreNews, ChDomesticNews, ChGlobalNews), so sibling differentiation is only implied by the 'options' qualifier.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no when-to-use guidance, no prerequisite context, and no mention of alternatives among the many news-listing siblings. The agent is left to infer that this is the options-specific news endpoint from the name alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ChStockCurRealB
获取A股实时行情快照。Get realtime snapshot of ALL A-share stocks. No arguments.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It does disclose the two most relevant behavioral facts for this tool: the scope is ALL A-share stocks (implying a large payload) and it takes no arguments. It says nothing about update frequency beyond 'realtime', rate limits, or whether the snapshot is a single point in time, which is a real gap for a live-quote feed.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short sentences, front-loaded, with the scope stated immediately. The bilingual restatement is redundant, but the whole definition is only a dozen words and nothing is buried.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema present, return-value documentation is not needed, and a zero-parameter read tool has a shallow contract. What remains missing is freshness/update-cadence context and routing guidance against the many sibling realtime tools.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool takes zero parameters, so the baseline is 4. The description's 'No arguments' correctly reinforces the empty schema and prevents the agent from hunting for ticker or date inputs.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource: fetch a realtime snapshot of ALL A-share stocks. The word 'ALL' plus the zero-parameter shape distinguishes it from ChOneStockReal and the market/concept/industry variants, although no sibling is named explicitly.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description offers no when-to-use guidance. It never contrasts itself with ChOneStockReal (single-stock realtime) or ChStockFrontDayHistory (historical), so the agent must infer selection from the name and the 'ALL' scope alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
chStockFrontDayHistoryC
获取个股前复权日线历史。Get forward-adjusted daily K-line history for one stock. Args: code (str): ticker like "600519".
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It states the output is forward-adjusted daily K-line data, but gives no information on how much history is returned, the time range, permissions, or rate limits. For a data-fetch tool with zero annotation coverage this is a notable gap.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two short, front-loaded sentences with no wasted words. Purpose comes first, followed by the argument hint. Efficient, though the bilingual duplication and the inline 'Args:' fragment make it slightly less clean than optimal.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema present, return-value structure needn't be explained, and a single required parameter is well covered by the example. However, key context for a history tool, such as the span of data or lookback behavior, is absent, leaving the agent partially informed. Adequate but with clear gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must compensate for the single undocumented parameter. It does add useful meaning by naming the parameter ('code') and giving a concrete ticker example ('600519'), clarifying format expectations beyond the schema's bare string type.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource: 'Get forward-adjusted daily K-line history for one stock.' This lets an agent distinguish it from market-wide history tools, though it does not explicitly name a sibling such as chStockMinuteHistory to contrast the granularity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no explicit when-to-use or when-not-to-use guidance. The only implied signal is 'for one stock,' which hints at single-ticker scope, but nothing tells the agent to prefer chStockMinuteHistory for intraday data or the market-level tools for aggregate history.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
chStockListA
获取A股股票列表。Get the list of all A-share stocks (code/name). No arguments.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the burden, but the operation is a simple read-only enumeration and 'get the list' conveys that adequately. It does not mention whether the list is cached/static, how large it is, or any permission requirements, which would be useful for a full-universe call.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short bilingual sentences, front-loaded with the resource and immediately followed by the return fields and the no-argument fact. No padding whatsoever.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema present, the return shape need not be explained, and a parameterless list tool is intrinsically simple. The description covers purpose and return fields; only the usage context relative to sibling list tools is thin.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
There are zero parameters, so there is nothing for the description to disambiguate; the baseline for a parameterless tool is 4. Stating 'No arguments' reinforces this and matches the empty schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource ('Get the list of all A-share stocks') and even names the returned fields (code/name), which separates it from sibling list tools like chConceptList and chIndustryList by domain. It stops short of explicitly naming those siblings as alternatives, so it is clear but not fully differentiated.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The only guidance is 'No arguments,' which is a schema fact, not usage guidance. It never says when to reach for this tool versus chConceptList, chIndustryList, or the real-time quote tools, leaving the agent to infer that this is the static base universe list.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
chStockMinuteHistoryB
获取个股分钟历史。Get minute-level K-line history for one stock. Args: code (str): ticker like "600519"; minute (int): 1/5/15/30/60; date (str): YYYYMMDD like "20260818".
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes | ||
| date | Yes | ||
| minute | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full behavioral burden, yet it only implies a read operation via 'Get'. It says nothing about authentication, rate limits, data window limits, or how much history is returned for a given date.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Very compact and front-loaded: purpose first, then a terse Args block. Every token earns its place, though the duplicated Chinese/English purpose line adds minor redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so return values need not be explained, and all parameters are documented. However, for a history-fetching tool with no annotations, the absence of any usage context or behavioral constraints leaves a real gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must compensate, and it does: it documents the ticker format ('600519'), the allowed minute intervals (1/5/15/30/60), and the date format ('YYYYMMDD'). That covers all three required parameters with concrete syntax.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource ('Get minute-level K-line history for one stock'), clearly distinguishing it from the day-level siblings like chStockFrontDayHistory. It does not name any sibling explicitly, but the resource granularity ('minute') is unambiguous.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance on when to use this tool versus alternatives (e.g. chStockFrontDayHistory for daily, ChStockCurReal for realtime), nor any prerequisites or stated exclusions. The agent must infer usage purely from the resource name.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
22 tool updates
v1.5.5- First observed
chAllMarketBearCompare - First observed
ChConceptCurReal - First observed
chConceptDayHistory - First observed
chConceptList - First observed
ChCoreNews - First observed
chDdxStockData - First observed
ChDomesticNews - First observed
ChGlobalNews - First observed
ChIndustryCurReal - First observed
chIndustryDayHistory - First observed
chIndustryList - First observed
ChLhbData - First observed
ChLimitUpDown - First observed
ChMarketCurReal - First observed
ChMarketDayHistory - First observed
ChMarketFundFlow - First observed
ChOneStockReal - First observed
ChOptionNews - First observed
ChStockCurReal - First observed
chStockFrontDayHistory - First observed
chStockList - First observed
chStockMinuteHistory
TDQS
Scored across 22 tools
Tools are largely distinct by resource and action (realtime snapshot vs list vs history vs analytics). Only the news tools (core/domestic/global) have slight overlap in semantics, but descriptions help differentiate.
Names follow a predictable prefix + resource + data type pattern in CamelCase without underscores. Minor deviation: prefix capitalization alternates between 'Ch' and 'ch' inconsistently.
22 tools cover many domains but sits in the borderline-heavy range (16-25). Each tool earns its place, yet the surface could be more compact by merging similar news or snapshot endpoints.
Covers realtime, history, lists, news, and key market analytics (limit-up/down, dragon-tiger, fund flow, bull/bear, DDX). Minor gaps: no stock profile/fundamental data, no index list, and news lacks keyword search.
Maintenance
Related MCP Connectors
China A-share market data over MCP: 22 tools for quotes, K-line, financials, money flow, top-trader boards, sectors, macro, convertible bonds and factor screening. Five tools need no API key, so you can connect and try it immediately.
China A-share market data for research, backtesting and AI agents via MCP.
MCP server giving AI agents one-connection access to China A-share market intelligence: financials,
Read-only China A-share data for AI agents: market, limit-up, capital flow and disclosures.
Related MCP Servers
- AlicenseBqualityDmaintenanceProfessional financial data MCP server integrating Tushare API, providing real-time financial data and technical indicators analysis for stocks, indices, funds, bonds, and cryptocurrencies across multiple markets (A-share, US, HK, crypto).1879 npmMIT
- AlicenseAqualityCmaintenanceProvides real-time stock market data and analysis from Chinese markets through 34 MCP tools, including K-line charts, technical indicators, fundamental analysis, financial metrics, and market insights without requiring authentication or API tokens.3454MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that wraps SFC financial data API into 32 tools for comprehensive A-share market data, including real-time quotes, rankings, limit-up statistics, news, themes, financials, charts, research reports, and watchlists.-
- AlicenseNot gradedqualityFmaintenanceProduction-grade MCP server for Chinese A-share market data, offering 30 tools including real-time quotes, K-lines, fund flows, and financial reports, with stdio and HTTP transport support.7MIT