Back to skills
extension
Category: Data & AnalyticsAPI key required

股票RPS数据分析

通过九宽量化 56 个 REST 接口(/api/v1/)查询并解读涨跌停、板块、选股、财务、多空雷达、RPS 等数据, 输出客观结构化报告(含风险提示与免责声明,不提供投资建议)。在用户询问九宽 API 数据、涨停跌停、 板块结构、陶博士/RPS/净利润断层选股、市场环境、实时行情、ETF/龙虎榜时使用。需在 config.json 配置 api_key(九宽后台联系获取,请求头 X-API-Key),对接 https://9quant.online,多数接口需 VIP。

personAuthor: user_577f8e79hubcommunity

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_keyapi_base_urlhttps://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.jsonapi_key 字段。多数行情与统计类接口需 VIP 权限。

使用方法

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

查询话术与接口映射

| 用户意图 | 示例话术 | 接口键 | |----------|----------|--------| | 涨跌停 | 「查询昨天的涨停股票」 | limittype=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_searchstock_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.mdprompts/system_prompt.md

API 接口列表

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

1. 基础数据(1)

  • stock_search:股票搜索

2. 市场数据(12)

  • limitlimit_yesterday_todaydailymarket_golden_score
  • pro_quant_indicatordashboard_indicatordaily_statistics_pro
  • ths_mainstreambig_indexbig_index_data
  • live_daily(盘中实时)

3. 板块 / 指数(16)

  • 同花顺:ths_indexths_index_detailths_index_membersths_strong_turningths_add_dellive_ths_indexlive_ths_index_top_sectors
  • 申万:sw_indexsw_index_detailsw_index_members
  • 通达信:tdx_indextdx_index_detailtdx_index_memberstdx_mainstreamtdx_strong_turningtdx_add_del

4. 股票数据(2)

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

5. 选股策略(8)

  • tdx_stock_listrps_tpprofit_gapn_days_high
  • 板块选股:ths_turn_block_listths_main_block_listtdx_turn_block_listtdx_main_block_list(板块内个股 RPS/成交额/市值筛选;通达信两个需 VIP)

6. 财务数据(8)

  • q_showq_forecastfinance_* 系列(三大报表、财务指标、量化指标等)

7. 龙虎榜 / 资金(3)

  • longhulonghu_detailholder_trade

8. ETF / 其它(6)

  • etf_statisticsetf_daily_history
  • etf_share_sizeetf_share_size_history:ETF 份额规模变化与历史(资金净申赎方向观察)
  • trade_date(交易日历)
  • 板块统计:block_daily_statisticsblock_live_statisticsblock_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.jsonapi_base_url,使用站点根地址 https://9quant.online,不要包含 /api/v1

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

A: 通过九宽后台/客服联系获取,写入 config.jsonapi_key 字段。

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

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

Q: 如何查询昨日数据?

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

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

A: 查看 skill 目录下的 api_knowledge.jsonprompts/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.mdprompts/system_prompt.md 同步更新 ETF 节、意图映射与组合分析

v1.4.0 (2026-08-19)

  • 知识库扩展至 54 个接口;新增同花顺/通达信板块选股策略 4 个接口
  • ths_turn_block_listths_main_block_list:同花顺转强/主流板块内个股选股(RPS/成交额/市值筛选)
  • tdx_turn_block_listtdx_main_block_list:通达信转强/主流板块内个股选股
  • 四接口可与 ths_strong_turning/ths_mainstream/tdx_strong_turning/tdx_mainstream 联动:先查板块再查其成分股选股
  • SKILL.mdprompts/system_prompt.md 同步更新意图映射与组合分析

v1.3.0 (2026-05-16)

  • 与后端 api/v1 对齐:pro_quant_indicatordashboard_indicatordaily_statistics_pro
  • 知识库扩展至 50 个接口;增补同花顺/申万/通达信指数与板块、实时行情、ETF、交易日历等
  • 通达信主流板块监控 tdx_mainstream 及转强、新增/消失接口
  • 支持「昨日」时间语义;SKILL.mdprompts/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 历史数据,仅供数据参考,不构成投资建议。股市有风险,投资需谨慎。