中文 | English

一个用于跟踪 nof1.ai AI Agent 交易信号并自动执行 Binance 合约交易的命令行工具。支持7个AI量化Agent的实时跟单，自动识别开仓、平仓、换仓和止盈止损信号。

不想自己部署？我们提供代部署服务！

• 🖥️ 无需本地电脑运行 - 服务器24小时自动运行，无需保持自己的电脑开着
• 🌍 无需翻墙 - 推荐的服务器在国外环境，访问Binance API和nof1.ai更稳定
• 🔋 省心省力 - 专业配置，自动运行，无需担心环境配置和网络问题

• 💰 服务器成本低 - 一个服务器月租仅需40元人民币
• 🛠️ 部署服务费面议 - 根据具体需求进行配置和部署

📱 有意者请加微信: gptkit

备注：代部署服务包含完整的环境配置、系统部署、运行测试和使用指导。

# 1. 安装和构建
npm install && npm run build

# 2. 配置环境变量
cp .env.example .env
# 编辑 .env 文件，填入 Binance API 密钥（必须启用合约交易权限）

# 3. 查看可用的AI Agent
npm start -- agents

# 4. 测试Telegram通知（可选）
npm start -- telegram-test

# 5. 开始跟单（风险控制模式，不会真实交易）
npm start -- follow deepseek-chat-v3.1 --risk-only

# 6. 持续监控跟单（每30秒检查一次）
npm start -- follow gpt-5 --interval 30

# 7. 查看盈利统计
npm start -- profit

• 🤖 AI Agent跟单: 支持7个AI量化交易Agent（GPT-5、Gemini、DeepSeek等）
• 📊 实时监控: 可配置轮询间隔，持续跟踪Agent交易动作
• 🔄 智能跟单: 自动识别开仓、平仓、换仓（OID变化）和止盈止损
• 🎯 盈利目标退出: 支持设置自定义盈利目标，达到后自动平仓退出
• 🔄 自动重新跟单: 可选的自动重新跟单功能，支持盈利退出和手工平仓后自动重新入场
• ⚡ 合约交易: 完整支持Binance USDT永续合约，支持1x-125x杠杆
• 📈 盈利统计: 精确的盈利分析，基于真实交易数据计算（含手续费统计）
• 🛡️ 风险控制: 支持--risk-only模式，只观察不执行交易

deepseek-chat-v3.1 Agent 实盘跟踪面板: https://nof1-tracker-dashboard.onrender.com

实时查看 deepseek-chat-v3.1 AI Agent 的交易表现、持仓情况和盈亏统计。

Dashboard项目地址: https://github.com/terryso/nof1-tracker-dashboard

本系统使用 Binance 合约交易API，必须正确配置权限：

1. 首先先注册一个币安帐号: https://www.maxweb.red/referral/earn-together/refer2earn-usdc/claim?hl=zh-CN&ref=GRO_28502_ACBRJ&utm_source=default
2. 登录 Binance → API Management
3. 创建新API密钥，完成安全验证

• ✅ Enable Futures - 启用合约交易（必选）
• ✅ Enable Reading - 启用读取权限（必选）
• ❌ Enable Withdrawals - 不需要提现权限

1. 访问 Binance Testnet
2. 创建测试网API密钥
3. 在.env中设置：

   BINANCE_TESTNET=true
   BINANCE_API_KEY=测试网API密钥
   BINANCE_API_SECRET=测试网Secret密钥

# Binance API Configuration - 必须支持合约交易
BINANCE_API_KEY=your_binance_api_key_here
BINANCE_API_SECRET=your_binance_api_secret_here
BINANCE_TESTNET=true  # true=测试网, false=正式网

# 其他配置选项
LOG_LEVEL=INFO  # 日志级别
TELEGRAM_API_TOKEN=  # Telegram Bot Token (可选)
TELEGRAM_CHAT_ID=    # Telegram Chat ID (可选)
TELEGRAM_ENABLED=false

npm start -- agents

如果您想在交易执行时收到Telegram通知，请按以下步骤配置：

创建Telegram Bot：

1. 在Telegram中搜索 @BotFather
2. 发送 /newbot 创建新机器人
3. 按提示设置机器人名称和用户名
4. 获取Bot Token（格式：1234567890:ABCdefGHIjklMNOpqrsTUVwxyz）

获取Chat ID：

1. 在Telegram中搜索 @userinfobot
2. 发送任意消息获取您的Chat ID
3. 或者发送消息给您的机器人，然后访问：https://api.telegram.org/bot<TOKEN>/getUpdates

环境变量配置：

