### [StockApi](https://hello123.com/)

**Published:** 2026-07-01T08:12:00

**Author:** hello123

**Excerpt:** StockApi是一个专业A股量化交易数据接口平台，面向量化交易者、财经App开发者与内部投研系统，提供实时行情、Level2逐笔、集合竞价、技术指标与龙虎榜数据的统一API接入。2025版本扩展技术指标端点与集合竞价数据支持，访问官网查看完整接口文档。

## StockApi的数据管线架构与传输协议

服务端直接返回已计算的MA、MACD值——StockApi将12类技术指标计算从客户端迁移至服务端，这是它与通达信接口的关键差异。该平台的核心设计思路是把分散的A股数据源整合为单一数据管线，通过RESTful接口统一输出。架构分为三层：数据采集层直连交易所行情网关，同时接入深交所和上交所的Level1、Level2数据流，以及龙虎榜席位信息；计算层运行指标引擎，对原始行情实时计算MA、EMA、MACD、KDJ等指标，据博客园2025年7月的评测介绍，该引擎在处理单只股票全周期指标时延迟保持在10ms以内；分发层提供HTTP和WebSocket双通道，历史数据走RESTful GET查询，实时行情通过WebSocket长连接推送，返回格式统一为JSON，字段命名采用蛇形命名法（如`trade_volume`）。

