数字货币对接教程
数字货币交易是本系统中最简单的对接方式 —— 不需要中继客户端，AI 输出的交易信号通过交易所 API 直接下单，全程毫秒级响应，7×24 小时运行。
适用场景
BTC、ETH 等数字货币的现货和合约交易。支持做多、做空、杠杆。
为什么数字货币不需要中继客户端
股票和外汇交易需要通过桌面软件（通达信 / QMT / MT5）下单，因此需要中继客户端作为桥梁操控这些软件。而数字货币交易所都提供标准化的 API 接口，聚合 SaaS 系统可以直接调用交易所 API 完成下单，无需安装任何桌面交易软件和中继客户端。
| 对比项 | 数字货币 | 股票外汇 |
|---|---|---|
| 下单方式 | 交易所 API 直连 | 中继客户端操控桌面软件 |
| 是否需要中继客户端 | ❌ 不需要 | ✅ 需要 |
| 是否需要安装桌面软件 | ❌ 不需要 | ✅ 需要 |
| 交易时间 | 7×24 小时不间断 | 有交易时段限制 |
| 执行速度 | 毫秒级（API 直连） | 较慢（软件操控） |
| 做空 | ✅ 支持（合约） | A 股不支持 |
工作原理
AI 交易信号直接通过交易所 API 下单，无需中继客户端：
下行：AI 输出交易信号 → 直接调用交易所 API 执行下单 上行：交易所返回成交结果和账户状态 → AI 直接接收
支持的交易所
目前已集成以下交易所，均通过 API 直连：
| 交易所 | 官网 | 说明 |
|---|---|---|
| 币安 Binance | binance.com | 全球交易量最大的数字货币交易所 |
| 欧易 OKX | okx.com | 国内用户使用广泛的交易所 |
| DeepCoin | deepcoin.com | 支持多种交易对 |
| Gate | gate.io | 老牌交易所，币种丰富 |
| BitGet | bitget.com | 跟单交易特色 |
选择交易所
如果你还没有交易所账号，推荐选择币安或欧易，交易深度好、API 稳定。注册后记得完成身份认证（KYC）才能创建 API Key。
交易所注册（推荐链接）
通过以下推荐链接注册，不仅能获得我们系统的配套支持，还能享受 最高 50% 的返佣回馈！
- ✅ 真实返佣，长期有效
- ✅ 注册即享，自动到账
- ✅ 同时绑定系统服务和专属支持
深币 DeepCoin（推荐）
- 🪙 返佣比例：50%，注册后联系客服发送账号 ID 确认返佣比例是否正确
- 📎 注册链接：https://s.deepcoin.life/sgabhfg
- 或填写邀请码：
S601756
Bitget
- 🪙 返佣比例：20%，注册后联系客服发送账号 ID 确认返佣比例是否正确
- 📎 注册链接：https://partner.niftah.cn/bg/dacheng88
- 或填写邀请码：
dacheng88
欧易 OKX
- 🪙 返佣说明：目前暂未开启返佣，欢迎通过以下链接注册。一旦谈妥返佣合作，将立即给大家同步返还！
- 📎 注册链接：https://ouxyi.link/ul/YbU25D?channelId=47605672
- 或填写邀请码：
47605672
Gate
- 🪙 返佣比例：20%，如需要更改请联系我调整
- 📎 注册链接：https://www.gatewebsite.app/share/JHCKXKFR
前置条件
请先完成以下准备
- 已注册聚合 SaaS 系统账号 → https://traderai.vip/pc/
- 已在数字货币交易所注册账号并完成身份认证
- 已下载 data-feeder 采集客户端 → GitHub / Gitee
第一步：在交易所创建 API Key
以币安 Binance为例，其他交易所操作类似。
1.1 进入 API 管理页面
- 登录币安官网，点击右上角头像 → 「API 管理」
- 进入 API 管理页面
其他交易所的 API 管理入口
- 欧易 OKX：头像 → API → 创建 API Key
- Gate：头像 → API Keys → 创建 API Key
- BitGet：头像 → API → 创建 API
1.2 创建 API Key
- 点击**「创建 API」**按钮
- 按提示完成安全验证（邮箱验证码、手机验证码、Google 验证码）
- 在权限设置中，按以下要求配置：
| 权限 | 是否需要 | 说明 |
|---|---|---|
| 读取 | ✅ 需要 | 查询账户余额和持仓 |
| 交易 | ✅ 需要 | 下单、撤单、修改订单 |
| 提现 | ❌ 不要勾选 | 严禁开启提现权限，安全第一 |
⚠️ 安全警告
- 绝对不要开启提现权限，只开启「读取」和「交易」权限
- API Key 和 Secret Key 务必妥善保管，泄露后立即删除重建
- 建议在 API 设置中绑定服务器 IP，限制只有你的服务器可以调用
1.3 保存 API Key 和 Secret Key
创建成功后，系统会显示：
- API Key（以
xxx...xxx格式显示） - Secret Key（只显示一次，务必立即保存）
⚠️ Secret Key 只显示一次
Secret Key 在创建时只显示一次，关闭页面后无法再次查看。如果丢失，只能删除该 API Key 重新创建。
第二步：在聚合 SaaS 系统中配置交易所账号
2.1 登录聚合 SaaS 系统
- 打开 https://traderai.vip/pc/
- 输入账号密码登录
2.2 添加交易所账号
- 在左侧导航栏中，找到**「交易所账号」或「交易管理」**相关菜单
- 点击**「添加交易所账号」**
- 按要求填写：
| 字段 | 填写内容 |
|---|---|
| 交易所 | 选择你使用的交易所（如币安、欧易等） |
| API Key | 填入第一步创建的 API Key |
| Secret Key | 填入第一步创建的 Secret Key |
| 交易模式 | 选择现货或合约（根据你的交易需求） |
- 保存配置
API Key 获取方式
如果你不知道如何获取 API Key，请参考：PC 端获取 API Key / 手机端获取 API Key
关于 API Key 的说明
这里的 API Key 是交易所的 API Key，用于聚合 SaaS 系统调用交易所接口下单。与 data-feeder 采集客户端使用的 API Key（聚合 SaaS 系统的访问密钥）是两个不同的东西：
- 交易所 API Key：用于交易下单（本步配置）
- 聚合 SaaS 系统 API Key：用于 data-feeder 数据采集（下一步配置）
第三步：配置数据源采集客户端（data-feeder）
数字货币交易依赖数据源提供市场数据，需要运行 data-feeder 采集 TradingView 指标数据。
3.1 获取聚合 SaaS 系统 API Key
参考 PC 端获取 API Key 或 手机端获取 API Key，获取聚合 SaaS 系统的访问密钥。
3.2 下载并配置 data-feeder
详细操作请参考 数据源配置指南，核心步骤如下：
# 1. 下载项目
git clone https://gitee.com/xibusuper/data-feeder.git
cd data-feeder
# 2. 安装依赖
npm install
# 3. 配置
cp .env.example .env
编辑 .env 文件：
# 聚合 SaaS 系统地址
API_URL=https://traderai.vip
# 聚合 SaaS 系统的 API Key（不是交易所的）
API_KEY=你的聚合SaaS系统API Key
# 数据源 ID（在聚合 SaaS 系统中创建的数据源订阅 ID）
TV_DATA_ID=你的数据源ID
3.3 启动采集
# 正常启动
node clients/tv-indicator.js
# 调试模式（查看详细日志）
node clients/tv-indicator.js -d
启动成功后会看到：
客户端连接成功!
指标准备就绪!
等待5分钟K线收盘...
data-feeder 必须保持运行
data-feeder 负责实时采集 TradingView 指标数据，是 AI 分析的"眼睛"。如果 data-feeder 停止运行，AI 将无法获取最新市场数据，也就无法输出交易信号。建议使用 Docker 方式部署，实现自动重启。详见 数据源配置指南。
第四步：验证连接
验证清单
| 检查项 | 验证方法 | 预期结果 |
|---|---|---|
| 交易所 API Key 已配置 | 在聚合 SaaS 系统中查看交易所账号 | 显示已绑定，状态正常 |
| data-feeder 已运行 | 查看终端输出 | 显示「客户端连接成功」和「指标准备就绪」 |
| 数据已上报 | 在聚合 SaaS 系统中查看数据源运行记录 | 显示最新的指标数据 |
| AI 分析正常 | 在聚合 SaaS 系统中查看 AI 分析记录 | 显示交易信号输出 |
| 交易执行正常 | 在交易所查看订单记录 | 出现 AI 下发的订单 |
验证流程
- 确认 data-feeder 正在运行并成功采集数据
- 等待一根 K 线收盘，data-feeder 会自动采集并上报数据
- 聚合 SaaS 系统收到数据后，AI 会自动分析并输出交易信号
- 交易信号通过交易所 API 自动执行下单
- 在交易所的订单记录中确认交易已执行
交易信号执行流程
当 AI 输出交易信号时，聚合 SaaS 系统直接调用交易所 API 执行：
| AI 信号 | 系统操作 | 交易所执行动作 |
|---|---|---|
| 开多仓 | 调用买入接口 | 买入指定数量的数字货币 |
| 开空仓 | 调用合约做空接口 | 做空指定数量的数字货币（需合约模式） |
| 平仓 | 调用平仓接口 | 关闭当前持仓 |
| 加仓 | 调用追加买入接口 | 增加持仓数量 |
| 减仓 | 调用部分平仓接口 | 减少持仓数量 |
数字货币交易特点
- 7×24 小时不间断交易：没有开盘收盘时间，随时可以交易
- 支持做空：合约模式下可以做空获利（与 A 股不同）
- T+0 交易：买入后可以立即卖出，没有持仓时间限制
- 高波动性：数字货币价格波动较大，建议合理控制仓位和杠杆
每次执行完成后，系统自动获取：
- 成交价格、成交数量、订单号
- 当前账户余额、可用资金
- 持仓明细（币种、方向、数量、开仓均价、浮盈亏）
常见问题
交易所 API 报错「Invalid Key」
检查聚合 SaaS 系统中配置的 API Key 和 Secret Key 是否正确。如果 Secret Key 丢失，需要在交易所删除旧 Key 重新创建。
API 报错「Insufficient Balance」
账户余额不足，无法完成下单。检查交易所账户中是否有足够的可用资金（现货交易需要足够的 USDT 或对应币种，合约交易需要足够的保证金）。
API 报错「Permission Denied」
API Key 权限不足。确认 API Key 已开启「交易」权限，未开启只有「读取」权限的话无法下单。
data-feeder 采集不到数据
参考 数据源配置指南 — 常见问题 排查。常见原因包括 API Key 错误、TV 凭证过期、数据源 ID 不正确等。
合约交易报错
如果使用合约模式，确认：
- 交易所账号已开通合约交易权限
- 账户中有足够的合约保证金
- 已在聚合 SaaS 系统中选择正确的交易模式和合约类型
如何切换交易所
在聚合 SaaS 系统中删除旧的交易所账号配置，重新添加新的交易所账号即可。data-feeder 不需要修改，它只负责数据采集，与交易所无关。
下一步
配置完成后，回到 系统架构 了解完整的交易闭环流程，或继续配置其他交易软件：