# 在 .env 文件中添加
TELEGRAM_BOT_TOKEN=1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
TELEGRAM_CHAT_ID=123456789

测试Telegram通知：

npm start -- telegram-test

基础用法：

# 单次执行
npm start -- follow deepseek-chat-v3.1

# 持续监控（每30秒轮询）
npm start -- follow gpt-5 --interval 30

# 风险控制模式（只观察不执行）
npm start -- follow claude-sonnet-4-5 --risk-only

高级选项：

# 设置总保证金（默认10 USDT）
npm start -- follow gpt-5 --total-margin 5000

# 设置每个币种固定保证金（固定金额分配模式）
npm start -- follow gpt-5 --fixed-amount-per-coin 100

# 设置价格容差（默认1.0%）
npm start -- follow deepseek-chat-v3.1 --price-tolerance 1.0

# 盈利目标退出（达到30%盈利时自动平仓）
npm start -- follow gpt-5 --profit 30

# 盈利目标退出 + 自动重新跟单
npm start -- follow deepseek-chat-v3.1 --profit 30 --auto-refollow

# 设置保证金模式（逐仓模式）
npm start -- follow gpt-5 --margin-type ISOLATED

# 设置保证金模式（全仓模式，默认）
npm start -- follow deepseek-chat-v3.1 --margin-type CROSSED

# 组合使用
npm start -- follow gpt-5 --interval 30 --total-margin 2000 --profit 25 --auto-refollow --margin-type ISOLATED

# 固定金额分配模式组合使用
npm start -- follow gpt-5 --interval 30 --fixed-amount-per-coin 100 --profit 25 --auto-refollow

命令选项说明：

• -r, --risk-only: 只评估不执行交易（安全模式）
• -i, --interval <seconds>: 轮询间隔（秒），默认30秒
• -t, --price-tolerance <percentage>: 价格容差百分比，默认1.0%
• -m, --total-margin <amount>: 总保证金（USDT），默认10
• --fixed-amount-per-coin <amount>: 每个币种固定保证金（USDT），固定金额分配模式
• --profit <percentage>: 盈利目标百分比，达到后自动平仓退出
• --auto-refollow: 自动重新跟单，支持盈利退出和手工平仓后自动重新入场（默认关闭）
• --margin-type <type>: 保证金模式，ISOLATED（逐仓）或 CROSSED（全仓，默认）

资金分配模式说明：

1. 总保证金模式（默认）: --total-margin 5000

   • 将总保证金按比例分配给所有跟单的币种
   • 适合分散投资，自动平衡各个仓位的资金分配

2. 固定金额分配模式: --fixed-amount-per-coin 100

   • 为每个币种分配固定金额的保证金
   • 资金不足时按优先级顺序分配，先到先得
   • 严格控制每个仓位的最大风险

⚠️ 注意: --total-margin 和 --fixed-amount-per-coin 不能同时使用，只能选择一种分配模式。

# 统计跟单开始以来的总盈利（默认包含浮动盈亏）
npm start -- profit

# 统计指定时间范围的盈利
npm start -- profit --since 7d        # 最近7天
npm start -- profit --since 2024-01-01 # 从2024年1月1日开始
npm start -- profit --since 1704067200000 # 使用时间戳

# 指定交易对统计
npm start -- profit --pair BTCUSDT

# JSON格式输出
npm start -- profit --format json

# 强制刷新缓存数据
npm start -- profit --refresh

# 包含当前仓位的浮动盈亏（默认行为）
npm start -- profit

# 仅显示当前仓位的浮动盈亏（不含已实现交易）
npm start -- profit --unrealized-only

# 排除浮动盈亏（仅分析已实现交易）
npm start -- profit --exclude-unrealized

profit命令选项说明：

• -s, --since <time>: 时间筛选器，支持"7d"（最近7天）、"2024-01-01"（指定日期）、时间戳格式。不指定则使用order-history.json的创建时间
• -p, --pair <symbol>: 指定交易对（如BTCUSDT）
• --group-by <type>: 分组方式：symbol（按交易对）或all（全部）
• --format <type>: 输出格式：table（表格）或json（JSON）
• --refresh: 强制刷新缓存，获取最新数据
• --exclude-unrealized: 排除当前仓位的浮动盈亏，仅分析已实现交易
• --unrealized-only: 仅显示当前仓位的浮动盈亏

输出统计信息：

