shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 数据与分析需要 API Key

股票RPS数据分析

九宽量化股票 API 数据分析：涨跌停、板块、选股、财务、多空雷达、RPS 等 50+ REST（/api/v1/），输出客观数据解读与结构化报告，附风险提示与免责声明，不提供投资建议。需在 {baseDir}/config.json 配置 api_key（九宽后台联系获取），对接 [https://9quant.online]。

person作者: user_577f8e79hubcommunity
download下载资源包

Stock API Analyzer — 使用文档

面向 OpenClaw / iFlow 的九宽量化股票 API 分析 Skill。通过自然语言查询、解读 56 个 REST 接口（路径前缀 /api/v1/），输出客观数据解读与结构化报告，不提供投资建议。

文档分工：SKILL.md 供 Agent 加载（工作流、输出规则、报告模板）；本文件供人工查阅（安装、配置、FAQ、完整接口列表）。

核心特性

  • 自然语言意图识别：支持「昨日」「去年三季报」「RPS 分段」「多空雷达」等中文话术
  • API 智能查询：对照 api_knowledge.json 选择单接口或多接口组合
  • 参数辅助配置：日期区间 startDate / endDate；单日 date；股票名先 stock_search 再查详情
  • 时间语义解析：昨日/今天、季报披露季、净利润断层公告密集期等
  • 数据专业解读：涨跌停情绪、板块结构、财务信号等客观归纳
  • 组合分析：市场环境、板块、个股、业绩等多 API 联合分析
  • 合规输出：报告须含风险提示与免责声明，禁止买卖/仓位建议

目录结构

stock-api-analyzer/
├── SKILL.md                    # Agent 技能指令（OpenClaw / iFlow）
├── README.md                   # 本文件（人工使用文档）
├── config.json                 # API 地址与密钥
├── api_knowledge.json          # 56 个接口知识库
├── prompts/
│   └── system_prompt.md        # 意图映射、参数解析、输出规范
├── examples/
│   ├── scenario_1_limit_stocks.md
│   ├── scenario_2_sector_analysis.md
│   └── scenario_3_market_environment.md
└── stock_api_analyzer.py       # 核心实现（可选脚本调用）

安装

OpenClaw

  1. 将 stock-api-analyzer 目录复制到 OpenClaw skills 目录：
cp -r stock-api-analyzer ~/.openclaw/skills/

Windows：%USERPROFILE%\.openclaw\skills\stock-api-analyzer\

  1. 编辑 config.json，填入 api_key（api_base_url 为 https://9quant.online，勿写 /api/v1）
  2. 在 OpenClaw 中注册并启用 skill，重启或重载 skills

iFlow

将本目录置于项目 .iflow/skills/stock-api-analyzer/，iFlow 会自动扫描并加载。配置 config.json 后重启或重载服务即可。

更新 skill 时先备份 config.json，覆盖程序文件后恢复 api_key。

配置

编辑 skill 目录下的 config.json：

{
  "api_base_url": "https://9quant.online",
  "api_key": "your_api_key_here",
  "api_timeout": 30,
  "enable_caching": true,
  "cache_ttl": 300,
  "max_retries": 3,
  "retry_delay": 1,
  "headers": {
    "Content-Type": "application/json"
  }
}

配置说明

| 配置项 | 说明 | |--------|------| | api_base_url | 站点根地址（不含 /api/v1） | | api_key | API 密钥，写入请求头 X-API-Key；403 时联系九宽后台获取，勿伪造数据 | | api_timeout | 请求超时（秒） | | enable_caching / cache_ttl | 响应缓存，减轻频率限制 | | max_retries / retry_delay | 失败重试 | | headers | 自定义请求头 |

URL 拼接：最终请求地址 = api_base_url + api_knowledge.json 中的 endpoint（endpoint 已含 /api/v1/...）。

获取 API Key

通过九宽 后台/客服 联系，申请或获取 API Key，写入 config.json 的 api_key 字段。多数行情与统计类接口需 VIP 权限。

使用方法

在 OpenClaw / iFlow 对话中直接使用中文自然语言提问，Skill 会自动匹配接口、配置参数并生成数据分析报告。

查询话术与接口映射

| 用户意图 | 示例话术 | 接口键 | |----------|----------|--------| | 涨跌停 | 「查询昨天的涨停股票」 | limit（type=U） | | 昨日涨停今日表现 | 「昨日涨停今日表现」 | limit_yesterday_today | | RPS / 选股 | 「昨日 RPS 突破选股」 | rps_tp | | 陶博士选股 | 「陶博士口袋支点选股」 | tdx_stock_list | | 净利润断层 | 「去年三季报净利润断层股票」 | profit_gap | | 全市场筛股 | 「RPS 红色且市值大于 100 亿」 | all_stocks | | 板块 | 「分析人工智能板块」「今日板块涨幅排名」 | ths_mainstream / live_ths_index_top_sectors | | 板块选股 | 「同花顺转强板块内 RPS 大于 5 的股票」「通达信主流板块选股」 | ths_turn_block_list / ths_main_block_list / tdx_turn_block_list / tdx_main_block_list | | 市场环境 | 「分析当前市场环境」「最近一周多空雷达」 | market_golden_score + daily + limit 等 / dashboard_indicator | | 个股 | 「平安银行最近 30 天日线统计」 | stock_search → stock_daily_detail | | 财务 | 「查询去年三季报数据」「业绩预告预增」 | q_show / q_forecast | | 实时 | 「今日市场数据」「今日板块排行」 | live_daily / live_ths_index_top_sectors | | ETF 份额 | 「昨日ETF份额变化」「沪深ETF净申赎排行」 | etf_share_size / etf_share_size_history | | 指数 | 「查询同花顺指数数据」「大盘指数走势」 | ths_index / big_index_data |

更多意图映射见 prompts/system_prompt.md；场景示例见 examples/。

使用建议

  • 查询尽量具体，如「查询昨天涨停股票」优于单独说「涨停」
  • 涉及个股名称时可直接使用中文名，Skill 会先 stock_search 再查详情
  • 「昨日」按上一交易日解析；季报、断层等支持「去年三季报」等语义
  • 鉴权失败（403）时检查 api_key 与 VIP 权限；勿在对话中泄露密钥
  • 需要可访问 https://9quant.online 的网络环境

输出说明

每次查询返回结构化数据分析报告，包含：

  • 数据来源：调用的 API、参数、数据时间范围
  • 数据分析：指标摘要、核心字段、数据信号（客观归纳，非操作建议）
  • 数据要点与异常：关键发现、字段缺口或极值
  • 风险提示与免责声明

完整报告模板见 SKILL.md 与 prompts/system_prompt.md。

API 接口列表

知识库（api_knowledge.json）共 56 个接口，按类别摘要如下。完整字段、参数与 endpoint 以 api_knowledge.json 为准。

1. 基础数据（1）

  • stock_search：股票搜索

2. 市场数据（12）

  • limit、limit_yesterday_today、daily、market_golden_score
  • pro_quant_indicator、dashboard_indicator、daily_statistics_pro
  • ths_mainstream、big_index、big_index_data
  • live_daily（盘中实时）

3. 板块 / 指数（16）

  • 同花顺：ths_index、ths_index_detail、ths_index_members、ths_strong_turning、ths_add_del、live_ths_index、live_ths_index_top_sectors
  • 申万：sw_index、sw_index_detail、sw_index_members
  • 通达信：tdx_index、tdx_index_detail、tdx_index_members、tdx_mainstream、tdx_strong_turning、tdx_add_del

4. 股票数据（2）

  • all_stocks：全市场股票列表
  • stock_daily_detail：个股日线统计

5. 选股策略（8）

  • tdx_stock_list、rps_tp、profit_gap、n_days_high
  • 板块选股：ths_turn_block_list、ths_main_block_list、tdx_turn_block_list、tdx_main_block_list（板块内个股 RPS/成交额/市值筛选；通达信两个需 VIP）

6. 财务数据（8）

  • q_show、q_forecast、finance_* 系列（三大报表、财务指标、量化指标等）

7. 龙虎榜 / 资金（3）

  • longhu、longhu_detail、holder_trade

8. ETF / 其它（6）

  • etf_statistics、etf_daily_history
  • etf_share_size、etf_share_size_history：ETF 份额规模变化与历史（资金净申赎方向观察）
  • trade_date（交易日历）
  • 板块统计：block_daily_statistics、block_live_statistics、block_week_turn 等

错误处理

| 情况 | 处理方式 | |------|----------| | 网络超时 | 按 max_retries 重试 | | HTTP 403 | 提示检查 API Key 与 VIP 权限，联系九宽后台获取 | | HTTP 404 | 说明无数据或日期无效 | | 参数缺失 | 根据意图自动补全日期等参数 | | 空数据 | 如实说明，不编造数值 |

常见问题

Q: SKILL.md 和 README.md 有什么区别？

A: SKILL.md 是 Agent 加载的技能指令（工作流、输出规则、报告模板）；README.md 是面向用户/运维的完整使用文档与 FAQ。

Q: 如何修改 API 基础 URL？

A: 编辑 config.json 的 api_base_url，使用站点根地址 https://9quant.online，不要包含 /api/v1。

Q: 如何获取和使用 API Key？

A: 通过九宽后台/客服联系获取，写入 config.json 的 api_key 字段。

Q: 为什么查询结果为空？

A: 检查网络、API Key、VIP 权限、查询日期是否为有效交易日，以及话术是否足够明确。

Q: 如何查询昨日数据？

A: 使用「昨日」「昨天」等表达，如「昨日涨停」「昨天 RPS 突破选股」。

Q: 如何查看完整 API 定义？

A: 查看 skill 目录下的 api_knowledge.json 与 prompts/system_prompt.md。

更新日志

v1.5.0 (2026-08-19)

  • 知识库扩展至 56 个接口；新增 ETF 份额规模变化接口 2 个
  • etf_share_size：指定交易日的全市场/单只 ETF 份额变化（含 5/10/20/50 日比例），trade_date 必填
  • etf_share_size_history：单只 ETF 份额变化历史序列，ts_code 必填，默认近 120 自然日
  • 两接口可与 etf_daily_history 联动：份额变化 + 价格走势，观察资金净申赎方向
  • SKILL.md、prompts/system_prompt.md 同步更新 ETF 节、意图映射与组合分析

v1.4.0 (2026-08-19)

  • 知识库扩展至 54 个接口；新增同花顺/通达信板块选股策略 4 个接口
  • ths_turn_block_list、ths_main_block_list：同花顺转强/主流板块内个股选股（RPS/成交额/市值筛选）
  • tdx_turn_block_list、tdx_main_block_list：通达信转强/主流板块内个股选股
  • 四接口可与 ths_strong_turning/ths_mainstream/tdx_strong_turning/tdx_mainstream 联动：先查板块再查其成分股选股
  • SKILL.md、prompts/system_prompt.md 同步更新意图映射与组合分析

v1.3.0 (2026-05-16)

  • 与后端 api/v1 对齐：pro_quant_indicator、dashboard_indicator、daily_statistics_pro
  • 知识库扩展至 50 个接口；增补同花顺/申万/通达信指数与板块、实时行情、ETF、交易日历等
  • 通达信主流板块监控 tdx_mainstream 及转强、新增/消失接口
  • 支持「昨日」时间语义；SKILL.md 与 prompts/system_prompt.md 同步更新

v1.2.0 (2026-03-20)

  • 净利润断层、陶博士选股、RPS 突破、昨日涨停今日表现、季报、个股日线、财务系列 API
  • 时间语义与意图冲突消解（断层 vs 季报）

v1.0.0 (2026-03-12)

  • 初始版本：意图识别、参数配置、数据分析与多 API 联合查询

许可证

MIT License

联系支持

  • 官网：https://9quant.online
  • 技术支持：九宽有道

免责声明：本工具输出基于 API 历史数据，仅供数据参考，不构成投资建议。股市有风险，投资需谨慎。