Noah Stock Market

港股 / 美股只读市场数据 skill。通过公司内部证券 Open API 获取市场数据，并将原始结果整理成适合聊天场景阅读的结构化摘要。

> Usage notice：本 skill 只提供市场数据查询与整理，不提供下单、持仓、账户或投资建议。

Installation / Usage Prerequisite

本 skill 依赖公司内部证券 Open API。通过 ClawHub / OpenClaw 安装后，用户仍需补充 market token。

推荐配置文件：

~/.openclaw/.secrets/noah-market.env

推荐最小配置：

NOAH_MARKET_APIKEY=your_common_token
NOAH_API_BASE_URL=https://securities-open-api.noahgroup.com

说明：

• 当前生产 market 域名已固定为 https://securities-open-api.noahgroup.com
• noah-stock-market 与 noah-stock-trade 共用同一个通用 token
• token 不内置；安装后用户需自行补充 NOAH_MARKET_APIKEY
• 不要让用户额外提供与 market 查询无关的配置项

Skill Routing

当前环境已验证支持：

• 个股快照 / 最新行情
• 实时分时 / K线（含时间范围 K 线）
• 逐笔成交 / 经纪队列
• 市场状态 / 全局市场状态
• 交易日历
• 个股资金流向
• 股票基础信息
• IPO 列表 / 排行榜 / 条件选股
• 美股分析（US analysis）
• 港美股财务数据
• 股东增减持榜单
• 财富类查询：余额、总资产、现金类资产、固收资产、私募资产、银行定存详情

不支持：

• 下单 / 撤单 / 改单
• 账户 / 持仓 / 资金查询
• 任何交易写操作
• 主观投资建议或收益承诺

Preflight

1. 先读取 references/auth-and-preflight.md，确认 API 配置与 token 读取方式。
2. 再根据用户意图，按需读取对应 reference：
• 标的识别 / 代码标准化 → references/symbol-resolution.md
• 快照 / 最新行情 → references/snapshot-and-quote.md
• 分时 / K线 → references/kline-and-intraday.md
• 逐笔 / 经纪队列 → references/orderbook-ticker-broker.md
• 市场状态 / 交易日 → references/market-status.md
• 资金流向 → references/capital-flow.md
• 基本信息 → references/plates-and-basicinfo.md
• API 意图映射 → references/api-mapping.md
• 使用方式总览 → references/usage-guide.md
• 当前限制 → references/known-limitations.md

Execution Rules

• 默认只走只读接口。
• 优先使用标准代码发请求：港股 HK-00700，美股 US-AAPL。
• 用户输入名称、简称或裸代码时，先做标准化，再请求接口。
• 如标的存在歧义，不要猜；先返回候选或要求用户澄清市场 / 代码。
• 默认返回结构化摘要，不直接倾倒整段原始 JSON。
• 仅当用户明确要求“明细”“完整逐笔”时，才展开更多原始字段。
• 排行榜、IPO 列表属于扩展能力；只有当用户明确问到时才使用。

• 对 wealth_total_asset 与 wealth_private_contract_asset_list：
• 如果用户明确给出币种，则按用户指定币种查询
• 如果用户未给出币种，则默认按 USD 查询

Recommended Script Entry

优先通过 scripts/run_query.py 调用已验证能力：

协议规则（重要）：

• references/openapi.yaml、references/enum.yaml、references/entity.yaml 是本 skill 的协议源文件。
• 凡是 openapi 参数声明为枚举引用（enum.yaml#/...），调用时必须从 references/enum.yaml 取值并校验，禁止按语义猜测枚举值。
• 若协议源缺失、解析失败或传入值不在 enum 中，应直接报错，不要构造猜测参数继续请求。

• snapshot
• market_state
• global_state
• intraday
• ticker
• broker_queue
• kline
• capital_flow
• basicinfo
• trading_days
• us_analysis
• rank
• ipo_list
• financial_hk
• financial_us
• shareholder_inc_red_hold
• shareholder_inc_red_hold_by_ucode
• wealth_balance_list
• wealth_cash_total_asset
• wealth_fixed_income
• wealth_private_contract_asset_list
• wealth_total_asset

示例：