• 基础统计: 总交易次数、已实现盈亏（扣除手续费）、胜率、平均盈利/亏损
• 浮动盈亏: 当前仓位数量、总浮动盈亏、详细仓位信息（默认包含，使用--exclude-unrealized时排除）
• 总盈亏: 已实现盈亏 + 浮动盈亏的完整盈利情况
• 手续费分析: 总手续费支出、平均每笔手续费
• 风险指标: 最大单笔盈利、最大单笔亏损、浮动盈亏风险提示
• 分组统计: 按交易对分组的详细盈利情况

npm start -- status

系统自动识别4种交易信号：

1. 📈 新开仓 (ENTER) - Agent开新仓位时自动跟单
2. 📉 平仓 (EXIT) - Agent平仓时自动跟单
3. 🔄 换仓 (OID变化) - 检测到entry_oid变化时，先平旧仓再开新仓
4. 🎯 止盈止损 - 价格达到profit_target或stop_loss时自动平仓

设置自定义盈利目标，当仓位达到指定盈利百分比时自动平仓退出：

# 当盈利达到30%时自动平仓
npm start -- follow gpt-5 --profit 30

# 当盈利达到50%时自动平仓
npm start -- follow deepseek-chat-v3.1 --profit 50

特点：

• ✅ 实时监控每个仓位的盈利百分比
• ✅ 达到目标后立即执行市价平仓
• ✅ 支持多头和空头仓位的盈利计算
• ✅ 完整的盈利退出事件记录

--auto-refollow 选项现在支持两种自动重新跟单场景：

1. 盈利目标退出后重新跟单：

# 盈利30%退出后，自动重新跟单
npm start -- follow gpt-5 --profit 30 --auto-refollow

# 组合使用：持续监控 + 盈利目标 + 自动重新跟单
npm start -- follow deepseek-chat-v3.1 --interval 30 --profit 25 --auto-refollow

2. 手工平仓后自动重新跟单（新功能）：

# 启用手工平仓检测和自动重新跟单
npm start -- follow deepseek-chat-v3.1 --auto-refollow

# 即使不设置盈利目标，也会检测手工平仓
npm start -- follow gpt-5 --interval 30 --auto-refollow

手工平仓检测原理：

• 🔍 系统比对 NOF1 API 数据和币安实际仓位
• 🔧 当 NOF1 显示有仓位但币安无仓位时，判定为手工平仓
• 📝 自动记录手工平仓事件
• 🔄 重置订单历史，允许重新跟单
• ⏭️ 当 NOF1 再次开仓时，自动跟随

工作流程：

盈利退出场景：

1. 🔍 检测到仓位盈利达到目标（如30%）
2. 💰 立即执行市价平仓，锁定盈利
3. 📝 记录盈利退出事件到历史
4. 🔄 重置该symbol的订单处理状态
5. ⏭️ 下个轮询周期检测到OID变化，自动重新跟单

手工平仓场景：

1. 👤 用户在币安 App 手工平仓
2. 🔍 下次轮询时系统检测到仓位差异
3. 📝 记录手工平仓事件到历史
4. 🔄 重置该symbol的订单处理状态
5. ⏭️ 当 NOF1 再次开仓时，自动跟随

安全特性：

• 🛡️ 重新跟单前进行价格容忍度检查
• 📊 保留agent原始的止盈止损计划
• 🔄 可选功能，默认关闭避免意外影响
• 📝 完整的操作日志记录
• 🔒 手工平仓检测仅在启用 --auto-refollow 时激活

使用场景：

• 🎯 仅盈利退出：--profit 30 （达到30%盈利时平仓，不重新跟单）
• 🔄 盈利退出+重新跟单：--profit 30 --auto-refollow （盈利退出后自动重新跟单）
• 🔧 手工平仓+重新跟单：--auto-refollow （检测手工平仓并自动重新跟单）
• 🚀 完整自动化：--profit 30 --auto-refollow （同时支持盈利退出和手工平仓的重新跟单）

使用建议：

• 🎯 保守策略：--profit 20 （20%盈利退出，不重新跟单）
• ⚖️ 平衡策略：--profit 30 --auto-refollow （30%盈利退出并重新跟单）
• 🚀 积极策略：--auto-refollow （灵活手工干预，自动重新跟单）
• 💎 专业策略：--profit 50 --auto-refollow （高盈利目标+手工平仓支持）

新手入门：

# 1. 检查系统配置
npm start -- status

# 2. 查看可用Agent
npm start -- agents

# 3. 风险控制模式测试
npm start -- follow buynhold_btc --risk-only

# 4. 单次跟单测试
npm start -- follow deepseek-chat-v3.1

# 5. 查看盈利统计
npm start -- profit

持续监控：

# 每30秒检查一次
npm start -- follow gpt-5 --interval 30