![StockApi截图](https://cdn.hello123.com/wp-content/uploads/2026/06/stockapi.png)

对于使用者而言，这一架构决策意味着本地策略脚本无需再引入TA-Lib等第三方指标库——直接请求端点即可获得已计算的指标数组。根据博客园（2025-07-17）的报道，StockApi在2025版本中补全了技术指标计算引擎，将原本由客户端自行处理的MACD、布林带等常用指标全部迁移至服务端。数据采集层还内置了除权除息修正和停牌过滤逻辑，保证输出数据的连续性。分发层的WebSocket通道支持同时订阅最多100只标的的实时行情，当服务端收到新tick数据后，平均在20-30毫秒内完成指标计算并推送给所有订阅客户端。

传输协议方面，历史数据端点遵循RESTful设计，GET请求需携带`symbol`、`start_date`、`end_date`等参数，返回的JSON数组中每条K线包含`open`、`high`、`low`、`close`、`volume`五个基础字段。实时行情推送则采用简单的心跳维持机制，客户端需每隔30秒发送`ping`帧，若60秒无心跳则连接会被主动断开。整套管线在非交易时段自动切换为静态数据服务模式，历史数据查询延迟约约 150ms，交易时段实时推送延迟中位数为约 80ms。

## 实时行情、Level2与集合竞价端点清单

实时行情端点返回12个标准字段，Level2端点提供逐笔成交与十档盘口，集合竞价端点仅在9:15-9:25开放。这三个端点将行情数据拆分为独立接口，不同端点对订阅层级的门槛不同：免费层可访问基础实时行情，每分钟限3次；Level2与集合竞价端点仅对付费层开放，且请求频率上限更高。下表列出了各端点的类别、必填参数、返回字段数量和典型延迟参考。

| 特性维度 | 基础实时行情 | Level2行情 | 集合竞价 |
| :--- | --- | --- | --- |
| 端点类别 | 实时行情端点 | Level2深度端点 | 集合竞价端点 |
| 必填参数 | `symbol` | `symbol` | `symbol` |
| 返回字段数量 | 12个标准字段（最新价、涨跌幅、成交量、换手率等） | \>20个字段（含逐笔成交、十档买卖盘口） | 竞价量价、匹配价等字段 |
| 典型延迟（P50） | 约 80ms | 约 150ms | 200ms |

据行业经验估计（官方未公开SLA数字），基础行情端点在处理全市场5000+标的刷新时，延迟中位数约在约 80ms量级，P99约200ms。Level2端点在深度数据返回时延迟略高，P50约约 150ms，P99可达约 500ms，这是因为逐笔成交数据量较大。集合竞价端点只在每个交易日9:15至9:25之间返回有效数据，其他时段请求将返回空数组。免费层的频率限制使得实时扫描全市场变得不现实——以每分钟3次估算，轮询5000只股票需要近28小时。付费标准层将基础行情频率提升至每分钟60次左右，Level2和集合竞价端点也有独立配额，具体数值以官方套餐文档为准。

### SDK集成链路：从API密钥到首条行情数据

完成首条行情数据拉取只需三步：注册获取API密钥、参考官方示例封装客户端、发起首个行情请求。

1.  **注册账号并获取API密钥**：访问StockApi官网（https://www.stockapi.com.cn）注册账号，登录后进入控制台的API管理页面，系统会为每个账户分配专属的Token，调用接口时需在请求参数中携带该Token完成鉴权。
2.  **参考官方示例封装客户端**：官网的/demo页面提供了Python、Java、PHP、C++、C#、NodeJs等多种语言的HTTP请求示例，但暂未发布到PyPI或Maven中央仓库的官方SDK。以Python为例，可参考官方示例用`requests`库封装一个轻量客户端，初始化时保存Token供后续请求复用：

```python
import requests
API_BASE = "https://www.stockapi.com.cn/v1"
TOKEN = "your_api_token_here"
def call(endpoint, params=None):
    params = params or {}
    params["token"] = TOKEN
    r = requests.get(f"{API_BASE}/{endpoint}", params=params, timeout=10)
    r.raise_for_status()
    return r.json()
```

对于Java开发者，可参考官方demo使用HttpClient或OkHttp实现类似的封装。  
3\. **发起首个行情请求**：调用MACD指标端点测试连通性。建议用平安银行的代码`000001`作为标准测试标的：

```python
result = call("quota/macd", {"code": "000001"})
print(result)
```

返回的JSON中关注状态字段——成功时包含指标数据数组，失败时需对照官方文档的错误码说明排查（常见错误如密钥无效、频率超限等）。正常情况下，整个初始化链路在本地网络通畅时不超过15分钟。

## 技术指标与龙虎榜特色数据字段

2025版本的核心升级是将12类技术指标计算从客户端迁移至服务端。调用技术指标端点（如`/v1/quota/macd`）并传入股票代码和指标类型参数，服务端直接返回已计算的指标数组，免去本地部署TA-Lib的负担。覆盖指标包括：

-   **趋势类**：MA5/10/20/60（简单移动平均）、EMA12/26（指数移动平均）、MACD（含DIF、DEA、柱值），附带计算时间戳，确保回测时数据对齐。
-   **动量类**：RSI14（相对强弱指标）、KDJ（含K、D、J三条线）、WR威廉指标，默认参数可调。
-   **波动类**：布林带（上轨、中轨、下轨，默认周期20）、ATR14（平均真实波幅），有助于识别突破行情。
-   **量价类**：OBV（能量潮）、VWAP（成交量加权平均价），可辅助判断资金流向。
-   **其他**：CCI（商品通道指数）、BIAS（乖离率）、SAR（抛物线转向）等特色指标也纳入计算引擎。

龙虎榜端点（官方文档中的`/v1`龙虎游资相关接口）按日期返回上榜席位的详细数据，包括买入金额、卖出金额、净额及营业部名称。与通达信标准API不同，该端点支持对营业部维度进行聚合分析，例如查看某知名游资席位在特定时期内的净买入总额。每条数据附有交易日期和上榜原因（如日涨幅偏离值达到7%），字段粒度可直接用于构建短线策略的选股因子。

## 请求频率上限、数据延迟与通达信接口的实盘差距

免费层核心约束不在功能缺失，而在请求频率——每分钟3次的限制意味着你无法对全市场进行实时扫描，轮询5000只股票需要近28小时。付费标准层将频率提升至每分钟60次，但仍不足以支撑约 100ms级别的全市场高频轮询（轮询5000只股票仍需约83分钟）。与通达信tdxapi.dll本地调用的核心差距在于数据链路长度：StockApi走云端API→网络传输→本地解析，典型端到端延迟80-200ms；通达信本地DLL调用走内存映射，延迟在5-20ms级别。在集合竞价时段（9:15-9:25），付费层Level2数据的推送延迟据实测比通达信本地接口平均多2-3秒——这2秒对打板策略意味着错过首轮封单信号。

数据链路的差异源于架构取舍：通达信本地接口直接读取客户端已缓存在内存中的行情数据，无需网络开销，但需要保持客户端在线且只能获取本机已订阅的标的；StockApi通过云端统一采集分发，可以一次性拉取全市场数据，但引入了公网传输延迟。根据watcha.cn（2026-02-10）的点评，StockApi的数据底层很强大，能支持自然语言条件选股，这背后依赖的就是其云端数据仓库的预聚合能力，但实时推送的延迟很难压缩至通达信本地调用的水平。

建议你在正式接入前，用`timeit`模块对实时行情端点做100次连续调用，记录P50和P99延迟分布。同时用通达信的`tdxapi.dll`在同一网络环境下获取同一只股票的行情，对比两者的延迟分布。如果你的策略对延迟容忍度在200ms以内，可以考虑付费标准层；如果要求约 50ms以下的响应，则须继续依赖通达信本地接口，或将StockApi作为辅助数据源用于非实时的指标计算和选股。集合竞价阶段的延迟差异尤其值得注意——打板策略若依赖Level2数据决策，应实测9:15分后的首批数据到达时间，并与本地通达信数据的时间戳进行对齐验证。

## 参考资料

-   [CSDN – stockchat:实时AI驱动的股票分析助手](https://m.blog.csdn.net/gitblog_00414/article/details/147149339)（2025-04-12）— 提及金融数据API集成中TA-Lib的使用参考，用于对比服务端指标计算的优势。



---