logo
0
0
WeChat Login

📈 TDX通达信股票数据查询系统

基于通达信协议的股票数据获取库 + Web可视化界面 + RESTful API

Go Version Docker License

感谢源作者 injoyai,请支持原作者!


✨ 功能特性

分类功能
📊 核心功能实时行情(五档盘口)、K线数据(10种周期)、分时数据、股票搜索、批量查询
🌐 Web界面现代化UI、ECharts图表、智能搜索、实时刷新
🔌 RESTful API32个接口、完整文档、多语言示例、高性能
🐳 Docker部署开箱即用、国内镜像加速、跨平台支持

🚀 快速开始

方式一: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接口列表

核心接口

接口说明示例
/api/quote五档行情?code=000001
/api/klineK线数据?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/tdxTDX源K线数据
/api/kline-all/ths同花顺源K线数据(含前复权)
/api/index指数数据
/api/index/all全部指数数据
/api/market-stats市场统计
/api/market-count市场数量统计
/api/stock-codes股票代码
/api/etf-codesETF代码
/api/etfETF列表
/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


� 使用示例

API调用

# 获取实时行情
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"

Go库使用

import "github.com/injoyai/tdx"

// 连接服务器
c, _ := tdx.DialDefault(tdx.WithDebug(false))

// 获取行情
quotes, _ := c.GetQuote("000001", "600519")

// 获取日K线
kline, _ := c.GetKlineDayAll("000001")

� Docker配置说明

国内镜像加速

Docker配置已使用国内镜像源,加速构建:

组件镜像源
Go基础镜像registry.cn-hangzhou.aliyuncs.com/library/golang
Alpine镜像registry.cn-hangzhou.aliyuncs.com/library/alpine
Alpine APKmirrors.aliyun.com
Go Proxygoproxy.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广州(华为)

⚠️ 免责声明

  1. 本项目仅供学习和研究使用
  2. 数据来源于通达信公共服务器,可能存在延迟
  3. 不构成任何投资建议,投资有风险

📄 许可证

MIT License - 详见 LICENSE


如果这个项目对您有帮助,请点个 Star ⭐ 支持一下!

About

No description, topics, or website provided.
Language
Go73.6%
Python10.3%
JavaScript7.4%
CSS3.1%
Others5.6%