8000 GitHub - injoyai/tdx: 通达信的协议解析,用于获取股票信息 · GitHub
[go: up one dir, main page]

Skip to content
injoyaiPublic

About

通达信的协议解析,用于获取股票信息

Resources

Stars

823 stars

Watchers

16 watching

Forks

Latest commit

 

History

517 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📈 通达信协议解析

Go Version

License


公开行为、兼容影响和适配验收见扩展公开契约。

📚 参考资源


🛠 功能列表 & 完成情况

功能 状态 主要方法
盘口(5档报价) ✅ 已完成 GetQuote
代码数量/列表 ✅ 已完成 GetCount GetCode GetCodeAll
分时图 / 历史分时图 ✅ 已完成 GetMinute GetHistoryMinute
分时成交 / 历史分时成交 ✅ 已完成 GetTrade GetHistoryTrade
K线 / 历史K线 / 指数 ✅ 已完成 GetKline*(自动识别指数)
股本变迁(除权除息) ✅ 已完成 GetGbbq GetGbbqAll
前/后复权(对齐通达信) ✅ 已完成 metadata.Gbbq.QFQ HFQ GetFactors
集合竞价 ✅ 已完成 GetCallAuction
财务信息 ✅ 已完成 GetFinanceInfo
F10 公司资料 ✅ 已完成 GetCompanyCategory GetCompanyContent
板块成分(地域/概念/指数) ✅ 已完成 GetBlockData GetBlockDataWithIndex
大型指数成分(中证2000等) ✅ 已完成 GetSpBlock
行业归属(通达信/申万) ✅ 已完成 GetTdxHy
报表/配置文件下载 ✅ 已完成 GetReportFile GetZHBFiles
板块指数代码(id)映射 ✅ 已完成 GetTdxZs GetTdxBk
个股统计 / 资金流向 ✅ 已完成 GetTdxStat GetTdxStat2
新股申购 ✅ 已完成 GetXgsg
扩展行情(期货/港股/外盘) ✅ 已完成 GetQuote GetKline GetTrade 等

🚀 快速开始

保留 5 个典型示例,见 examples:实时报价、代码列表、跨市场 K 线、复权和拉取落库。

日志使用标准库 log/slog,支持应用统一配置或通过 WithLogger 为连接单独设置,见 日志说明。

扩展功能按职责分包:本地文件使用 extend/local,CSV 导出使用 extend/export,行情拉取及历史分笔下载使用 extend/pull,第三方数据源使用 extend/spider,HTTP 缓存客户端使用 extend/metadata/httpclient,HTTP 服务使用 extend/httpserver。直接导入职责子包,详见 包职责说明。

跨市场行情可只创建一个业务对象,自动路由标准和扩展连接:

c := tdx.NewClient(tdx.WithRedial(false)) // 首次查询才联网
defer c.Close()

a, err := c.GetKlineDay("sz000001", 0, 100)
if err != nil { panic(err) }
h, err := c.GetKlineDay("hk00700", 0, 100)
if err != nil { panic(err) }
f, err := c.GetKlineDay("cffIF2609", 0, 100)
if err != nil { panic(err) }
_ = a; _ = h; _ = f

NewClient() 返回统一业务接口 Client(默认实现为 *MarketClient),内部按市场路由到实现同一接口的 StConn / ExConn,统一报价、K 线、分时、分笔、代码列表和市场数量,并提供标准财务、F10、除权及报表入口。返回价格使用品种原币种/报价单位,成交量及五档买卖量使用最小单位(股票为股、期货为张),不再返回 VolumeUnit;国内未校准项按用户指定默认倍率100,境外无法确认成交数量的接口明确报错。使用方法和支持边界见 统一 Client,可运行示例见 GetKline。标准 Dial* 返回 *StConn,DialEx* 返回 *ExConn,两者均实现 Client;连接池使用 Client,通用传输仅在内部复用;其基础行情、K线便捷方法、完整分笔与代码查询已统一为同名 Get*,原 Ex* 替换及返回类型变化见迁移指南。

