D-Asce/pandastocksdk

> **A 股数据 API + AI 选股 · 开源客户端**
>
> 基于 **NATS** 的 A 股实时数据通道 —— 行情、Level2、DDX 大单、资金流、选股信号**主动推给你**，不是让你轮询 REST。
⚡ 30 秒上手
**免注册**：内置公共测试账号，装完直接跑，无需申请。
🤖 MCP 接入（Claude / Cursor / OpenClaw）
升级：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 主题通过请求方式获取实时快照，无需订阅：
🎁 公共测试账号
> 开放一个**公共测试账号**，无需申请即可直接试玩：
| 字段 | 值 |
|---|---|
| phone | pandastock |
| nid | pandastock |
> 公共账号**按来源 IP 限频、限接口、含全局日上限**，仅供评估试玩。
> 正式 / 高频 / 全量接口，请申请**专属 phone/nid**：加微信 onestock188 或 pandastock888
- 初始化示例：PandaStock(phone="pandastock", nid="pandastock")（与专属账号同一套服务端鉴权，仅配额不同）
🔑 测试账号可调用的 22 个接口（服务端共 176 个，完整清单 + 返回字段见 INTERFACES.md）
接口按成本/价值分档，客户端不含限制逻辑，鉴权/配额/频率/分级全部在服务端（NATS 网关）执行。
**18 个请求/响应接口：**
| 主题 | 方法 | 说明 |
|---|---|---|
| chStockList | get_ch_stock() | 股票列表 |
| chConceptList | get_ch_concept() | 概念板块列表 |
| chIndustryList | get_ch_industry() | 行业板块列表 |
| ChStockCurReal | get_ch_stock_real() | A股实时快照 |
| ChMarketCurReal | get_ch_market_real() | 指数实时快照 |
| ChConceptCurReal | get_ch_concept_real() | 概念板块实时快照 |
| ChIndustryCurReal | get_ch_industry_real() | 行业板块实时快照 |
| ChOneStockReal | get_ch_one_stock_real(code) | 单只股票实时 |
| chStockFrontDayHistory | get_ch_stock_front_day_history(code) | 个股前复权日线 |
| chConceptDayHistory | get_ch_concept_day_history(code) | 概念日线 |
| chIndustryDayHistory | get_ch_industry_day_history(code) | 行业日线 |
| chStockMinuteHistory | get_ch_stock_minute_history(code, minute, date) | 分钟历史 |
| ChMarketDayHistory | get_ch_market_day_history(code) | 指数日线 |
| ChCoreNews | get_core_new(date) | 核心资讯 |
| ChDomesticNews | get_domestic_financial_news(date) | 国内要闻 |
| ChGlobalNews | get_global_financial_news(date) | 全球要闻 |
| ChOptionNews | get_options_news(date) | 期权资讯 |
| ChLimitUpDown | get_ch_limit_up_down() | 涨跌停统计 |
| ChLhbData | get_lhb_data(date) | 龙虎榜 |
| ChMarketFundFlow | get_ch_market_fund_flow() | 市场资金流 |
| chAllMarketBearCompare | get_ch_all_market_bear_compare() | 全市场多空对比 |
| chDdxStockData | get_ch_stock_ddx_data(code) | 个股 DDX |
> 服务端共 **176 个接口**，完整清单（含「是否可测试」+ **每个接口返回的字段明细**）见 INTERFACES.md（「接口返回字段详情」一节）。上表 22 个为已对公开 key 开放的请求接口。
全部 176 个接口一览（测试账号可调用标记）
> 完整返回字段见 INTERFACES.md 的「接口返回字段详情」。标 ✅ 可调用 的即上方 22 个公开测试账号可调用接口；其余需专属 key 后使用。
| 分类 | 接口名称 | 方法(function) | 测试账号 |
|---|---|---|---|
| Levle2和大单 | 订阅Level2实时数据通道 | subscribe_ch_l2_data_real | — |
| Levle2和大单 | 获取Level2实时数据 | get_ch_l2_data_cur_real | — |
| Levle2和大单 | 订阅大单数据(DDE)通道 | subscribe_ch_ddx_data_real | — |
| Levle2和大单 | 获取大单数据(DDE) | get_ch_ddx_data_cur_real | — |
| Levle2和大单 | 获取个股历史大单历史数据 | get_ch_stock_ddx_history | — |
| Levle2和大单 | 个股千档数据 | get_ch_stock_thousand_level_order | — |
| Levle2和大单 | 个股实时资金流数据 | get_ch_stock_l2_fund_flow_sa | — |
| Levle2和大单 | 获取个股最新逐笔成交 | get_ch_stock_l2_laster_transactions_sa | — |
| Levle2和大单 | 获取个股全部逐笔成交数据 | get_ch_stock_l2_all_transactions_sa | — |
| Levle2和大单 | 市场实时资金流数据 | get_ch_all_market_l2_fund_flow | — |
| Levle2和大单 | 上证指数实时资金流数据 | get_ch_sh_market_l2_fund_flow | — |
| Levle2和大单 | 深圳市场实时资金流数据 | get_ch_sz_market_l2_fund_flow | — |
| Levle2和大单 | 创业板实时资金流数据 | get_ch_cyb_market_l2_fund_flow | — |
| Levle2和大单 | 科创板实时资金流数据 | get_ch_kcb_market_l2_fund_flow | — |
| Levle2和大单 | 个股实时大单成交明细 | get_ch_stock_big_order | — |
| Levle2和大单 | 订阅Level2单只股成交明细 | subscribe_ch_l2_transaction_single | — |
| Levle2和大单 | 订阅Level2多只股成交明细 | subscribe_ch_l2_transaction_batch | — |
| Levle2和大单 | 订阅Level2所有股成交明细 | subscribe_ch_l2_transaction_all | — |
| Levle2和大单 | 个股l2分价成交明细 | get_ch_stock_price_summarize | — |
| Levle2和大单 | 订阅l2单只股十档行情通道 | subscribe_ch_l2_deep_single | — |
| Levle2和大单 | 订阅l2多只股十档行情通道 | subscribe_ch_l2_depth_batch | — |
| Levle2和大单 | 订阅l2所有股票十档行情通道 | subscribe_ch_l2_depth_all | — |