tdx-api

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

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

感谢源作者 injoyai，请支持原作者！

✨ 功能特性

🚀 快速开始

方式一：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文档: 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配置已使用国内镜像源，加速构建：

常用命令

docker-compose up -d       # 启动服务
docker-compose logs -f     # 查看日志
docker-compose stop        # 停止服务
docker-compose restart     # 重启服务
docker-compose down        # 完全清理

详细部署文档: DOCKER_DEPLOY.md

📊 支持的数据类型

📁 项目结构

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/                  # 文档

� 相关资源

通达信服务器

系统自动连接最快的服务器：

⚠️ 免责声明

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

📄 许可证

MIT License - 详见 LICENSE

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