extend/pull 的 FetchCodes、FetchGbbq、FetchWorkdays 获取并校验元数据快照,UpdateContext 同步行情。只获取元数据时传入连接池即可;行情同步另需 BarStore。元数据由应用按需持久化,服务不自动建连或启动定时任务。

metadata 集中提供 Codes、Gbbq、Workday 三个独立的纯内存查询对象,构造时接收记录,不执行 I/O,不需要 Close。manage 已删除,应用负责组件组装、任务安排和资源关闭。共享业务模型位于 extend/model,设计与数据边界见架构说明。

可停止定时工具位于 lib/update,应用可以选择使用。行情完成标记统一由 storage.BarStore 保存,SQLite 实现位于 storage/sqlite。

当前 Go 模块为 github.com/injoyai/tdx/v2。从 v1 升级时,调用方需要将根包和所有子包的 import 路径同步改为 /v2 路径,例如 github.com/injoyai/tdx/v2/protocol。包名仍为 tdx,源码继续放在仓库根目录。参见 Go 主版本升级规则。

v2 已统一成交、60 分钟 K 线和行情拉取接口,并移除北交所官网取码入口。主模块使用 XORM,SQLite 实现在 storage/sqlite 单独包中,随 tdx 一起发布;不提供 MySQL 实现,其他行情后端由用户实现 BarStore。storage/sqlite.New(dir) 可注入 pull.Config.Store;元数据通过具体方法由应用显式保存;纯查询包只接收数据。见 存储接口说明。旧接口替换方式及存量数据库说明见 v2 迁移指南。

行情时间保留源精度:日及更长周期返回日期,日内周期返回日期时分,不返回 TimeZone 或 Unix 时间戳。pull 使用源时间主键和新数据目录,不兼容旧 Unix 主键库,详见 源时间与存储说明。

package main

import (
	"fmt"
	"github.com/injoyai/tdx/v2"
)

func main() {
	// 连接服务器,输出连接日志,支持断线重连
	c, err := tdx.Dial("124.71.187.122:7709", tdx.WithDebug(), tdx.WithRedial())
	if err != nil {
		panic(err)
	}

	// 获取行情
	resp, err := c.GetQuote("sz000001", "sh600008")
	if err != nil {
		panic(err)
	}

	for _, v := range resp {
		fmt.Printf("%#v\n", v)
	}

	<-c.Done()
}

📦 板块与板块指数代码(id)

板块成分文件(block_*.dat)本身不含板块指数代码(id),id 映射在 tdxzs.cfg(全称),而成分文件用简称,二者经 tdxbk.cfg(简称↔全称) 桥接。GetBlockDataWithIndex 自动完成关联(命中率约 100%)。

c, _ := tdx.DialDefault()
defer c.Close()

// 板块成分 + 板块指数代码(id)。file 可选: protocol.BlockFileGN(概念)/FG(地域风格)/ZS(指数)
blocks, _ := c.GetBlockDataWithIndex(protocol.BlockFileGN)
for _, b := range blocks {
	fmt.Printf("板块=%s id=%s 类型=%d 成分数=%d\n", b.Name, b.Index, b.Type, len(b.Codes))
}

// 仅成分(无 id, 不额外下载 zhb.zip)
plain, _ := c.GetBlockData(protocol.BlockFileGN)
_ = plain

大型指数成分(中证2000/1000/500/A500/国证2000)

block_zs.dat 单板块成分上限 400,装不下中证2000/1000/500 等大型指数,服务端把它们放在文本文件 spblock.dat(无上限),用 GetSpBlock 获取。

沪深300 例外:仍在 block_zs.dat,用 GetBlockData(protocol.BlockFileZS) 取(成分 300)。

// 专业板块: 中证2000/中证1000/中证500/中证A500/国证2000/深证成指 等
sp, _ := c.GetSpBlock()
for _, b := range sp {
	fmt.Printf("板块=%s 成分数=%d\n", b.Name, len(b.Codes)) // Codes 7字符: 市场(0深/1沪/2北)+代码
}

