A股L2行情全推API接口

A股 Level2级别实时全推API

超低延时 · 超高稳定 · 超大带宽 · 高质量数据服务14年

原生TCP协议
实时全推/按需订阅
超低延迟
可用性>99%

接口概述

本文档描述全推接口的使用规范，该接口基于原生TCP协议，用于接收股票全量推送数据，支持实时获取股票行情相关信息，适用于需要批量、实时同步股票数据的业务场景。

接口基础信息

参数名称参数值说明
接口协议原生TCP协议采用TCP可靠传输，保障数据完整性
服务地址（host）x.x.x.x接口服务端域名/IP，需确保客户端可正常访问
端口（port）0TCP连接端口，固定不变 (实际请按提供方分配填写)
认证令牌（token）—客户端身份认证凭证，必填，需原样发送
字节序小端字节序数据传输及解析需遵循小端字节序规则

连接与数据接收流程

  1. 1

    连接建立

    客户端需使用标准TCP客户端工具/代码，与服务端指定 host 和 port 建立TCP连接，确保网络通畅，无防火墙拦截该端口的TCP通信。

  2. 2

    身份认证

    TCP连接建立成功后，客户端需立即向服务端发送指定 token，完成身份认证。认证通过后，服务端将开始向客户端推送全量数据；认证失败则会断开TCP连接。

  3. 3

    数据接收

    核心规则：认证通过后，客户端持续监听TCP连接的输入流。每一条完整数据的前4个字节为该条数据的长度（按小端字节序解析），后续字节为实际业务数据。

数据格式说明

5.1 传输规则

  • 单条数据采用字符串格式，字段之间使用英文逗号分隔
  • 编码格式默认 UTF-8
  • 数据长度字段（前4字节）为无符号整数，小端字节序

5.2 数据示例

1. 行情数据：
000001.SZ,1,20260818,94351000,111000,0,0,7819,0,,,8911020,98989039,111400,110800,111000,111000,111100,111200,111300,111400,111500,111600,111700,111800,111900,112000,552200,233600,386600,635700,381500,271300,225300,287100,239900,545000,111000,110900,110800,110700,110600,110500,110400,110300,110200,110100,32800,190200,544400,498400,757600,671900,165200,321100,359300,823900,114900,108100,15130268,10595900,0,0,0,0,0
2. 逐笔成交数据：
000001.SZ,000001,20260818,100747470,19095546,0,0,B,111000,2900,19030392,19095540
3. 逐笔委托数据：
000001.SZ,000001,20260818,100343990,0,17883123,2,B,110500,1300

字段说明

序号字段名称说明备注

注意事项

  • 字节序规范：务必按照小端字节序解析数据长度字段，否则会导致数据解析失败

  • Token使用：token为接口访问唯一凭证，需妥善保管，禁止泄露；若token失效，需联系接口提供方更新

  • 连接稳定性：若TCP连接断开，客户端需重新建立连接并发送token，方可恢复数据接收

  • 数据处理：建议客户端对接收的数据进行校验（如字段数量、数据格式），避免因异常数据导致业务异常

  • 编码规范：数据字符串默认采用UTF-8编码，解析时需统一编码格式，防止中文乱码

异常处理

异常场景现象描述处理建议
连接失败无法与服务端建立TCP连接检查网络连通性、服务地址、端口是否正确，确认防火墙未拦截
认证失败发送token后连接被断开检查token是否正确，确认token未失效
数据解析失败解析出的字段数量不符或数据格式错误检查字节序解析方式、数据分隔符是否为英文逗号、编码格式是否为UTF-8
连接断开正常接收数据过程中连接中断客户端实现重连机制，重新建立连接并完成认证

Demo下载

终端测试器

下载