基于通达信协议的股票数据获取库 + Web可视化界面 + RESTful API
感谢源作者 injoyai，请支持原作者！
| 分类 | 功能 |
|---|---|
| 📊 核心功能 | 实时行情（五档盘口）、K线数据（10种周期）、分时数据、股票搜索、批量查询 |
| 🌐 Web界面 | 现代化UI、ECharts图表、智能搜索、实时刷新 |
| 🔌 RESTful API | 32个接口、完整文档、多语言示例、高性能 |
| 🐳 Docker部署 | 开箱即用、国内镜像加速、跨平台支持 |
# 克隆项目
git clone https://github.com/oficcejo/tdx-api.git
cd tdx-api
# 启动服务（已配置国内镜像加速）
docker-compose up -d
# 访问 http://localhost:8080一键启动脚本：
- Windows: 双击
docker-start.bat - Linux/Mac:
chmod +x docker-start.sh && ./docker-start.sh
# 前置要求: Go 1.22+
# 1. 下载依赖
go mod download
# 2. 进入web目录并运行
cd web
go run .
# 3. 访问 http://localhost:8080
⚠️ 注意: 必须使用go run .编译所有Go文件，不能使用go run server.go
| 接口 | 说明 | 示例 |
|---|---|---|
/api/quote |
五档行情 | ?code=000001 |
/api/kline |
K线数据 | ?code=000001&type=day |
/api/minute |
分时数据 | ?code=000001 |
/api/trade |
分时成交 | ?code=000001 |
/api/search |
搜索股票 | ?keyword=平安 |
/api/stock-info |
综合信息 | ?code=000001 |
| 接口 | 说明 |
|---|---|
/api/codes |
获取股票代码列表 |
/api/batch-quote |
批量获取行情 |
/api/kline-history |
历史K线数据 |
/api/kline-all |
完整K线数据 |
/api/kline-all/tdx |
TDX源K线数据 |
/api/kline-all/ths |
同花顺源K线数据（含前复权） |
/api/index |
指数数据 |
/api/index/all |
全部指数数据 |
/api/market-stats |
市场统计 |
/api/market-count |
市场数量统计 |
/api/stock-codes |
股票代码 |
/api/etf-codes |
ETF代码 |
/api/etf |
ETF列表 |
/api/trade-history |
历史成交 |
/api/trade-history/full |
完整历史成交 |
/api/minute-trade-all |
全部分时成交 |
/api/workday |
交易日查询 |
/api/workday/range |
交易日范围 |
/api/income |
收益数据 |
/api/tasks/pull-kline |
创建K线拉取任务 |
/api/tasks/pull-trade |
创建成交拉取任务 |
/api/tasks |
任务列表 |
/api/server-status |
服务器状态 |
/api/health |
健康检查 |
完整API文档: API_接口文档.md
# 获取实时行情
curl "http://localhost:8080/api/quote?code=000001"
# 获取日K线
curl "http://localhost:8080/api/kline?code=000001&type=day"
# 搜索股票
curl "http://localhost:8080/api/search?keyword=平安"
# 健康检查
curl "http://localhost:8080/api/health"import "github.com/injoyai/tdx"
// 连接服务器
c, _ := tdx.DialDefault(tdx.WithDebug(false))
// 获取行情
quotes, _ := c.GetQuote("000001", "600519")
// 获取日K线
kline, _ := c.GetKlineDayAll("000001")Docker配置已使用国内镜像源，加速构建：
| 组件 | 镜像源 |
|---|---|
| Go基础镜像 | registry.cn-hangzhou.aliyuncs.com/library/golang |
| Alpine镜像 | registry.cn-hangzhou.aliyuncs.com/library/alpine |
| Alpine APK | mirrors.aliyun.com |
| Go Proxy | goproxy.cn + mirrors.aliyun.com/goproxy |
docker-compose up -d # 启动服务
docker-compose logs -f # 查看日志
docker-compose stop # 停止服务
docker-compose restart # 重启服务
docker-compose down # 完全清理详细部署文档: DOCKER_DEPLOY.md
| 数据类型 | 方法 | 说明 |
|---|---|---|
| 五档行情 | GetQuote |
实时买卖五档、最新价、成交量 |
| 1/5/15/30/60分钟K线 | GetKlineXXXAll |
分钟级K线数据 |
| 日/周/月K线 | GetKlineDayAll 等 |
中长期K线数据 |
| 分时数据 | GetMinute |
当日每分钟价格 |
| 分时成交 | GetTrade |
逐笔成交记录 |
| 股票列表 | GetCodeAll |
全市场代码 |
tdx-api/
├── client.go # TDX客户端核心
├── protocol/ # 通达信协议实现
├── web/ # Web应用
│ ├── server.go # 主服务器
│ ├── server_api_extended.go # 扩展API
│ ├── tasks.go # 任务管理
│ └── static/ # 前端文件
├── extend/ # 扩展功能
├── Dockerfile # Docker镜像（国内源）
├── docker-compose.yml # Docker编排
└── docs/ # 文档
| 资源 | 链接 |
|---|---|
| 原项目 | injoyai/tdx |
| API文档 | API_接口文档.md |
| Docker部署 | DOCKER_DEPLOY.md |
| Python示例 | API_使用示例.py |
系统自动连接最快的服务器：
| IP | 地区 |
|---|---|
| 124.71.187.122 | 上海(华为) |
| 122.51.120.217 | 上海(腾讯) |
| 121.36.54.217 | 北京(华为) |
| 124.71.85.110 | 广州(华为) |
- 本项目仅供学习和研究使用
- 数据来源于通达信公共服务器，可能存在延迟
- 不构成任何投资建议，投资有风险
MIT License - 详见 LICENSE
如果这个项目对您有帮助，请点个 Star ⭐ 支持一下！