// 按名取中证2000成分
if b := protocol.SpBlockByName(sp, "中证2000"); b != nil {
	fmt.Printf("中证2000 成分数=%d\n", len(b.Codes)) // 2000
}

🔁 复权日线 (前复权 / 后复权, 对齐通达信)

复权基于股本变迁(gbbq)的除权除息事件做仿射变换 price_adj = QFQMul × price_raw + QFQAdd, 结果四舍五入到分(2 位小数),与电脑端通达信桌面端逐日对齐(含配股、大比例送转、股改停牌复合事件均已实盘核验)。 成交量/额不复权。metadata 提供基于已有事件的内存查询与复权计算,使用时导入 github.com/injoyai/tdx/v2/extend/metadata。

// backend、ctx、c 由应用创建;事件经 pull.FetchGbbq 获取后由应用显式保存。
snapshot, err := backend.LoadGbbq(ctx, []string{"sh600519"})
if err != nil { return err }
gb, err := metadata.NewGbbq(snapshot.Rows)
if err != nil { return err }
resp, err := c.GetKlineDayAll("sh600519")
if err != nil { return err }
ks, err := resp.Klines() // 将统一股数转换为指标/本地文件使用的整数手
if err != nil { return err }
qfq := gb.QFQ("sh600519", ks)
hfq := gb.HFQ("sh600519", ks)
_ = qfq
_ = hfq
fs := gb.GetFactors("sh600519", ks)
for _, f := range fs {
    _ = f.QFQPrice(100)
}

行情价格统一使用 float64,标准协议模型的价格及成交额单位为元;跨市场业务结果使用证券原币种/报价单位,不做汇率换算。协议和文件中的整数尺度仅在读写边界转换。旧 protocol.Price、Yuan 及价格转换方法已移除,详见 价格迁移说明。 完整演示见 GetQFQKline。


🏢 财务 / F10 公司资料 / 行业归属

c, _ := tdx.DialDefault()
defer c.Close()

code := "sh600000"
// 财务/基本面: 流通股本/总股本/上市日期/股东户数/净利润等
if fi, err := c.GetFinanceInfo(code); err == nil {
    fmt.Println(fi.LiuTongGuBen, fi.ZongGuBen, fi.GuDongRenShu, fi.JingLiRun)
}

// F10 公司资料: 先取分类, 再读正文
if cats, err := c.GetCompanyCategory(code); err == nil && len(cats) > 0 {
    cat := cats[0]
    content, _ := c.GetCompanyContent(code, cat.Filename, cat.Start, cat.Length)
    _ = content
}

// 行业归属(通达信新行业 T + 申万行业 X), 全市场
hy, _ := c.GetTdxHy()
for _, v := range hy { _ = v.TdxHy; _ = v.SwHy }

🗄 报表/配置数据 (zhb.zip)

通达信板块/配置文件以 zhb.zip 总包经 report file 协议(0x06B9)整体下发,含 44 个文件(tdxzs.cfg/tdxbk.cfg/incon.dat/tdxstat.cfg 等)。

// 任意报表文件原始字节(无需预查大小, 自动分块拉取)
raw, _ := c.GetReportFile("zhb.zip")

// 下载 zhb.zip 并解压 → 文件名→原始字节
files, _ := c.GetZHBFiles()
for name := range files { fmt.Println(name) }

// 板块名↔指数代码(id)   /   概念简称↔全称
zs, _ := c.GetTdxZs()   // []*protocol.TdxZs{Name, Code(880xxx), Type, ...}
bk, _ := c.GetTdxBk()   // []*protocol.TdxBk{Short, Full}
_ = zs; _ = bk

📊 个股统计 / 资金流向 / 新股申购

来自 zhb.zip 的全市场逐股数据。tdxstat.cfg 字段经 10 只大市值股对照实盘核验(见 protocol/model_stat.go 命中率注释),未核验字段保留在 Fields。

