yyqdata 金融数据 API

要解决什么问题

大模型智能体在接股票、财务、期权等查询时，最容易犯的错不是「不会写 HTTP」，而是没真调接口就断言没有数据，或把 OpenAI 风格的 /v1/models、/whoami 当成数据后端——在本服务上只会 404。yyqdata 是一套独立的金融数据 REST API（base 到主机根路径，业务路径统一在 /openapi/v1/ 下），SKILL.md 把端点、字段命名、日期格式和失败模式写死，让 agent 按同一套骨架执行，而不是凭记忆拼 URL。

技能如何工作

会话起手有固定顺序：读 token（环境变量、config.json 或匿名领取 Free 档）→ POST /openapi/v1/whoami 确认套餐与 scopes（仅连通性，不能代替业务查询）→ 解析意图 → 涉及标的时先 stock/basic/search 得到 tsCode，再调具体数据端点。请求体字段用 camelCase（如 tradeDate、tsCode），日期多为 YYYYMMDD；响应走 {code, msg, data, traceId} 信封，code 异常时直接转述 msg。

文档强调第一铁律：凡「查不到 / 没有 / 后端为空」类结论，必须建立在正确端点 + 正确参数的真实请求上，并能给出 traceId；空 data 要先走「空结果自检」（字段名、日期、scope、枚举默认值、各端点日期是字符串还是毫秒时间戳等），排除误参后再对用户说明。长任务要求边拉边落盘、记检查点，避免上下文撑爆后从头重拉。

适用边界与注意点

• 不是 Chat Completions / OpenAI 兼容端点；token 自查只有 POST /openapi/v1/whoami（别名 /openapi/v1/token/info），无前缀的 /v1/whoami 等均不存在。
• 只能调用文档与速查表里列出的路径；403 表示套餐不含该 scope，不是「没数据」。
• whoami 的 scopes 只代表有权限查，用户问到对应维度时必须打真实数据接口，不能凭 whoami 幻觉业务结论。
• A 股 search 与港美股标的解析路径不同；K 线类接口的 tradeDate 在不同端点可能是 YYYY-MM-DD、YYYYMMDD 或毫秒时间戳，混用会导致「假空」。