yyqdata 股票数据 API
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/kouyusanpi-yyqdata-stock-skill-3531。
技能介绍
要解决什么问题
当你在对话里让 AI「查茅台昨收」「拉期权日线」「看 PMI」时,常见失败是两类:一是 agent 把服务当成 OpenAI 式 /v1/chat/completions,一路 404;二是没真打过接口就回答「没有数据」。yyqdata 技能把宿主约束在一套股票与衍生品 REST API(${BASE}/openapi/v1/**)上,用 whoami 做 token/套餐探测,用 search 把口语标的规范化成 tsCode,再按文档端点拉业务数据。
技能如何工作
会话首轮建议固定四步:token(环境变量 $YYQDATA_TOKEN 或用户提供的 stk_live_xxx)→ POST /openapi/v1/whoami 读取 scopes/rateLimit → 按用户意图映射到行情、财务、stock.market(资金流/龙虎榜等)、derivative(期权期货)等 workflow → 涉及个股时先 POST /openapi/v1/stock/basic/search,勿凭记忆拼代码。
请求范式:camelCase 请求体、日期多用 YYYYMMDD(K 线响应里 tradeDate 格式因端点而异,文档有长清单)。鉴权用 Authorization: Bearer 或受限环境下的 GET + ?token=。响应为 {code, msg, data, traceId};code 非成功时按 msg 说明,勿 fallback 到臆造路径。
技能里强调的操作主循环与「空结果自检」——字段名、scope(如 market(国内宏观) vs stock.market(个股市场行为,URL 带 /stock/market/)、日期、枚举默认值——是为了让「无数据」结论建立在真实 traceId 之上,而不是 whoami 成功后的幻觉。
适用边界
- 只能调用技能文档与速查表列出的端点;
/v1/models、/stock/api/*等不存在。 - whoami 不替代任何业务查询;scope 里有某维度,用户问到就必须打对应数据接口。
stock/basic/search仅覆盖 A 股;港美股解析规则另见文档。- 这是数据 API skill,不是 LLM 推理服务;长任务(全市场翻页)需检查点与边拉边落盘,避免上下文撑爆。
使用场景
- 用户在对话里用公司名或六位代码要日 K,需要先 search 成 300750.SZ 再调 stock/kline/daily
- 研究员要对比多只标的资金流与龙虎榜,走 stock.market 下 moneyflow、lhb 等端点并统一日期窗
- 量化脚本在只能 GET 的沙箱里拉宏观 CPI,用 query 参数带 token 访问 market 系接口
- 用户问某交易日全市场期权日线,需用 derivative 下 daily-by-date 并分页,避免一次塞进上下文
适合人员
- 写选股/复盘脚本的量化爱好者,需要 Agent 严格按 openapi 字段与日期格式拉 A 股行情
- 买方或卖方研究员,要在对话里快速核对财务指标、复权因子与板块资金,且不接受「没查就说没有」
- 在 Claw/OpenClaw 上接交易数据的工作流作者,依赖环境变量注入 token 做多端点探测
- 数据工程实习生,负责把期权或期货 K 线落 CSV,需要长任务检查点与 scope 403 的明确报错