捷利交易宝行情数据

概述

TradeGo OpenAPI 行情数据查询

仅唤起、无具体问题时，读取 [agent-greeting.md](./agent-greeting.md) 后回复。

安装与网关接入

用户要求安装、首次接入，或出现 GATEWAY_NOT_INSTALLED / GATEWAY_NOT_RUNNING / AUTH_REQUIRED 时：

1. 读取安装入口文件（按用户 OS 分流到对应平台指南）：
   • 包内 skillhub-install-hub.md，或 https://resource.iqdii.com/java/skills/live/skillhub-install-hub.md
   • 若尚未安装技能包，也可读 skillhub-update.local.json 的 installGuideUrl
2. 按入口文件中的「智能体操作」：先协助用户安装/启动本地网关，再导入技能包并配置 MCP（如适用）。
3. 网关安装需用户本机确认；智能体提供下载链接与步骤，不跳过网关直接声称可用。

当前能力状态

1. 主能力（已上线）：group=market（港股/美股/A股行情：报价、快照、经纪席位、买卖档位、盘口、逐笔成交、分时、日/周/月/年/分钟 K 线等）
2. 次要能力（已上线）：group=ipo（新股通查询，支持首页、递表、简况、发行排行、投资者、保荐人、高管、配售、孖展等接口）

仅使用下方动作表与 openapi.yaml 已列出的接口，勿虚构未列出的能力。

通用参数（统一路由）

动作约定

1) 行情组（group=market）— 主能力

用户提到行情、报价、价格、K线、快照、买卖盘、全盘、成交、分时、板块等时，优先使用本组。

2) 新股组（group=ipo）— 次要能力

当用户询问新股、IPO、递表、发行排行、基石投资者、保荐人、高管、配售结果或孖展信息时，必须按下表选择 group=ipo 的对应 action 调用工具，不要回答新股功能未开放。

常用可选参数：market=mkt_hk/mkt_hs/mkt_us、pageIndex、pageSize、sort、order

code 规范化规则（market 使用）

调用前请先把用户输入的代码规范化为“市场前缀 + 代码”：

1. 港股（HK）用 E，深市（SZ）用 A，沪市（SH）用 B，美股（US）用 N
2. 示例：08017 -> E08017，600010 -> B600010，AAPL -> NAAPL
3. 如果已经带正确前缀，不要重复追加
4. 如果是后缀格式，先去后缀再映射：aapl.us -> NAAPL

执行方式

通过 openapi.yaml 调用本地网关。请以当前技能包内 openapi.yaml 的 servers.url 为准（默认 http://127.0.0.1:18000）。

版本号传递（硬约束）

调用本地网关业务接口（/skills/*）时，必须在 query 中附加 skillVersion：

1. 优先读取包根目录 skillhub-update.local.json 的 localVersion
2. 若无，则读取包根 VERSION.txt 中的 project_version=
3. 以 skillVersion=<版本号> 形式附加到请求 URL；不要猜测或硬编码版本号
4. 网关会自动再注入 gatewayVersion；客户端无需也不应伪造 gatewayVersion

示例：/skills/market/index?code=EHSI&lang=1&skillVersion=1.1.46

失败处理规则

当工具调用失败时，智能体不得直接放弃本技能或静默改用其他技能。请先根据错误类型向用户说明原因和处理动作：

1. 如果无法连接当前 openapi.yaml 配置的本地网关地址，或返回 GATEWAY_NOT_RUNNING，提示用户：本地网关未运行。请打开 TradeGo Gateway，点击“启动网关”，等待状态变为运行中后重试。
2. 如果返回 GATEWAY_NOT_INSTALLED，提示用户：未检测到网关程序。请重新安装 gateway-desktop-installer-prod.zip，安装后启动网关。
3. 如果返回 AUTH_REQUIRED、401、TOKEN_EXPIRED 或提示未登录，提示用户：当前操作需要登录。请在网关控制台完成登录后重试。
4. 如果返回 GATEWAY_UNHEALTHY、GATEWAY_PORT_CONFLICT 或 GATEWAY_CONFIG_INVALID，提示用户：请打开网关控制台的“配置与自检”，执行端口检查、配置检查或重启网关。
5. 如果返回 GATEWAY_VERSION_OUTDATED，提示用户：网关版本过旧。请升级最新网关安装包，并重启网关和当前智能体客户端。
6. 只有在用户明确表示暂不处理网关问题时，才可以尝试其他技能。

更新策略

用户始终只更新一个总包，不需要按能力重复安装。

• 不要在每次对话加载时读取 update-check.md。
• 仅在本会话首次调用本技能且需要执行业务时，先按需读取 [update-check.md](./update-check.md)，再执行行情等操作。
• 版本检查不得阻塞业务回答；仅在本技能首次被调用时检查，且每 12 小时最多 1 次（详见 update-check.md）。

示例

示例 1：行情指数

{
  "group": "market",
  "action": "index",
  "code": "EHSI",
  "lang": "1"
}

示例 2：逐笔委托

{
  "group": "market",
  "action": "entryorders",
  "code": "E00700",
  "type": "100",
  "pos": "-1",
  "dir": "-1"
}

示例 3：新股通首页

{
  "group": "ipo",
  "action": "home",
  "market": "mkt_hk"
}