捷利交易宝行情数据
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-frunk4e2/tradegoapi-skill。
技能介绍
它解决什么问题
多数港股、美股、A 股取数脚本要么依赖券商私有客户端,要么靠网页抓取,解析逻辑大量硬编码在自己代码里,行情源一改版就得跟着改。这个技能把「取数」收敛成一次 group + action 调用:本地网关负责鉴权与连接,智能体只负责把用户需求翻译成动作和参数,不必关心协议细节。
能力分两层
行情组(group=market)是主能力,覆盖指数、个股静态与动态数据、档位报价、经纪队列、分时、分钟与历史 K 线、盘前盘后快照、基本行情,以及成交明细(tk)、全盘逐笔成交(itemtradeticks / itemtraderesumes)、全盘逐笔委托(entryorders)。
新股组(group=ipo)是次要能力,覆盖新股通首页、递表列表、发行排行、基石投资者、保荐人搜索与历史项目、高管介绍、配售结果、孖展信息与历史。
统一路由只有三个维度:group、action,以及可选的 lang(0 英文、1 简中、2 繁中,默认 1)。常用可选参数还有 market、pageIndex、pageSize、sort、order。
调用前的硬约束
代码必须先规范化为「市场前缀 + 代码」:港股 E、深市 A、沪市 B、美股 N。08017 → E08017,600010 → B600010,AAPL → NAAPL;已带正确前缀的不重复追加,aapl.us 这类后缀格式要先去后缀再映射。
网关地址以技能包内 openapi.yaml 的 servers.url 为准(默认 http://127.0.0.1:18000)。所有 /skills/* 请求还必须在 query 里带 skillVersion,取值从包根目录 skillhub-update.local.json 的 localVersion 或 VERSION.txt 的 project_version= 读取,不要猜测或硬编码;gatewayVersion 由网关注入,客户端不要伪造。
失败时该怎么做
工具调用失败时不要直接放弃或静默换技能,按错误码给出对应动作:网关没跑就提示启动 TradeGo Gateway;没装就提示重装安装包;AUTH_REQUIRED / 401 / TOKEN_EXPIRED 就提示去网关控制台登录;GATEWAY_UNHEALTHY / GATEWAY_PORT_CONFLICT / GATEWAY_CONFIG_INVALID 就提示执行端口与配置自检;GATEWAY_VERSION_OUTDATED 就提示升级网关并重启。只有用户明确表示暂不处理网关问题时,才考虑其他技能。
适用边界
资讯、交易、持仓暂未开放,用户问起时直接说明即可。网关安装与启动需要用户在本机确认,智能体只提供下载链接和步骤,不能跳过网关直接声称可用。版本检查只在技能首次被调用且需要执行业务时做一次,每 12 小时最多 1 次,且不得阻塞业务回答。
使用场景
- 复盘港股个股当日分时走势,需拉取分钟K线数据对比技术指标,判断买卖时点。
- 量化回测前验证数据源,调用全盘逐笔成交接口检查字段完整性与时间戳分布。
- 整理港股新股聆讯进度,查最新递表列表并逐个补充发行概况、保荐人和基石投资者。
- 监控美股盘前异动,调盘前盘后快照接口对比实时报价,判断市场情绪方向。
适合人员
- 量化研究员,需要稳定获取历史K线和逐笔成交数据验证回测策略,对字段完整性和延迟敏感。
- 港股新股分析师,每周跟进递表、聆讯和配售进展,需要批量拉取新股通数据写入周报。
- 前端开发工程师,负责行情展示模块,需要快速验证盘口报价和经纪队列接口字段是否符合设计。
- 机构运维人员,负责维护本地网关服务,需要在调用失败时准确判断登录失效还是端口冲突以便恢复。