# nof1-tracker
**Repository Path**: joe8899/nof1-tracker
## Basic Information
- **Project Name**: nof1-tracker
- **Description**: A command-line tool for tracking nof1.ai AI Agent trading signals and automatically executing Binance futures trades
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-03
- **Last Updated**: 2025-11-03
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Nof1 AI Agent 跟单交易系统
中文 | [English](./README_EN.md)
一个用于跟踪 nof1.ai AI Agent 交易信号并自动执行 Binance 合约交易的命令行工具。支持7个AI量化Agent的实时跟单，自动识别开仓、平仓、换仓和止盈止损信号。
[](https://ko-fi.com/F1F11HO935)
## 🏢 代部署服务
**不想自己部署？我们提供代部署服务！**
### 服务器部署的优势
- 🖥️ **无需本地电脑运行** - 服务器24小时自动运行，无需保持自己的电脑开着
- 🌍 **无需翻墙** - 推荐的服务器在国外环境，访问Binance API和nof1.ai更稳定
- 🔋 **省心省力** - 专业配置，自动运行，无需担心环境配置和网络问题
### 服务费用
- 💰 **服务器成本低** - 一个服务器月租仅需40元人民币
- 🛠️ **部署服务费面议** - 根据具体需求进行配置和部署
### 联系方式
📱 **有意者请加微信**: `gptkit`
> 备注：代部署服务包含完整的环境配置、系统部署、运行测试和使用指导。
## ⚡ 快速开始
```bash
# 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](https://nof1-tracker-dashboard.onrender.com)
实时查看 deepseek-chat-v3.1 AI Agent 的交易表现、持仓情况和盈亏统计。
Dashboard项目地址: https://github.com/terryso/nof1-tracker-dashboard
## 🤖 支持的AI Agent
| Agent名称 |
|----------|
| **gpt-5** |
| **gemini-2.5-pro** |
| **deepseek-chat-v3.1** |
| **claude-sonnet-4-5** |
| **buynhold_btc** |
| **grok-4** |
| **qwen3-max** |
## ⚙️ 配置
### 1. Binance API 密钥配置（重要）
本系统使用 **Binance 合约交易API**，必须正确配置权限：
#### 创建API密钥
1. 首先先注册一个币安帐号: https://www.maxweb.red/referral/earn-together/refer2earn-usdc/claim?hl=zh-CN&ref=GRO_28502_ACBRJ&utm_source=default
2. 登录 [Binance](https://www.binance.com/) → [API Management](https://www.binance.com/en/my/settings/api-management)
3. 创建新API密钥，完成安全验证
#### 配置权限（关键）
- ✅ **Enable Futures** - 启用合约交易（必选）
- ✅ **Enable Reading** - 启用读取权限（必选）
- ❌ **Enable Withdrawals** - 不需要提现权限
#### 测试网环境（推荐新手）
1. 访问 [Binance Testnet](https://testnet.binancefuture.com/)
2. 创建测试网API密钥
3. 在`.env`中设置：
```env
BINANCE_TESTNET=true
BINANCE_API_KEY=测试网API密钥
BINANCE_API_SECRET=测试网Secret密钥
```
### 2. 环境变量配置
```env
# 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
```
## 📖 使用方法
### 核心命令
#### 1. 查看可用的AI Agent
```bash
npm start -- agents
```
#### 2. Telegram通知配置（可选）
如果您想在交易执行时收到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/getUpdates`
**环境变量配置**：
```bash
# 在 .env 文件中添加
TELEGRAM_BOT_TOKEN=1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
TELEGRAM_CHAT_ID=123456789
```
**测试Telegram通知**：
```bash
npm start -- telegram-test
```
#### 3. 跟单AI Agent（核心功能）
**基础用法**：
```bash
# 单次执行
npm start -- follow deepseek-chat-v3.1
# 持续监控（每30秒轮询）
npm start -- follow gpt-5 --interval 30
# 风险控制模式（只观察不执行）
npm start -- follow claude-sonnet-4-5 --risk-only
```
**高级选项**：
```bash
# 设置总保证金（默认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 `: 轮询间隔（秒），默认30秒
- `-t, --price-tolerance `: 价格容差百分比，默认1.0%
- `-m, --total-margin `: 总保证金（USDT），默认10
- `--fixed-amount-per-coin `: 每个币种固定保证金（USDT），固定金额分配模式
- `--profit `: 盈利目标百分比，达到后自动平仓退出
- `--auto-refollow`: 自动重新跟单，支持盈利退出和手工平仓后自动重新入场（默认关闭）
- `--margin-type `: 保证金模式，ISOLATED（逐仓）或 CROSSED（全仓，默认）
**资金分配模式说明**：
1. **总保证金模式（默认）**: `--total-margin 5000`
- 将总保证金按比例分配给所有跟单的币种
- 适合分散投资，自动平衡各个仓位的资金分配
2. **固定金额分配模式**: `--fixed-amount-per-coin 100`
- 为每个币种分配固定金额的保证金
- 资金不足时按优先级顺序分配，先到先得
- 严格控制每个仓位的最大风险
⚠️ **注意**: `--total-margin` 和 `--fixed-amount-per-coin` 不能同时使用，只能选择一种分配模式。
#### 4. 盈利统计分析
```bash
# 统计跟单开始以来的总盈利（默认包含浮动盈亏）
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