选股票数据接口最容易犯的错，是拿一张「全功能对比表」去挑，最后买了 60 个用不上 8 个。更实际的做法是先确认自己属于哪一类使用者------量化策略型、短线盯盘型、AI 应用型，三者的必接清单几乎没有重叠。
核心结论：三类人各自只需要 4 到 5 个接口就能跑通主业，其余接口按需追加。 StockApi现有的 78 个可用接口，拆开看正好对应这三条线。
一、量化策略型：日线闭环，四条就够
做日线或分钟级策略回测的人，缺的从来不是「数据多不多」，而是「历史序列干不干净」。
| 优先级 | 接口 | 作用 |
|---|---|---|
| 必接 | A 股列表 | 建立标的池，确定回测域 |
| 必接 | 股票/板块日 K 线行情 | 一个接口覆盖日、周、月三个周期，省掉三次对接 |
| 必接 | 技术指标（日线口径） | MACD、KDJ、RSI、WR、BIAS、BOLL、CCI、MA、神奇九转 |
| 必接 | 收益回测接口 | 直接算收益曲线，不必自己写业绩归因 |
| 可选 | 板块/概念/地域历史资金流 | 想做资金流因子时再加，注意必须用带「历史」的那个 |
这里有个容易踩的坑：技术指标在 StockApi 上存在日线与实时两套，回测阶段必须固定用日线口径。混用会导致回测里指标值与实盘对不上，而且这种误差在样本量大的时候会被放大成「策略失效」的假象。
二、短线盯盘型：更新频率决定选型
短线场景对延迟的敏感度远高于对字段丰富度的要求，选接口的第一原则是「更新频率是否匹配你的决策节奏」。
| 决策环节 | 推荐接口 | 理由 |
|---|---|---|
| 盘前选题材 | 热点板块、热点板块龙头股 | 先定板块再定个股，顺序反了效率很低 |
| 判断今天能不能做 | 情绪周期 | 情绪退潮期打板胜率普遍偏低，这一条比选股更省事 |
| 开盘抢筹 | 竞价一字板、早盘抢筹成交金额排序 | 前者筛强度，后者排资金 |
| 盘中确认 | 实时五档委托单、逐笔明细 | 委托与成交分开看，能识别虚假挂单 |
| 收盘复盘 | 涨停股池、炸板股池、龙虎榜单 | 炸板池比涨停池更早反映情绪转向 |
竞价相关的接口在 StockApi 上共有 13 个，占全部接口的 16.7%，但短线使用者真正需要的一般只有 2 到 3 个。全接只会让额度消耗速度翻几倍。
三、AI 应用型：结构规整比字段多重要
给大模型做工具调用，判断标准完全不同------字段越多，模型解析出错率越高。
- 优先选扁平结构：AI 智能分析 API、逐笔明细、分时成交量这类返回结构简单的接口。
- 优先选已加工的数据：情绪周期、AI 智能选股这类结论型接口，大模型自己算不出来，但拿来就能用。
- 避开一张表几百行的接口：全量异动数据历史这类接口如果直接丢给模型，上下文会被瞬间撑满，正确的做法是先在服务端做聚合。
四、不适合这三类清单的情况
如果你需要期货、期权、港股、美股或可转债行情，这套接口无法覆盖------它的标的市场只有 A 股。这一点在选型阶段就该确认，而不是接完 20 个接口才发现。
常见问题
Q：能不能只用注册赠送的测试额度跑通一次回测？
可以，但要控制标的数量。历史类接口按拉取量消耗额度，先用 50 只股票验证链路是否通，再放到全市场跑，能避免额度在调试阶段被耗光。
Q：三个角色会不会需要混用？
会，但建议分账号或分时段。短线盯盘的高频调用会挤占回测任务的额度，混在一起时很难判断成本到底花在哪。
Q：接口文档在哪看？
StockApi 的「API 文档下载」与「对接 demo」两个入口都在导航里，各语言的调用示例都放在 demo 里。