# 全量超级接口 ETF 分钟数据只读验收

验收日期：2026-08-05（Asia/Shanghai）

## 最终结论

员工 Key 和中转服务可以正常调用，但当前服务没有目标 ETF 的历史分钟正文，因此不能填补 ETF 日内回测缺口。

- 股票控制样本：`stk_mins` 查询 000001.SZ 的 2026-07-01，成功返回 241 条，09:30 至 15:00。
- ETF 历史分钟：510900.SH、511010.SH、518880.SH 在 2026-07-01 均返回 HTTP 404。
- 历史纵深：510900.SH 在 2020-01-02 与 2014-01-02 同样返回 HTTP 404。
- 候选接口 `fund_mins`：返回业务码 40101“请指定正确的接口名”，说明该接口名不存在。
- ETF 实时分钟：`rt_min` 对 510900.SH 成功，但收盘后只有 2026-08-05 15:00 的 1 条快照，不能用于历史回测。

这组对照排除了 Key 错误、调用格式错误和整个 `stk_mins` 不可用：相同 Key、相同请求格式下，股票分钟成功，ETF 分钟 404。

## 限流实测

接口说明标注 45 次/分钟、并发 2、每日 30,000 次；实际连续低频样本中出现 HTTP 429，`Retry-After` 先为 5 秒、后为 60 秒，且没有返回剩余额度头。批量程序应采用更保守的默认值：

- 单并发；常态不超过 6 次/分钟。
- 严格遵守 `Retry-After`；429 后停止当前批次。
- 本地缓存、按标的和日期断点续跑，禁止重复下载。
- 每日设置远低于 30,000 次的内部预算，先小样本验收再扩展。

## 安全问题

服务地址目前是 `http://`，员工 Key 会随请求头以明文链路传输。该 Key 没有写入源码、结果、成果档案或云端配置，但它已经出现在对话中。长期使用前应让服务方提供 HTTPS 或可信 VPN/内网入口，并更换一次员工 Key，再作为本地或云端 Secret 配置。

## 发给客服的精确问题

> 目前相同员工 Key 调用 `stk_mins`：000001.SZ / 20260701 成功返回 241 条；510900.SH、511010.SH、518880.SH / 20260701 均 HTTP 404，510900.SH / 20200102、20140102 也 HTTP 404。`fund_mins` 返回 40101 接口名错误；`rt_min` 只有当前 1 条快照。请确认公司 DuckDB 是否尚未导入场内 ETF 历史 1 分钟数据。若有，请给出正确 api_name、参数和 510900.SH 样例；若没有，请提供包含 `ts_code, trade_time, open, high, low, close, vol, amount` 的 ETF 1分钟文件目录，覆盖至少 2012 至今，并说明全量 T+0 ETF、退市基金、集合竞价、复权/分红和缺失值规则。同时请提供 HTTPS 地址及实际限流策略。

## 策略影响

该接口可作为股票历史分钟的补充交叉验证，也可作为 ETF 实时快照备用源；但在 ETF 历史分钟补齐前，日内策略仍只做前向影子测试，不根据日线回测自动调整 20/60 分钟 EMA、VWAP 或成交执行参数，更不会启用真实资金。