由于nof1.ai新一季是炒美股, 所以本脚本暂时没用了
如果想用自己的大模型来执行自动交易, 可以使用 https://github.com/terryso/LLM-trader-test 这个项目
中文 | 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
| Agent名称 |
|---|
| gpt-5 |
| gemini-2.5-pro |
| deepseek-chat-v3.1 |
| claude-sonnet-4-5 |
| buynhold_btc |
| grok-4 |
| qwen3-max |
本系统使用 Binance 合约交易API，必须正确配置权限：
- 首先先注册一个币安帐号: https://www.maxweb.red/referral/earn-together/refer2earn-usdc/claim?hl=zh-CN&ref=GRO_28502_ACBRJ&utm_source=default
- 登录 Binance → API Management
- 创建新API密钥，完成安全验证
- ✅ Enable Futures - 启用合约交易（必选）
- ✅ Enable Reading - 启用读取权限（必选）
- ❌ Enable Withdrawals - 不需要提现权限
- 访问 Binance Testnet
- 创建测试网API密钥
- 在
.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=falsenpm start -- agents如果您想在交易执行时收到Telegram通知，请按以下步骤配置：
创建Telegram Bot：
- 在Telegram中搜索
@BotFather - 发送
/newbot创建新机器人 - 按提示设置机器人名称和用户名
- 获取Bot Token（格式：
1234567890:ABCdefGHIjklMNOpqrsTUVwxyz）
获取Chat ID：
- 在Telegram中搜索
@userinfobot - 发送任意消息获取您的Chat ID
- 或者发送消息给您的机器人，然后访问：
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（全仓，默认）
资金分配模式说明：
-
总保证金模式（默认）:
--total-margin 5000- 将总保证金按比例分配给所有跟单的币种
- 适合分散投资，自动平衡各个仓位的资金分配
-
固定金额分配模式:
--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-unrealizedprofit命令选项说明：
-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种交易信号：
- 📈 新开仓 (ENTER) - Agent开新仓位时自动跟单
- 📉 平仓 (EXIT) - Agent平仓时自动跟单
- 🔄 换仓 (OID变化) - 检测到entry_oid变化时，先平旧仓再开新仓
- 🎯 止盈止损 - 价格达到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-refollow2. 手工平仓后自动重新跟单（新功能）：
# 启用手工平仓检测和自动重新跟单
npm start -- follow deepseek-chat-v3.1 --auto-refollow
# 即使不设置盈利目标，也会检测手工平仓
npm start -- follow gpt-5 --interval 30 --auto-refollow手工平仓检测原理：
- 🔍 系统比对 NOF1 API 数据和币安实际仓位
- 🔧 当 NOF1 显示有仓位但币安无仓位时，判定为手工平仓
- 📝 自动记录手工平仓事件
- 🔄 重置订单历史，允许重新跟单
- ⏭️ 当 NOF1 再次开仓时，自动跟随
工作流程：
盈利退出场景：
- 🔍 检测到仓位盈利达到目标（如30%）
- 💰 立即执行市价平仓，锁定盈利
- 📝 记录盈利退出事件到历史
- 🔄 重置该symbol的订单处理状态
- ⏭️ 下个轮询周期检测到OID变化，自动重新跟单
手工平仓场景：
- 👤 用户在币安 App 手工平仓
- 🔍 下次轮询时系统检测到仓位差异
- 📝 记录手工平仓事件到历史
- 🔄 重置该symbol的订单处理状态
- ⏭️ 当 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 jsonsrc/
├── 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- 详细跟单策略文档 - 完整的跟单策略和风险评估
- 快速参考手册 - 常用命令快速查询
- 自动重新跟单功能说明 - 手工平仓检测和自动重新跟单详细说明
- 数据提供者抽象层 - 如何切换到其他数据源（当 nof1 API 停用时）
MIT License - 查看 LICENSE 文件了解详情
免责声明: 本工具仅供学习和测试使用。实际交易存在资金损失风险，请谨慎使用并遵守相关法律法规。