// 个股综合统计: 市盈TTM/静态市盈/股息率/涨跌幅/连涨连跌天数/区间涨跌幅(5/10/20/60日/YTD, 均已核验)
stat, _ := c.GetTdxStat()
for _, s := range stat {
	fmt.Printf("%s PE_TTM=%.2f 静PE=%.2f 股息=%.2f%% 连涨跌=%d 5日=%.2f%% 20日=%.2f%% YTD=%.2f%%\n",
		s.Code, s.PETTM, s.PEStatic, s.DivYield, s.TrendDays, s.Chg5, s.Chg20, s.ChgYTD)
}

// 资金流向 + 板块归属(股→板块id 反向映射)
stat2, _ := c.GetTdxStat2()
s2b := protocol.StockBlockIndex(stat2) // map[证券代码]板块指数代码
_ = s2b

// 新股申购
xgsg, _ := c.GetXgsg()
for _, x := range xgsg {
	fmt.Printf("%s %s 申购日=%s 发行价=%.3f\n", x.Code, x.Name, x.Date, x.IssuePrice)
}

🌍 扩展行情 TdxExHq (期货 / 港股 / 外盘, 端口 7727)

扩展行情走独立服务(端口 7727)。NewClient() 自动管理两类连接;DialEx* 返回绑定扩展协议的单连接,业务查询同样使用 Get*。

ex, err := tdx.DialExDefault() // 或 DialEx(addr) / DialExHosts(hosts)
if err != nil { panic(err) }
defer ex.Close()

markets, _ := ex.GetMarkets()                       // 市场代码表
n, _ := ex.GetCount(protocol.ExchangeHK)                               // 指定市场品种数量
insts, _ := ex.GetCode(protocol.ExchangeHK, 0, 100)               // 指定市场代码分页
q, _ := ex.GetQuote("hk00700")                   // 单品种五档行情
bars, _ := ex.GetKline(protocol.TypeKlineDay, "hk00700", 0, 20) // K线
ticks, _ := ex.GetTrade("hk00700", 0, 30)        // 分笔成交
rangeBars, _ := ex.GetKlineRange("hk00700", "20261009", "20261009") // 一分钟区间
_ = markets; _ = n; _ = insts; _ = q; _ = bars; _ = ticks; _ = rangeBars

🌐 服务器列表 (端口 7709)

Hosts、ExHosts 及地域子列表使用 Addrs(底层为 []string),统一存储 IP:端口,可直接传给 NewHostDial、NewRandomDial 或 NewRangeDial,无需再拼接端口。通用 New*Dial 只使用传入的完整地址,空列表报错,不自动选择默认地址;每个地址的建连超时为 5 秒。协议入口仍兼容裸 IPv4/IPv6:Dial / DialHosts* 默认补 7709,DialEx / DialExHosts 默认补 7727;空标准/扩展列表分别使用 Hosts / ExHosts。完整 IPv6 地址使用 [IPv6]:端口。

Addrs.Sort(timeout...) 对地址列表进行 TCP 测速,按连接耗时返回新的 Addrs,不修改输入或默认列表。标准行情使用 tdx.Hosts.Sort(),扩展行情使用 tdx.ExHosts.Sort();自定义列表使用 tdx.Addrs(hosts).Sort()。需要更新默认列表时显式赋值,例如 tdx.Hosts = tdx.Hosts.Sort()。地址须包含端口,空输入返回空列表;超时是整轮测速的时间上限(默认一秒)。测速仅检查 TCP 建连,不验证行情协议。

最近测试时间:2026-10-13 16:54–16:55(北京时间),标准行情 41 个地址、扩展行情 16 个地址均通过 TCP 连通性测试;尚未验证行情握手和查询。

🏙 上海