# 多Agent并行监控（不同终端）
npm start -- follow gpt-5 --interval 30
npm start -- follow deepseek-chat-v3.1 --interval 45
npm start -- follow claude-sonnet-4-5 --interval 60 --risk-only

盈利分析：

# 查看总盈利情况（默认包含浮动盈亏）
npm start -- profit

# 仅查看已实现盈利（排除浮动盈亏）
npm start -- profit --exclude-unrealized

# 仅查看当前仓位的浮动盈亏
npm start -- profit --unrealized-only

# 按不同时间范围分析
npm start -- profit --since 1d      # 最近1天
npm start -- profit --since 7d      # 最近1周
npm start -- profit --since 30d     # 最近1月

# 按交易对分析
npm start -- profit --pair BTCUSDT --since 7d
npm start -- profit --pair ETHUSDT --format json

# JSON格式输出（默认包含浮动盈亏）
npm start -- profit --format json

# 仅浮动盈亏的JSON格式输出
npm start -- profit --unrealized-only --format json

src/
├── commands/               # 命令处理器
│   ├── agents.ts          # 获取AI Agent列表
│   ├── follow.ts          # 跟单命令（核心）
│   ├── profit.ts          # 盈利统计分析
│   ├── status.ts          # 系统状态检查
│   └── telegram.ts        # Telegram通知命令
├── services/              # 核心服务
│   ├── api-client.ts      # Nof1 API客户端
│   ├── binance-service.ts # Binance API集成
│   ├── trading-executor.ts # 交易执行引擎
│   ├── position-manager.ts # 仓位管理
│   ├── profit-calculator.ts # 盈利计算引擎
│   ├── trade-history-service.ts # 交易历史服务
│   ├── order-history-manager.ts # 订单历史管理
│   ├── futures-capital-manager.ts # 合约资金管理
│   └── telegram-service.ts # Telegram通知服务
├── scripts/
│   └── analyze-api.ts     # API分析引擎（跟单策略）
├── types/                 # TypeScript类型定义
├── utils/                 # 工具函数
└── index.ts               # CLI入口点

核心流程：

跟单流程：
用户命令 → follow命令处理器 → ApiAnalyzer分析Agent信号
         ↓
    识别交易动作（开仓/平仓/换仓/止盈止损）
         ↓
    生成FollowPlan → TradingExecutor执行
         ↓
    BinanceService → Binance API → 交易完成
         ↓
    TelegramService → Telegram通知（可选）

盈利分析流程：
用户命令 → profit命令处理器 → TradeHistoryService获取历史交易
         ↓
    ProfitCalculator计算盈利（基于realizedPnl和手续费）
         ↓
    生成统计报告（基础统计、分组统计、风险指标）
         ↓
    输出结果（表格/JSON格式）

• ⚠️ 合约交易风险: 合约交易使用杠杆，可能导致快速亏损，请谨慎使用
• 🧪 测试环境: 强烈建议先在 Binance Testnet 测试
• 📊 风险管理: 建议杠杆≤10x，使用专门的交易账户
• 💡 风险控制模式: 新手建议先使用--risk-only模式观察
• 📈 跟单风险: AI Agent的策略不保证盈利，请自行评估风险

• 设置IP白名单限制访问
• 定期更换API密钥
• 不要在代码中硬编码密钥
• 避免投入无法承受损失的资金

1. 合约交易权限不足

Error: Insufficient permissions

• ✅ 确保在Binance API管理页面启用了 Enable Futures 权限
• ✅ 确保启用了 Enable Reading 权限
• 重新创建API密钥并正确配置权限

2. Agent不存在

Error: Agent xxx not found

• 使用npm start -- agents查看可用Agent列表
• 确认Agent名称拼写正确（区分大小写）

3. 网络连接问题

Error: timeout

• 检查网络连接和防火墙设置
• 如果在中国大陆，可能需要使用VPN访问Binance API

4. API密钥错误

Error: Invalid API Key

• 检查.env文件中的API密钥是否正确
• 确认API密钥没有过期
• 验证是否复制了完整的密钥（没有多余空格）

# 运行测试
npm test

# 开发模式（自动重启）
npm run dev

# 构建
npm run build

# 代码检查
npm run lint

• 详细跟单策略文档 - 完整的跟单策略和风险评估
• 快速参考手册 - 常用命令快速查询
• 自动重新跟单功能说明 - 手工平仓检测和自动重新跟单详细说明

MIT License - 查看 LICENSE 文件了解详情

免责声明: 本工具仅供学习和测试使用。实际交易存在资金损失风险，请谨慎使用并遵守相关法律法规。