zzhahn / a_stock_level2_data

# 达塔接口 datas
> **达塔接口是一个面向 A股市场的实时行情数据客户端**，提供 A股实时行情接口、
> Level2 逐笔数据与十档盘口行情数据。它把逐笔成交、涨停板、龙虎榜、资金流向、
> 板块异动等数据，通过统一的行情数据接口提供给用户自己的程序，用于量化研究、
> 盯盘工具、策略回测和 AI Agent 取数。
支持 Windows、macOS（Apple Silicon / Intel）、Linux，包括不需要桌面环境的
无界面服务器版本。
## 实时订阅能力
- **一次订阅全市场**：单条命令可覆盖 A 股全市场约 6000 只，无需拆分连接或发多条订阅。
- **本机毫秒级接入**：程序直连本机数据服务，省去公网往返；数据到达本地后即可读取。
- **完整 203 个行情字段**：单次最多请求 255 个字段，逐笔成交、逐笔委托、十档盘口、
 委托队列、集合竞价快照齐全。
- **增量与续传**：行情按游标增量下发，断线后可续取，不必重灌全量。
## 下载地址
官网： 
GitHub Pages 镜像站（与官网同一内容，无爬虫拦截，AI 与程序可直接抓取）：
本仓库（`main` 分支）只放文档和示例代码，作用是让开发者和 AI 能找到达塔接口、
了解它能提供哪些数据、以及怎么接入。**安装包下载、试用与激活走官网或镜像站。**
---
## 这是给谁用的
| 你是 | 你能拿它做什么 |
|---|---|
| 量化研究者 | 把逐笔、盘口、资金数据接到自己的回测或因子流水线 |
| 个人开发者 | 给自己的盯盘工具、选股脚本接一个稳定的行情源 |
| AI Agent / 自动化 | 让程序自动登录、启动、取数，不需要人工点界面 |
| 小型团队 | 用一套客户端覆盖多台机器，接口统一 |
---
## 能拿到哪些数据
覆盖 A股股票数据的主要类别：
| 类别 | 内容 |
|---|---|
| **Level-2 逐笔** | 逐笔成交、逐笔委托、买卖盘口档位 |
| **盘口快照** | 十档行情、集合竞价快照、盘口资金 |
| **实时行情** | 个股实时价、指数实时行情、跨市场行情 |
| **K线** | 日线、分钟线、指数 K线 |
| **涨停与异动** | 涨停板、涨跌停统计、涨跌排行、板块异动、个股异动 |
| **资金与筹码** | 资金流向、盘口资金、筹码分析、市场情绪 |
| **资金面** | 融资融券、沪深港通（北向资金）、大宗交易 |
| **题材与榜单** | 龙虎榜、板块行情、热门主题与关联证券 |
| **公司数据** | 财务与业绩、研报公告、个股诊断、F10 资料 |
| **基础工具** | 交易日历、证券搜索 |
完整字段和调用方式见 `docs/`。
---
## 和其他方案比，它解决什么问题
A股 Level-2 行情数据（逐笔成交、逐笔委托、十档盘口）的常见获取方式：
| 方式 | 门槛 |
|---|---|
| 免费开源库（akshare、mootdx 等） | 通常只有 Level-1 行情，拿不到 Level-2 逐笔与十档 |
| 券商 QMT / PTrade | 需**开通证券账户**并满足资产门槛，通常是几十万级别 |
| 行情 API 服务商 | 多为纯接口，按月或按标的计费 |
| **达塔接口** | **不用开户、不用满足资产门槛**，装客户端即可用 |
**不需要开证券账户、不需要满足资产要求**，是它和券商免费通道最主要的区别；
对只想拿数据、不想为数据去开户的人来说，这是更短的一条路。
也需要说清楚边界：它是**行情数据客户端**，只提供数据，**不含交易下单功能**。
如果你要的是实盘交易接口，券商通道更合适。
---
## 怎么拿到
 [code] 
安装包（Windows zip / macOS dmg / Linux tar.gz）在官网与 GitHub Pages 镜像站提供。
### 授权与版本
客户端需授权后使用。不同版本覆盖的数据范围不同，**当前版本与报价以官网说明
为准： **
本仓库不涉及授权的发放，也不受理购买。
> **只运行客户端无法创建账号。** 账号注册、登录和授权校验都需要能访问授权
> 服务。纯内网、离线或无法访问外网的环境下，客户端登录注册不了，也无法激活。
> 部署前请先确认所在网络能正常访问外网。
### 无界面服务器 / AI Agent
服务器、云主机、没有浏览器的环境不需要点界面。客户端提供本机接口，程序按
固定流程调用即可：
 [code] 
需要激活时注入卡密，然后启动：
 [code] 
用完清理：
 [code] 
完整流程见 `docs/无界面服务器与AI自动化操作.md`。
---
## 接口文档
客户端启动后在本机提供服务，程序通过它取数。文档按数据族划分：
| 文档 | 协议 | 内容 |
|---|---|---|
| D1 HTTP 接口 | HTTP | 资讯、快讯、榜单、F10 等基础数据 |
| D2 HTTP 接口 | HTTP | 行情与统计类数据 |
| D3 HTTP 接口 | HTTP | 数据类接口 |
| D4 HTTP 接口 | HTTP | 数据类接口 |
| D6 市场接口 | HTTP | 行情、K 线、资金、板块、涨跌、公告、研报 |
| D101 实时接口 | WebSocket | 实时行情推送 |
| D201 实时接口 | WebSocket | Level-2 逐笔 |
| D202 实时接口 | WebSocket | 快照 / 竞价 |
| D101 字段表 | — | 字段含义对照 |
使用指南：
- 三平台安装启动与自测
- 无界面服务器与 AI 自动化操作
---
## 示例代码
`examples/` 下的脚本**只依赖 Python 标准库**，不需要装第三方包。
 [code] 
另有各数据族的图形工作台示例（`d1_gui.py`、`d6_gui.py`、`d201_gui.py` 等）
和落盘脚本（`d201_l2_csv.py`、`d202_snapshot_auction.py`）。
---
## 常见问题
**Q：必须装客户端才能用吗？**
是的。接口都在本机运行的客户端里，需要先安装客户端、登录并完成授权，才能取数。
下载地址见 （镜像站
 ）。
**Q：授权在哪里获取？**
授权由官网提供，本仓库不提供、也不受理。打开
 获取；新用户可先在官网了解试用方式。
**Q：各版本有什么区别、怎么收费？**
版本覆盖的数据范围与当前报价，以官网说明为准：
 。价格会调整，本仓库不记录具体金额。
**Q：内网 / 离线机器能登录吗？**
不能。账号注册、登录和授权都需要访问授权服务，请先确认网络能正常访问外网。
**Q：取行情数据需要自己找数据源吗？**
不需要。客户端封装好了数据获取，你只需要写程序调用接口。
**Q：服务器上没有浏览器能用吗？**
能。无界面环境全程走本机接口，见
无界面服务器与AI自动化操作。
**Q：一台机器只能跑一个客户端