IP 测试时间 运营商 结果
124.71.187.122 2026-10-13 华为 ✅️
122.51.120.217 2026-10-13 腾讯 ✅️
111.229.247.189 2026-10-13 腾讯 ✅️
122.51.232.182 2026-10-13 腾讯 ✅️
118.25.98.114 2026-10-13 腾讯 ✅️
124.70.199.56 2026-10-13 华为 ✅️
121.36.225.169 2026-10-13 华为 ✅️
123.60.70.228 2026-10-13 华为 ✅️
123.60.73.44 2026-10-13 华为 ✅️
124.70.133.119 2026-10-13 华为 ✅️
124.71.187.72 2026-10-13 华为 ✅️
123.60.84.66 2026-10-13 华为 ✅️
124.223.163.242 2026-10-13 腾讯云 ✅️
150.158.160.2 2026-10-13 腾讯云 ✅️
101.35.121.35 2026-10-13 腾讯云 ✅️
111.231.113.208 2026-10-13 腾讯云 ✅️

🏙 北京

IP 测试时间 运营商 结果
62.234.50.143 2026-10-13 腾讯云 ✅️
81.70.151.186 2026-10-13 腾讯云 ✅️
101.42.240.54 2026-10-13 腾讯云 ✅️
101.43.159.194 2026-10-13 腾讯云 ✅️
120.53.8.251 2026-10-13 腾讯云 ✅️
152.136.191.169 2026-10-13 腾讯云 ✅️
49.232.15.141 2026-10-13 腾讯云 ✅️
82.156.174.84 2026-10-13 腾讯云 ✅️
101.42.164.241 2026-10-13 腾讯云 ✅️

🏙 广州

IP 测试时间 运营商 结果
124.71.9.153" 2026-10-13 华为 ✅️
116.205.163.254" 2026-10-13 华为 ✅️
116.205.171.132" 2026-10-13 华为 ✅️
116.205.183.150" 2026-10-13 华为 ✅️
111.230.186.52" 2026-10-13 腾讯 ✅️
110.41.2.72" 2026-10-13 华为 ✅️
110.41.147.114" 2026-10-13 华为 ✅️
101.33.225.16" 2026-10-13 腾讯云 ✅️
175.178.112.197" 2026-10-13 腾讯云 ✅️
175.178.128.227" 2026-10-13 腾讯云 ✅️
43.139.95.83" 2026-10-13 腾讯云 ✅️
159.75.29.111" 2026-10-13 腾讯云 ✅️
43.139.18.171" 2026-10-13 腾讯云 ✅️
81.71.32.47" 2026-10-13 腾讯云 ✅️
129.204.230.128" 2026-10-13 腾讯云 ✅️

🏙 武汉

IP 测试时间 运营商 结果
119.97.185.59 2026-10-13 电信 ✅️

⚠️ 免责声明

  1. 本项目仅供 学习、研究和技术交流 使用,禁止用于任何商业或非法用途。
  2. 使用本项目产生的任何数据、损失或法律责任,作者 不承担任何责任。
  3. 对第三方服务器或服务的访问,用户需自行遵守相关法律法规及服务协议。
  4. 请勿将本项目用于侵犯他人权益或违反监管规定的行为。

📄 许可证

MIT License - 详见 LICENSE

⭐ 喜欢这个项目吗?点个 Star 支持一下吧!

验证

默认测试使用离线样本,覆盖协议解析、指标、导出与拉取存储:

go test ./...

根包内部测试与源码同目录,按客户端、连接、查询、拨号和连接池归并;只依赖公开接口的跨包契约、元数据资源归属及数据一致性测试集中在 tests/integration/。go test . 仅运行根包测试,go test ./... 会包含跨包测试。

爬虫和扩展行情的实连测试需显式启用:

TDX_SPIDER_LIVE=1 go test ./extend/spider -run '^Test(GetSinaFactor.*|NewSpiderTHS)$'
TDX_EXHQ_LIVE=1 go test . -run '^TestExLive$'

迁移存储配置或缓存目录前,请查看 v2 迁移指南。源码与维护入口见 目录说明。

About

通达信的协议解析,用于获取股票信息

Resources

Stars

823 stars

Watchers

16 watching

Forks

Releases

Packages

Used by

Contributors

Languages

0