交易机器人

一个支持多个交易所（目前包括 EdgeX 和 Backpack）的模块化交易机器人。该机器人实现了自动下单并在盈利时自动平仓的策略。

邀请链接

EdgeX 交易所

使用我的推荐链接注册：
👉 https://pro.edgex.exchange/referral/QUANT

使用我的 EdgeX 推荐链接，享受以下优惠：

1. 即时 VIP 1 交易费率 – 直接升级到 VIP 1 费率。
2. 10%手续费返佣 – 每 24 小时自动结算，可直接在 EdgeX 网站上领取。
   • 此返佣是在 VIP 1 费率基础上的额外优惠，这意味着您的实际交易费率变为：

     0.013% * 0.9 = 0.0117%
     

3. 10%奖励积分 – 额外积分将记入您的账户。

Backpack 交易所

30%手续费返佣 – 使用我的 Backpack 推荐链接，您将获得所有交易费用的 30% 自动返佣： 👉 https://backpack.exchange/join/quant

安装

1. 克隆仓库：

   git clone <repository-url>
   cd perp-dex-tools

2. 创建并激活虚拟环境：

   python3 -m venv env
   source env/bin/activate  # Windows: env\Scripts\activate

3. 安装依赖：

   pip install -r requirements.txt

4. 设置环境变量： 使用 env_example.txt 在项目根目录创建.env文件。

示例命令：

EdgeX 交易所：

ETH：

python runbot.py --exchange edgex --ticker ETH --quantity 0.1 --take-profit 0.02 --max-orders 40 --wait-time 450

BTC：

python runbot.py --exchange edgex --ticker BTC --quantity 0.05 --take-profit 0.02 --max-orders 40 --wait-time 450

Backpack 交易所：

ETH 永续合约：

python runbot.py --exchange backpack --ticker ETH --quantity 0.1 --take-profit 0.02 --max-orders 40 --wait-time 450

配置

环境变量

EdgeX 配置

• EDGEX_ACCOUNT_ID: 您的 EdgeX 账户 ID
• EDGEX_STARK_PRIVATE_KEY: 您的 EdgeX API 私钥
• EDGEX_BASE_URL: EdgeX API 基础 URL（默认：https://pro.edgex.exchange）
• EDGEX_WS_URL: EdgeX WebSocket URL（默认：wss://quote.edgex.exchange）

Backpack 配置

• BACKPACK_PUBLIC_KEY: 您的 Backpack 公钥
• BACKPACK_SECRET_KEY: 您的 Backpack 私钥（base64 编码）

命令行参数

• --exchange: 使用的交易所：'edgex'或'backpack'（默认：edgex）
• --ticker: 标的资产符号（例如：ETH、BTC、SOL）。合约 ID 自动解析。
• --quantity: 订单数量（默认：0.1）
• --take-profit: 止盈百分比（例如 0.02 表示 0.02%）
• --direction: 交易方向：'buy'或'sell'（默认：buy）
• --max-orders: 最大活跃订单数（默认：40）
• --wait-time: 订单间等待时间（秒）（默认：450）

架构

该机器人采用支持多个交易所的模块化架构：

1. 交易所客户端

EdgeX 客户端（官方 SDK）

• 使用官方 SDK 的 EdgeX REST API 客户端
• 处理身份验证和 API 请求
• 管理订单下单、取消和状态查询
• 获取持仓和账户信息

Backpack 客户端（官方 SDK）

• 使用官方 BPX SDK 的 Backpack REST API 客户端
• 处理身份验证和 API 请求
• 管理订单下单、取消和状态查询
• 获取持仓和账户信息

2. WebSocket 管理器

EdgeX WebSocket 管理器（官方 SDK）

• 使用官方 SDK 的 WebSocket 连接管理
• 实时市场数据流
• 订单更新通知
• 自动连接处理

Backpack WebSocket 管理器

• Backpack 的 WebSocket 连接管理
• 实时订单更新通知
• ED25519 签名身份验证
• 自动连接处理

3. 主交易机器人（runbot.py）

• 核心剥头皮策略逻辑
• 订单下单和监控
• 持仓管理
• 主交易循环
• 多交易所支持

交易策略

该机器人实现了简单的剥头皮策略：

1. 订单下单：在市场价格附近下限价单
2. 订单监控：等待订单成交
3. 平仓订单：在止盈水平自动下平仓单
4. 持仓管理：监控持仓和活跃订单
5. 风险管理：限制最大并发订单数

日志记录

该机器人提供全面的日志记录：

• 交易日志：包含订单详情的 CSV 文件
• 调试日志：带时间戳的详细活动日志
• 控制台输出：实时状态更新
• 错误处理：全面的错误日志记录和处理

安全功能

• 订单限制：可配置的最大订单数量
• 超时处理：超时时自动取消订单
• 持仓监控：持续监控持仓和订单状态
• 错误恢复：优雅处理 API 错误和断开连接

贡献

1. Fork 仓库
2. 创建功能分支
3. 进行更改
4. 如适用，添加测试
5. 提交拉取请求

许可证

本项目采用 MIT 许可证 - 详情请参阅LICENSE文件。

免责声明

本软件仅供教育和研究目的。加密货币交易涉及重大风险，可能导致重大财务损失。使用风险自负，切勿用您无法承受损失的资金进行交易。

支持

相关问题：

• EdgeX API：查看EdgeX API 文档
• EdgeX SDK：查看EdgeX Python SDK 文档
• 此机器人：在此仓库中提交问题