python3 scripts/run_query.py snapshot HK-00700
python3 scripts/run_query.py market_state HK-00700
python3 scripts/run_query.py global_state HK-00700
python3 scripts/run_query.py intraday HK-00700
python3 scripts/run_query.py ticker HK-00700 num=10
python3 scripts/run_query.py broker_queue HK-00700
python3 scripts/run_query.py kline HK-00700 num=10 ktype=K_DAY
python3 scripts/run_query.py kline HK-00700 from=20260401000000000 to=20260413235959999 ktype=K_DAY autype=NONE
python3 scripts/run_query.py capital_flow HK-00700 num=5
python3 scripts/run_query.py basicinfo HK-00700
python3 scripts/run_query.py trading_days HK-00700 start=20260401 end=20260430
python3 scripts/run_query.py us_analysis US-AAPL
python3 scripts/run_query.py rank HK market_codes=HK rank_field=raisePercent page=1 page_size=10
python3 scripts/run_query.py ipo_list HK market=HK
python3 scripts/run_query.py financial_hk HK-00700 type_code=DT4 year=2024
python3 scripts/run_query.py financial_us US-AAPL type_code=DT4 year=2024
python3 scripts/run_query.py shareholder_inc_red_hold HK market=HK shareholder=EVENT_DATE order_code=DESCEND page=1 page_size=10
python3 scripts/run_query.py shareholder_inc_red_hold_by_ucode HK-00700 shareholder=EVENT_DATE order_code=DESCEND page=1 page_size=10
python3 scripts/run_query.py wealth_balance_list HK
python3 scripts/run_query.py wealth_cash_total_asset HK
python3 scripts/run_query.py wealth_fixed_income HK productTypeList=NOTE,DEPOSIT_COM toCcy=HKD showTotalAsset=true
python3 scripts/run_query.py wealth_private_contract_asset_list HK toCurrency=HKD queryType=ALL positionStatus=HOLDING isPaging=true
python3 scripts/run_query.py wealth_total_asset HK toCurrency=HKD

如果脚本返回 ok=false，先直接向用户说明失败原因，不要编造数据。

如果用户没有指定 K 线周期与数量，kline 默认使用 num=5、ktype=K_DAY、autype=NONE。

如果用户直接用自然语言提问，可优先尝试 scripts/route_query.py 做第一轮意图识别，再落到 scripts/run_query.py。

当前 route_query.py 已支持基础的 K 线周期识别（如日K、周K、月K、5分钟K）与数量识别（如“最近10根”）。

Output Style

默认输出顺序：

1. 一句话结论
2. 关键数据
3. 补充观察
4. 数据时间 / 状态说明

要求：

• 把枚举值翻译成人话，不直接输出原始枚举代码。
• 对港股 / 美股盘前盘后状态做明确说明。
• 对停牌、退市、无权限订阅、空数据等情况直接说明原因。
• 保持客观，不给买卖建议。

Response Mode Rule

开发模式

当用户在开发、调试、设计或排查这个 skill 时，可以说明：

• 使用了哪个接口
• 请求参数
• 返回结构
• 当前实现逻辑与已知问题

股票帮手模式

当 skill 面向最终用户实际使用时：

• 只回答用户需求与结果
• 只展示清晰、简洁、业务化的数据结果
• 不暴露接口 URL、路径、token、脚本名、内部实现逻辑
• 不把开发调试信息带给最终用户
• 如果用户询问“noah-stock-market 有什么功能”“你支持什么功能”“这个 skill 能做什么”等能力范围问题，优先用下面这套标准口径回答：

noah-stock-market 目前支持港股和美股的只读市场数据查询，主要包括：

• 个股快照 / 最新行情
• 分时走势 / K线
• 逐笔成交 / 经纪队列
• 市场状态 / 全局市场状态
• 交易日历
• 个股资金流向
• 股票基础信息
• IPO 列表 / 排行榜
• 美股分析
• 港美股财务数据
• 股东增减持信息
• 财富类查询（余额、总资产、固收、私募、现金、银行定存详情）

你可以直接用自然语言提问，比如：

• 看一下腾讯现在的股价
• 看腾讯最近 10 根日 K
• 查一下腾讯资金流向
• 现在港股开盘了吗
• 看港股涨跌幅排行榜
• 查一下苹果的美股分析
• 看一下腾讯的财务数据
• 查一下腾讯最近的股东增减持

一句话概括就是：

noah-stock-market 已经覆盖港股 / 美股常用行情查询、结构化分析，以及财务和股东增减持这两类扩展数据能力。

Notes

• 市场代码当前一期只重点支持港股和美股。
• 港股标准代码格式：HK-00700
• 美股标准代码格式：US-AAPL
• token 与 base URL 不写入 skill 正文，从本地 secrets 配置读取。