72 KiB
🤖 NOFX - Agentic Trading OS
Языки / Languages: English | 中文 | Українська | Русский | 日本語 | 한국어 | Tiếng Việt
📚 Документация: Главная | Начало работы | Журнал изменений | Сообщество | ⚠️ Отказ от ответственности
📑 Содержание
- 🚀 Универсальная AI Торговая Операционная Система
- 👥 Сообщество Разработчиков
- 🆕 Что Нового
- 📸 Скриншоты
- ✨ Текущая Реализация - Криптовалютные Рынки
- 🔮 Дорожная Карта
- 🏗️ Техническая Архитектура
- 💰 Регистрация аккаунта Binance
- 🔷 Регистрация аккаунта Hyperliquid
- 🔶 Регистрация аккаунта Aster DEX
- 🚀 Быстрый Старт
- 📊 Функции Web-интерфейса
- ⚠️ Важные Предупреждения о Рисках
- 🛠️ Общие Проблемы
- 🔄 Журнал Изменений
🚀 Универсальная AI Торговая Операционная Система
NOFX - это универсальная Agentic Trading OS, построенная на единой архитектуре. Мы успешно замкнули цикл на криптовалютных рынках: "Решение Multi-Agent → Единый Контроль Рисков → Исполнение с Низкой Задержкой → Бэктестинг Реальных/Бумажных Счетов", и сейчас расширяем этот же технологический стек на акции, фьючерсы, опционы, форекс и все финансовые рынки.
🎯 Основные Возможности
- Универсальный Слой Данных и Бэктестинга: Кросс-рыночное, кросс-таймфреймовое, кросс-биржевое единое представление и библиотека факторов, накапливающая переносимую "память стратегий"
- Multi-Agent Самоигра и Самоэволюция: Стратегии автоматически конкурируют и выбирают лучшие, непрерывно итерируясь на основе PnL на уровне счета и ограничений рисков
- Интегрированное Исполнение и Контроль Рисков: Маршрутизация с низкой задержкой, песочница проскальзывания/контроля рисков, лимиты на уровне счета, переключение рынков одним кликом
🏢 При поддержке Amber.ac
👥 Основная Команда
- Tinkle - @Web3Tinkle
- Единственный Официальный Twitter - @nofx_official
💼 Открыт Посевной Раунд Финансирования
Мы в настоящее время привлекаем посевной раунд.
По вопросам инвестиций, пишите в DM Tinkle в Twitter.
⚠️ Предупреждение о рисках: Эта система экспериментальная. Автоматическая торговля с AI несет значительные риски. Настоятельно рекомендуется использовать только для обучения/исследований или тестирования с небольшими суммами!
👥 Сообщество разработчиков
Присоединяйтесь к нашему сообществу разработчиков в Telegram для обсуждения, обмена идеями и получения поддержки:
💬 Сообщество разработчиков NOFX
🆕 Последние обновления
🚀 Поддержка нескольких бирж!
NOFX теперь поддерживает три основные биржи: Binance, Hyperliquid и Aster DEX!
Биржа Hyperliquid
Высокопроизводительная децентрализованная биржа бессрочных фьючерсов!
Ключевые особенности:
- ✅ Полная поддержка торговли (лонг/шорт, плечо, стоп-лосс/тейк-профит)
- ✅ Автоматическая обработка точности (размер и цена ордера)
- ✅ Единый интерфейс трейдера (бесшовное переключение бирж)
- ✅ Поддержка мейннета и тестнета
- ✅ Не нужны API ключи - только приватный ключ Ethereum
Почему Hyperliquid?
- 🔥 Более низкие комиссии чем на централизованных биржах
- 🔒 Без хранения - вы контролируете свои средства
- ⚡ Быстрое исполнение с расчетом на цепи
- 🌍 Не нужна KYC
Быстрый старт:
- Получите приватный ключ MetaMask (удалите префикс
0x) УстановитеНастройте через веб-интерфейс"exchange": "hyperliquid"в config.json- Добавьте
"hyperliquid_private_key": "your_key" - Начните торговать!
См. Руководство по конфигурации.
Биржа Aster DEX (НОВОЕ! v2.0.2)
Децентрализованная биржа бессрочных фьючерсов, совместимая с Binance!
Ключевые особенности:
- ✅ API в стиле Binance (легкая миграция с Binance)
- ✅ Web3 аутентификация кошелька (безопасно и децентрализованно)
- ✅ Полная поддержка торговли с автоматической обработкой точности
- ✅ Более низкие комиссии за торговлю чем CEX
- ✅ Совместимость с EVM (Ethereum, BSC, Polygon и т.д.)
Почему Aster?
- 🎯 API совместимый с Binance - нужны минимальные изменения кода
- 🔐 Система API кошелька - отдельный торговый кошелек для безопасности
- 💰 Конкурентные комиссии - ниже чем большинство централизованных бирж
- 🌐 Поддержка нескольких цепей - торгуйте на вашей любимой EVM цепи
Быстрый старт:
- Зарегистрируйтесь по реферальной ссылке Aster (получите скидку на комиссии!)
- Посетите Aster API Wallet
- Подключите основной кошелек и создайте API кошелек
- Скопируйте адрес API Signer и приватный ключ
- Установите
"exchange": "aster"в config.json - Добавьте
"aster_user","aster_signer"и"aster_private_key"
📸 Скриншоты
🏆 Режим конкуренции - Битва AI в реальном времени
Лидерборд с несколькими AI и графики сравнения производительности в реальном времени показывают битву Qwen против DeepSeek
📊 Детали трейдера - Полная торговая панель
Профессиональный торговый интерфейс с кривыми капитала, живыми позициями и логами решений AI с раскрываемыми входными промптами и цепочкой рассуждений
📘 Примечание: Это упрощенная русская версия README. Для получения полной технической документации, включая архитектуру системы, API-интерфейсы и расширенные конфигурации, см. Английскую версию или Китайскую версию.
✨ Текущая реализация - Рынки криптовалют
NOFX в настоящее время полностью работает на криптовалютных рынках со следующими проверенными возможностями:
🏆 Структура конкуренции Multi-Agent
- Реальная битва AI-агентов: Торговое соревнование моделей Qwen vs DeepSeek в реальном времени
- Независимое управление счетами: Каждый агент ведет отдельные журналы решений и метрики производительности
- Сравнение производительности в реальном времени: Отслеживание ROI в реальном времени, статистика винрейта, прямой анализ
- Цикл самоэволюции: Агенты учатся на исторической производительности, постоянно совершенствуясь
🧠 AI Самообучение и Оптимизация
- Система исторической обратной связи: Анализ последних 20 торговых циклов перед каждым решением
- Интеллектуальный анализ производительности:
- Определяет лучшие/худшие активы по производительности
- Рассчитывает винрейт, коэффициент прибыли/убытка, среднюю прибыль в реальных USDT
- Избегает повторяющихся ошибок (паттерны последовательных убытков)
- Усиливает успешные стратегии (высокие паттерны винрейта)
- Динамическая корректировка стратегии: AI автономно регулирует торговый стиль на основе результатов бэктеста
📊 Универсальный слой рыночных данных (Криптореализация)
- Многотаймфреймовый анализ: 3-минутные реальные данные + 4-часовые трендовые данные
- Технические индикаторы: EMA20/50, MACD, RSI(7/14), ATR
- Отслеживание открытого интереса: Анализ настроений рынка, денежных потоков
- Фильтрация ликвидности: Автоматическая фильтрация активов с низкой ликвидностью (<15M USD)
- Поддержка кросс-биржевой торговли: Binance, Hyperliquid, Aster DEX, единый интерфейс данных
🎯 Единая система контроля рисков
- Лимиты позиций: Лимиты на актив (Альткоины≤1.5x капитал, BTC/ETH≤10x капитал)
- Настраиваемое кредитное плечо: Динамическая настройка от 1x до 50x на основе класса активов и типа счета
- Управление маржой: Общее использование≤90%, AI контролирует распределение
- Принудительное соотношение риск/вознаграждение: Обязательное соотношение стоп-лосс/тейк-профит ≥1:2
- Защита от наслоения: Предотвращает дублирование позиций по одному активу/направлению
⚡ Движок исполнения с низкой задержкой
- Интеграция API множества бирж: Binance Futures, Hyperliquid DEX, Aster DEX
- Автоматическая обработка точности: Интеллектуальное форматирование размера и цены ордера для каждой биржи
- Приоритетное исполнение: Сначала закрытие существующих позиций, затем открытие новых
- Контроль проскальзывания: Проверка перед исполнением, проверка точности в реальном времени
🎨 Профессиональный интерфейс мониторинга
- Dashboard в стиле Binance: Профессиональная темная тема с обновлениями в реальном времени
- Кривые капитала: Историческое отслеживание стоимости счета (переключение USD/процент)
- Графики производительности: Сравнение ROI множества AI-агентов, обновления в реальном времени
- Полные журналы решений: Полное рассуждение цепочки мыслей (CoT) для каждой сделки
- 5-секундное обновление данных: Обновления счета, позиций и P&L в реальном времени
🔮 Дорожная карта - Расширение универсального рынка
Миссия NOFX - стать универсальной AI-торговой ОС для всех финансовых рынков.
Видение: Одна архитектура. Одна агентная структура. Все рынки.
Расширяемые рынки:
- 📈 Фондовые рынки: Акции США, акции Китая, Гонконгские акции
- 📊 Фьючерсные рынки: Товарные фьючерсы, индексные фьючерсы
- 🎯 Опционная торговля: Опционы на акции, криптоопционы
- 💱 Рынок Forex: Основные валютные пары, кросс-пары
Предстоящие функции:
- Расширенные возможности AI (GPT-4, Claude 3, Gemini Pro, гибкие шаблоны промптов)
- Интеграция новых бирж (OKX, Bybit, Lighter, EdgeX + CEX/Perp-DEX)
- Рефакторинг структуры проекта (высокая связность, низкая связанность, принципы SOLID)
- Улучшения безопасности (AES-256 шифрование API-ключей, RBAC, улучшенная 2FA)
- Улучшения UX (отзывчивость мобильных устройств, графики TradingView, система оповещений)
📖 Для детальной дорожной карты и графиков см.:
- English: Roadmap Documentation
- 中文: 路线图文档
✨ Основные возможности
🏆 Режим конкуренции нескольких AI
- Qwen против DeepSeek - битва в реальной торговле
- Независимое управление счетами и журналами решений
- Графики сравнения производительности в реальном времени
- Статистика ROI и процента выигрышей
🧠 Механизм самообучения AI (НОВИНКА!)
- Исторический анализ: Анализирует последние 20 циклов торговли перед каждым решением
- Умная оптимизация:
- Определяет лучшие/худшие монеты по производительности
- Рассчитывает процент выигрышей, соотношение прибыли/убытка, среднюю прибыль
- Избегает повторения ошибок (последовательно убыточные монеты)
- Усиливает успешные стратегии (паттерны с высоким процентом выигрышей)
- Динамическая корректировка: AI автономно корректирует торговый стиль на основе исторической производительности
📊 Интеллектуальный анализ рынка
- 3-минутная свеча: Цена в реальном времени, EMA20, MACD, RSI(7)
- 4-часовая свеча: Долгосрочный тренд, EMA20/50, ATR, RSI(14)
- Анализ открытого интереса: Настроения рынка, определение денежных потоков
- Отслеживание топ OI: Топ-20 монет с самым быстрым ростом открытого интереса
- Пул монет AI500: Автоматический отбор монет с высоким рейтингом
- Фильтр ликвидности: Автоматическая фильтрация монет с низкой ликвидностью (<15M USD стоимости позиции)
🎯 Профессиональный контроль рисков
- Лимит позиции по монете:
- Альткоины ≤ 1.5x капитал счета
- BTC/ETH ≤ 10x капитал счета
- Настраиваемое плечо (v2.0.3+):
- Установите максимальное плечо в config.json
- По умолчанию: 5x для всех монет (безопасно для субаккаунтов)
- Основные аккаунты могут увеличить: Альткоины до 20x, BTC/ETH до 50x
- ⚠️ Субаккаунты Binance ограничены ≤5x плечом
- Управление маржой: Общее использование ≤90%, AI принимает автономные решения
- Соотношение риск/доход: Обязательное ≥1:2 (стоп-лосс:тейк-профит)
- Предотвращение накопления позиций: Запрет дублирования открытия той же монеты/направления
🎨 Профессиональный UI
- Профессиональный торговый интерфейс: Визуальный дизайн в стиле Binance
- Темная тема: Классическая цветовая схема (Золотой #F0B90B + темный фон)
- Данные в реальном времени: Обновление каждые 5 секунд для счетов, позиций, графиков
- Кривая капитала: График исторического тренда стоимости счета (переключение USD/процент)
- График сравнения производительности: Сравнение ROI нескольких AI в реальном времени
- Плавные анимации: Плавные эффекты наведения, переходов и загрузки
📝 Полная запись решений
- Цепочка рассуждений: Полный процесс рассуждений AI (CoT)
- Историческая производительность: Общий процент выигрышей, средняя прибыль, соотношение прибыли/убытка
- Последние сделки: Детали последних 5 сделок (цена входа → цена выхода → P/L%)
- Статистика по монетам: Производительность по каждой монете (процент выигрышей, средний P/L)
- JSON логи: Полные записи решений для пост-анализа
🔮 Дорожная Карта - Расширение на Универсальные Рынки
Миссия NOFX - стать Универсальной AI Торговой Операционной Системой для всех финансовых рынков.
Видение: Та же архитектура. Та же агентная структура. Все рынки.
Расширение на Рынки:
- 📈 Фондовые Рынки: Акции США, A-акции, Гонконгская биржа
- 📊 Рынки Фьючерсов: Товарные фьючерсы, индексные фьючерсы
- 🎯 Опционная Торговля: Опционы на акции, крипто опционы
- 💱 Рынки Форекс: Основные валютные пары, кросс-курсы
Предстоящие Функции:
- Расширенные AI возможности (GPT-4, Claude 3, Gemini Pro, гибкие шаблоны промптов)
- Новые интеграции бирж (OKX, Bybit, Lighter, EdgeX + CEX/Perp-DEX)
- Рефакторинг структуры проекта (высокая связность, низкая связанность, принципы SOLID)
- Улучшения безопасности (AES-256 шифрование API ключей, RBAC, улучшения 2FA)
- Улучшения пользовательского опыта (мобильный интерфейс, графики TradingView, система оповещений)
📖 Для подробной дорожной карты и сроков см.:
- English: Roadmap Documentation
- 中文: 路线图文档
🏗️ Техническая Архитектура
NOFX построен на современной модульной архитектуре:
- Backend: Go с фреймворком Gin, база данных SQLite
- Frontend: React 18 + TypeScript + Vite + TailwindCSS
- Поддержка Бирж: Binance, Hyperliquid, Aster DEX
- Интеграция AI: DeepSeek, Qwen и пользовательские OpenAI-совместимые API
- Управление Состоянием: Zustand для фронтенда, на основе базы данных для бэкенда
- Обновления в Реальном Времени: SWR с интервалами опроса 5-10 секунд
Ключевые Особенности:
- 🗄️ Конфигурация на основе базы данных (больше никакого редактирования JSON)
- 🔐 JWT аутентификация с опциональной поддержкой 2FA
- 📊 Отслеживание производительности и аналитика в реальном времени
- 🤖 Режим конкуренции Multi-AI с живым сравнением
- 🔌 RESTful API для всех настроек и мониторинга
📖 Для подробной документации по архитектуре см.:
- Русский: Документация по Архитектуре
- 中文: 架构文档
💰 Регистрация аккаунта Binance (Экономьте на комиссиях!)
Перед использованием этой системы вам нужен аккаунт Binance Futures. Используйте нашу реферальную ссылку для получения скидки на комиссии:
🎁 Зарегистрироваться на Binance - Получить скидку
Шаги регистрации:
- Нажмите на ссылку выше чтобы перейти на страницу регистрации Binance
- Завершите регистрацию используя email/номер телефона
- Пройдите KYC верификацию (требуется для торговли фьючерсами)
- Активируйте аккаунт Futures:
- Перейдите на главную страницу Binance → Деривативы → USD-M Фьючерсы
- Нажмите "Открыть сейчас" для активации торговли фьючерсами
- Создайте API ключ:
- Перейдите в Аккаунт → Управление API
- Создайте новый API ключ, включите разрешение "Futures"
- Сохраните API Key и Secret Key (необходимо для config.json)
- Важно: Добавьте свой IP адрес в белый список для безопасности
Преимущества скидки:
- ✅ Спотовая торговля: Скидка до 30% на комиссии
- ✅ Торговля фьючерсами: Скидка до 30% на комиссии
- ✅ Пожизненная: Постоянная скидка на все сделки
🚀 Быстрый старт
🐳 Вариант A: Docker развертывание в один клик (ПРОЩЕ ВСЕГО - Рекомендуется для новичков!)
⚡ Начните торговать за 3 простых шага с Docker - Не нужно ничего устанавливать!
Docker автоматически обрабатывает все зависимости (Go, Node.js, TA-Lib) и настройку среды. Идеально для новичков!
Шаг 1: Подготовьте конфигурацию
# Скопируйте шаблон конфигурации
cp config.json.example config.json
# Отредактируйте и заполните ваши API ключи
nano config.json # или используйте любой редактор
Шаг 2: Запуск в один клик
# Вариант 1: Используйте удобный скрипт (Рекомендуется)
chmod +x scripts/start.sh
./scripts/start.sh start --build
# Вариант 2: Используйте docker compose напрямую
# Этот проект использует синтаксис Docker Compose V2 (с пробелами)
# Если у вас установлена старая версия `docker-compose`, обновитесь до Docker Desktop или Docker 20.10+
docker compose up -d --build
Шаг 3: Доступ к панели
Откройте в браузере: http://localhost:3000
Вот и все! 🎉 Ваша AI торговая система теперь работает!
Управление вашей системой
./scripts/start.sh logs # Просмотреть логи
./scripts/start.sh status # Проверить статус
./scripts/start.sh stop # Остановить сервисы
./scripts/start.sh restart # Перезапустить сервисы
📖 Подробное руководство по развертыванию Docker, устранению неполадок и расширенной конфигурации:
- Русский: См. документацию Docker (скоро будет доступно)
- English: See DOCKER_DEPLOY.en.md
- 中文: 查看 DOCKER_DEPLOY.md
- 日本語: DOCKER_DEPLOY.ja.mdを参照
📦 Вариант B: Ручная установка (Для разработчиков)
Примечание: Если вы использовали развертывание Docker выше, пропустите этот раздел. Ручная установка нужна только если вы хотите изменить код или запустить без Docker.
1. Требования к среде
- Go 1.21+
- Node.js 18+
- TA-Lib библиотека (расчет технических индикаторов)
Установка TA-Lib
macOS:
brew install ta-lib
Ubuntu/Debian:
sudo apt-get install libta-lib0-dev
Другие системы: См. Официальную документацию TA-Lib
2. Клонирование проекта
git clone https://github.com/tinkle-community/nofx.git
cd nofx
3. Установка зависимостей
Backend:
go mod download
Frontend:
cd web
npm install
cd ..
4. Получение AI API ключей
Перед настройкой системы вам необходимо получить AI API ключ. Выберите одного из следующих AI провайдеров:
Вариант 1: DeepSeek (Рекомендуется для новичков)
Почему DeepSeek?
- 💰 Дешевле чем GPT-4 (примерно 1/10 стоимости)
- 🚀 Быстрое время отклика
- 🎯 Отличное качество торговых решений
- 🌍 Доступен глобально без VPN
Как получить DeepSeek API ключ:
- Посетите: https://platform.deepseek.com
- Зарегистрируйтесь: Используя email/номер телефона
- Подтвердите: Завершите подтверждение email/телефона
- Пополните: Добавьте баланс на аккаунт
- Минимум: ~$5 USD
- Рекомендуется: $20-50 USD для тестирования
- Создайте API ключ:
- Перейдите в раздел API Keys
- Нажмите "Создать новый ключ"
- Скопируйте и сохраните ключ (начинается с
sk-) - ⚠️ Важно: Сохраните немедленно - позже увидеть не сможете!
Цена: Примерно $0.14 за миллион токенов (очень дешево!)
Вариант 2: Qwen (Alibaba Cloud Tongyi Qianwen)
Как получить Qwen API ключ:
- Посетите: https://dashscope.console.aliyun.com
- Зарегистрируйтесь: Используя аккаунт Alibaba Cloud
- Активируйте сервис: Активируйте DashScope сервис
- Создайте API ключ:
- Перейдите в управление API ключами
- Создайте новый ключ
- Скопируйте и сохраните (начинается с
sk-)
Примечание: Может потребоваться китайский номер телефона для регистрации
5. Конфигурация системы
Доступны два режима конфигурации:
- 🌟 Режим новичка: Один трейдер + монеты по умолчанию (Рекомендуется!)
- ⚔️ Экспертный режим: Конкуренция нескольких трейдеров
🌟 Конфигурация режима новичка (Рекомендуется)
Шаг 1: Скопируйте и переименуйте файл примера конфигурации
cp config.json.example config.json
Шаг 2: Отредактируйте config.json и заполните ваши API ключи
{
"traders": [
{
"id": "my_trader",
"name": "Мой AI Трейдер",
"ai_model": "deepseek",
"binance_api_key": "YOUR_BINANCE_API_KEY",
"binance_secret_key": "YOUR_BINANCE_SECRET_KEY",
"use_qwen": false,
"deepseek_key": "sk-xxxxxxxxxxxxx",
"qwen_key": "",
"initial_balance": 1000.0,
"scan_interval_minutes": 3
}
],
"leverage": {
"btc_eth_leverage": 5,
"altcoin_leverage": 5
},
"use_default_coins": true,
"coin_pool_api_url": "",
"oi_top_api_url": "",
"api_server_port": 8080
}
Шаг 3: Замените заполнители вашими фактическими ключами
| Заполнитель | Заменить на | Где получить |
|---|---|---|
YOUR_BINANCE_API_KEY |
Ваш Binance API ключ | Binance → Аккаунт → Управление API |
YOUR_BINANCE_SECRET_KEY |
Ваш Binance Secret ключ | То же самое |
sk-xxxxxxxxxxxxx |
Ваш DeepSeek API ключ | platform.deepseek.com |
Шаг 4: Настройте начальный баланс (опционально)
initial_balance: Установите ваш фактический баланс Binance Futures аккаунта- Используется для расчета P/L процентов
- Пример: Если у вас 500 USDT, установите
"initial_balance": 500.0
✅ Контрольный список конфигурации:
- Binance API ключ заполнен (без кавычек)
- Binance Secret ключ заполнен (без кавычек)
- DeepSeek API ключ заполнен (начинается с
sk-) use_default_coinsустановлен вtrue(для новичков)initial_balanceсоответствует балансу аккаунта- Файл сохранен как
config.json(не.example)
🔷 Использование биржи Hyperliquid
NOFX поддерживает Hyperliquid - высокопроизводительную децентрализованную биржу бессрочных фьючерсов!
Почему выбрать Hyperliquid?
- 🚀 Высокая производительность: Молниеносное исполнение на L1 блокчейне
- 💰 Низкие комиссии: Конкурентные комиссии мейкер/тейкер
- 🔐 Без хранения: Ваши ключи, ваши монеты
- 🌐 Без KYC: Анонимная торговля
- 💎 Глубокая ликвидность: Книга ордеров институционального уровня
📝 Руководство по регистрации и настройке
Шаг 1: Регистрация аккаунта Hyperliquid
-
Посетите Hyperliquid по реферальной ссылке (получите преимущества!):
🎁 Зарегистрироваться на Hyperliquid - Присоединиться AITRADING
-
Подключите кошелек:
- Нажмите "Connect Wallet" в правом верхнем углу
- Выберите MetaMask, WalletConnect или другие Web3 кошельки
- Подтвердите подключение
-
Включите торговлю:
- При первом подключении появится запрос на подпись сообщения
- Это авторизует ваш кошелек для торговли (без комиссий за газ)
- Вы увидите отображенный адрес кошелька
Шаг 2: Пополнение кошелька
-
Мост активов в Arbitrum:
- Hyperliquid работает на Arbitrum L2
- Переведите USDC с Ethereum mainnet или других сетей
- Или напрямую выведите USDC с бирж на Arbitrum
-
Депозит в Hyperliquid:
- Нажмите "Deposit" в интерфейсе Hyperliquid
- Выберите сумму USDC для депозита
- Подтвердите транзакцию (небольшая комиссия за газ на Arbitrum)
- Средства появятся на вашем аккаунте Hyperliquid в течение секунд
Шаг 3: Настройка Agent Wallet (Рекомендуется)
Hyperliquid поддерживает Agent Wallets - безопасные подкошельки специально для торговой автоматизации!
⚠️ Зачем использовать Agent Wallet:
- ✅ Более безопасно: Никогда не раскрывайте приватный ключ основного кошелька
- ✅ Ограниченный доступ: У агента есть только торговые разрешения
- ✅ Отзывается: Может быть отключен в любое время из интерфейса Hyperliquid
- ✅ Отдельные средства: Держите основные активы в безопасности
Как создать Agent Wallet:
-
Войдите в Hyperliquid используя основной кошелек
- Посетите https://app.hyperliquid.xyz
- Подключитесь с кошельком, который вы зарегистрировали (по реферальной ссылке)
-
Перейдите в настройки агента:
- Нажмите на адрес кошелька (правый верхний угол)
- Перейдите в "Settings" → "API & Agents"
- Или посетите: https://app.hyperliquid.xyz/agents
-
Создайте нового агента:
- Нажмите "Create Agent" или "Add Agent"
- Система автоматически сгенерирует новый кошелек агента
- Сохраните адрес кошелька агента (начинается с
0x) - Сохраните приватный ключ агента (показывается только один раз!)
-
Детали Agent Wallet:
- Основной кошелек: Ваш подключенный кошелек (хранит средства)
- Кошелек агента: Подкошелек для торговли (NOFX будет использовать его)
- Приватный ключ: Нужен только для конфигурации NOFX
-
Пополните агента (Опционально):
- Переведите USDC с основного кошелька на кошелек агента
- Или оставьте средства в основном кошельке (агент может торговать с него)
-
Сохраните учетные данные для NOFX:
- Адрес основного кошелька:
0xYourMainWalletAddress(с0x) - Приватный ключ агента:
YourAgentPrivateKeyWithout0x(удалите префикс0x)
- Адрес основного кошелька:
Настройте Настройте через веб-интерфейсconfig.json для Hyperliquid
{
"traders": [
{
"id": "hyperliquid_trader",
"name": "My Hyperliquid Trader",
"enabled": true,
"ai_model": "deepseek",
"exchange": "hyperliquid",
"hyperliquid_private_key": "your_private_key_without_0x",
"hyperliquid_wallet_addr": "your_ethereum_address",
"hyperliquid_testnet": false,
"deepseek_key": "sk-xxxxxxxxxxxxx",
"initial_balance": 1000.0,
"scan_interval_minutes": 3
}
],
"use_default_coins": true,
"api_server_port": 8080
}
Ключевые отличия от конфигурации Binance:
- Замените
binance_api_key+binance_secret_keyнаhyperliquid_private_key - Добавьте поле
"exchange": "hyperliquid" - Установите
hyperliquid_testnet: falseдля мейннета (илиtrueдля тестнета)
⚠️ Предупреждение безопасности: Никогда не делитесь приватным ключом! Используйте отдельный кошелек для торговли, а не основной.
🔶 Использование биржи Aster DEX
NOFX поддерживает Aster DEX - децентрализованную биржу бессрочных фьючерсов, совместимую с Binance!
Почему выбрать Aster?
- 🎯 API совместимый с Binance (легкая миграция)
- 🔐 Система безопасности API кошелька
- 💰 Более низкие комиссии за торговлю
- 🌐 Поддержка нескольких цепей (ETH, BSC, Polygon)
- 🌍 Не нужна KYC
Шаг 1: Зарегистрируйтесь и создайте Aster API кошелек
- Зарегистрируйтесь по реферальной ссылке Aster (получите скидку на комиссии!)
- Посетите Aster API Wallet
- Подключите основной кошелек (MetaMask, WalletConnect и т.д.)
- Нажмите "Создать API кошелек"
- Сохраните эти 3 элемента немедленно:
- Адрес основного кошелька (User)
- Адрес API кошелька (Signer)
- Приватный ключ API кошелька (⚠️ показывается только один раз!)
Шаг 2: Настройте config.json для Aster
{
"traders": [
{
"id": "aster_deepseek",
"name": "Aster DeepSeek Trader",
"enabled": true,
"ai_model": "deepseek",
"exchange": "aster",
"aster_user": "0xYOUR_MAIN_WALLET_ADDRESS_HERE",
"aster_signer": "0xYOUR_API_WALLET_SIGNER_ADDRESS_HERE",
"aster_private_key": "your_api_wallet_private_key_without_0x_prefix",
"deepseek_key": "sk-xxxxxxxxxxxxx",
"initial_balance": 1000.0,
"scan_interval_minutes": 3
}
],
"use_default_coins": true,
"api_server_port": 8080,
"leverage": {
"btc_eth_leverage": 5,
"altcoin_leverage": 5
}
}
Ключевые поля конфигурации:
"exchange": "aster"- Установите биржу на Asteraster_user- Адрес вашего основного кошелькаaster_signer- Адрес API кошелька (из Шага 1)aster_private_key- Приватный ключ API кошелька (без префикса0x)
⚠️ Примечания безопасности:
- API кошелек отдельный от основного (дополнительный уровень безопасности)
- Никогда не делитесь приватным ключом API
- Вы можете отозвать доступ API кошелька в любое время на asterdex.com
⚔️ Экспертный режим: Конкуренция нескольких трейдеров
Для запуска нескольких AI трейдеров, конкурирующих друг с другом:
{
"traders": [
{
"id": "qwen_trader",
"name": "Qwen AI Trader",
"ai_model": "qwen",
"binance_api_key": "YOUR_BINANCE_API_KEY_1",
"binance_secret_key": "YOUR_BINANCE_SECRET_KEY_1",
"use_qwen": true,
"qwen_key": "sk-xxxxx",
"deepseek_key": "",
"initial_balance": 1000.0,
"scan_interval_minutes": 3
},
{
"id": "deepseek_trader",
"name": "DeepSeek AI Trader",
"ai_model": "deepseek",
"binance_api_key": "YOUR_BINANCE_API_KEY_2",
"binance_secret_key": "YOUR_BINANCE_SECRET_KEY_2",
"use_qwen": false,
"qwen_key": "",
"deepseek_key": "sk-xxxxx",
"initial_balance": 1000.0,
"scan_interval_minutes": 3
}
],
"use_default_coins": true,
"coin_pool_api_url": "",
"oi_top_api_url": "",
"api_server_port": 8080
}
Требования для режима конкуренции:
- 2 отдельных Binance Futures аккаунта (разные API ключи)
- Оба AI API ключа (Qwen + DeepSeek)
- Больше тестовых средств (Рекомендуется: 500+ USDT на аккаунт)
📚 Объяснение полей конфигурации
| Поле | Описание | Пример значения | Обязательно? |
|---|---|---|---|
id |
Уникальный идентификатор для этого трейдера | "my_trader" |
✅ Да |
name |
Отображаемое имя | "Мой AI Трейдер" |
✅ Да |
enabled |
Включен ли этот трейдер Установите в false для пропуска запуска |
true или false |
✅ Да |
ai_model |
Используемый AI провайдер | "deepseek" или "qwen" или "custom" |
✅ Да |
exchange |
Используемая биржа | "binance" или "hyperliquid" или "aster" |
✅ Да |
binance_api_key |
Binance API ключ | "abc123..." |
Требуется при использовании Binance |
binance_secret_key |
Binance Secret ключ | "xyz789..." |
Требуется при использовании Binance |
hyperliquid_private_key |
Hyperliquid приватный ключ ⚠️ Удалите префикс 0x |
"your_key..." |
Требуется при использовании Hyperliquid |
hyperliquid_wallet_addr |
Hyperliquid адрес кошелька | "0xabc..." |
Требуется при использовании Hyperliquid |
hyperliquid_testnet |
Использовать тестнет | true или false |
❌ Нет (по умолчанию false) |
use_qwen |
Использовать ли Qwen | true или false |
✅ Да |
deepseek_key |
DeepSeek API ключ | "sk-xxx" |
Требуется при использовании DeepSeek |
qwen_key |
Qwen API ключ | "sk-xxx" |
Требуется при использовании Qwen |
initial_balance |
Начальный баланс для расчета P/L | 1000.0 |
✅ Да |
scan_interval_minutes |
Частота решений (минуты) | 3 (рекомендуется 3-5) |
✅ Да |
leverage |
Конфигурация плеча (v2.0.3+) | См. ниже | ✅ Да |
btc_eth_leverage |
Максимальное плечо для BTC/ETH ⚠️ Субаккаунты: ≤5x |
5 (по умолчанию, безопасно)50 (максимум для основного аккаунта) |
✅ Да |
altcoin_leverage |
Максимальное плечо для альткоинов ⚠️ Субаккаунты: ≤5x |
5 (по умолчанию, безопасно)20 (максимум для основного аккаунта) |
✅ Да |
use_default_coins |
Использовать встроенный список монет ✨ Умное значение по умолчанию: true (v2.0.2+)Автоматически включается без API |
true или опустить |
❌ Нет (Опционально, авто) |
coin_pool_api_url |
API пользовательского пула монет Требуется только при use_default_coins: false |
"" (пусто) |
❌ Нет |
oi_top_api_url |
API открытого интереса Опциональные дополнительные данные |
"" (пусто) |
❌ Нет |
api_server_port |
Порт веб-панели | 8080 |
✅ Да |
Монеты по умолчанию для торговли (когда use_default_coins: true):
- BTC, ETH, SOL, BNB, XRP, DOGE, ADA, HYPE
⚙️ Конфигурация плеча (v2.0.3+)
Что такое конфигурация плеча?
Настройки плеча контролируют максимальное плечо, которое AI может использовать для каждой сделки. Это критически важно для управления рисками, особенно для субаккаунтов Binance, которые имеют ограничения по плечу.
Формат конфигурации:
"leverage": {
"btc_eth_leverage": 5, // Максимальное плечо для BTC и ETH
"altcoin_leverage": 5 // Максимальное плечо для всех других монет
}
⚠️ Важно: Ограничения субаккаунтов Binance
- Субаккаунты: Ограничены ≤5x плечом от Binance
- Основные аккаунты: Могут использовать до 20x (альткоины) или 50x (BTC/ETH)
- Если вы используете субаккаунт и установите плечо >5x, сделки будут завершаться с ошибкой:
Subaccounts are restricted from using leverage greater than 5x
Рекомендуемые настройки:
| Тип аккаунта | Плечо BTC/ETH | Плечо альткоинов | Уровень риска |
|---|---|---|---|
| Субаккаунт | 5 |
5 |
✅ Безопасно (по умолчанию) |
| Основной (Консервативно) | 10 |
10 |
🟡 Средний |
| Основной (Агрессивно) | 20 |
15 |
🔴 Высокий |
| Основной (Максимум) | 50 |
20 |
🔴🔴 Очень высокий |
Примеры:
Безопасная конфигурация (субаккаунт или консервативная):
"leverage": {
"btc_eth_leverage": 5,
"altcoin_leverage": 5
}
Агрессивная конфигурация (только основной аккаунт):
"leverage": {
"btc_eth_leverage": 20,
"altcoin_leverage": 15
}
Как AI использует плечо:
- AI может выбрать любое плечо от 1x до вашего настроенного максимума
- Например, с
altcoin_leverage: 20, AI может решить использовать 5x, 10x или 20x в зависимости от рыночных условий - Конфигурация устанавливает верхний лимит, а не фиксированное значение
- AI учитывает волатильность, соотношение риск/доход и баланс аккаунта при выборе плеча
⚠️ Важно: Поле use_default_coins
Умное поведение по умолчанию (v2.0.2+):
Система теперь автоматически устанавливает use_default_coins: true, если:
- Вы не включили это поле в config.json, или
- Вы установили его в
false, но не предоставилиcoin_pool_api_url
Это делает систему более дружелюбной для новичков! Вы даже можете полностью опустить это поле.
Примеры конфигурации:
✅ Вариант 1: Явное указание (Рекомендуется для ясности)
"use_default_coins": true,
"coin_pool_api_url": "",
"oi_top_api_url": ""
✅ Вариант 2: Опустить поле (Автоматически использует монеты по умолчанию)
// Не включать "use_default_coins" вообще
"coin_pool_api_url": "",
"oi_top_api_url": ""
⚙️ Расширенное: Использовать внешний API
"use_default_coins": false,
"coin_pool_api_url": "http://your-api.com/coins",
"oi_top_api_url": "http://your-api.com/oi"
6. Запуск системы
🚀 Запуск системы (2 шага)
Система состоит из 2 частей, которые необходимо запустить отдельно:
- Backend (AI торговый мозг + API)
- Frontend (Веб-панель мониторинга)
Шаг 1: Запустите Backend
Откройте терминал и выполните:
# Соберите программу (первый запуск или после изменений кода)
go build -o nofx
# Запустите backend
./nofx
Вы должны увидеть:
🚀 Запуск системы автоматической торговли...
✓ Трейдер [my_trader] инициализирован
✓ API сервер запущен на порту 8080
📊 Начинается мониторинг торговли...
⚠️ Если видите ошибки:
| Сообщение об ошибке | Решение |
|---|---|
invalid API key |
Проверьте Binance API ключи в config.json |
TA-Lib not found |
Выполните brew install ta-lib (macOS) |
port 8080 already in use |
api_server_port в config.jsonAPI_PORT в файле .env |
DeepSeek API error |
Проверьте DeepSeek API ключ и баланс |
✅ Признаки работы Backend:
- Нет сообщений об ошибках
- Появляется "Начинается мониторинг торговли..."
- Система показывает баланс аккаунта
- Держите это окно терминала открытым!
Шаг 2: Запустите Frontend
Откройте новое окно терминала (держите первое открытым!), затем:
cd web
npm run dev
Вы должны увидеть:
VITE v5.x.x ready in xxx ms
➜ Local: http://localhost:3000/
➜ Network: use --host to expose
✅ Признаки работы Frontend:
- Сообщение "Local: http://localhost:3000/"
- Нет сообщений об ошибках
- Также держите это окно терминала открытым!
Шаг 3: Доступ к панели
Откройте в веб-браузере:
Вы увидите:
- 📊 Баланс аккаунта в реальном времени
- 📈 Позиции (если есть)
- 🤖 AI логи решений
- 📉 График капитала
Подсказки для первого использования:
- Первое AI решение может занять 3-5 минут
- Начальное решение может показать "наблюдение" - это нормально
- AI должен сначала проанализировать рынок
7. Мониторинг системы
Что отслеживать:
✅ Признаки здоровой системы:
- Backend терминал показывает циклы решений каждые 3-5 минут
- Нет постоянных сообщений об ошибках
- Обновляется баланс аккаунта
- Веб-панель автоматически обновляется
⚠️ Признаки предупреждения:
- Повторяющиеся API ошибки
- Нет решений более 10 минут
- Быстро падающий баланс
Проверка состояния системы:
# В новом окне терминала
curl http://localhost:8080/api/health
Должно вернуть: {"status":"ok"}
8. Остановка системы
Изящное завершение (Рекомендуется):
- Перейдите к Backend терминалу (первому)
- Нажмите
Ctrl+C - Дождитесь сообщения "Система остановлена"
- Перейдите к Frontend терминалу (второму)
- Нажмите
Ctrl+C
⚠️ Важно:
- Всегда останавливайте backend первым
- Дождитесь подтверждения перед закрытием терминалов
- Не принудительно завершайте (не закрывайте терминалы сразу)
📖 Процесс принятия решений AI
Каждый цикл принятия решений (по умолчанию 3 минуты), система работает по следующему процессу:
Шаг 1: 📊 Анализ исторической производительности (последние 20 циклов)
- ✓ Расчет общего процента выигрышей, средней прибыли, соотношения прибыли/убытка
- ✓ Статистика по каждой монете (процент выигрышей, средний P/L в USDT)
- ✓ Определение лучших/худших монет по производительности
- ✓ Список деталей последних 5 сделок с точным P/L
- ✓ Расчет коэффициента Шарпа для оценки риска
- 📌 НОВОЕ (v2.0.2): Точный P/L в USDT с учетом плеча
↓
Шаг 2: 💰 Получение состояния аккаунта
- Капитал аккаунта, доступный баланс, нереализованный P/L
- Количество позиций, общий P/L (реализованный + нереализованный)
- Использование маржи (текущее/максимальное)
- Индикаторы оценки риска
↓
Шаг 3: 🔍 Анализ существующих позиций (если есть)
- Получение рыночных данных для каждой позиции (3-минутные + 4-часовые свечи)
- Расчет технических индикаторов (RSI, MACD, EMA)
- Отображение длительности удержания позиции (например, "удерживается 2 часа 15 минут")
- AI определяет, нужно ли закрыть (тейк-профит, стоп-лосс или корректировка)
- 📌 НОВОЕ (v2.0.2): Отслеживание длительности позиции помогает AI решать
↓
Шаг 4: 🎯 Оценка новых возможностей (пул кандидатов монет)
- Получение пула монет (2 режима):
- 🌟 Режим по умолчанию: BTC, ETH, SOL, BNB, XRP и т.д.
- ⚙️ Расширенный режим: AI500 (топ-20) + OI Top (топ-20)
- Объединение, удаление дубликатов, фильтрация монет с низкой ликвидностью (OI < 15M USD)
- Массовое получение рыночных данных и технических индикаторов
- Подготовка полных последовательностей сырых данных для каждой монеты-кандидата
↓
Шаг 5: 🧠 Комплексное решение AI
- Просмотр исторической обратной связи (процент выигрышей, коэффициент P/L, лучшие/худшие монеты)
- Получение всех данных последовательностей (свечи, индикаторы, открытый интерес)
- Анализ Chain of Thought
- Вывод решения: закрыть/открыть/удерживать/наблюдать
- Включает параметры плеча, размера, стоп-лосса, тейк-профита
- 📌 НОВОЕ (v2.0.2): AI может свободно анализировать сырые последовательности, не ограничен заранее определенными индикаторами
↓
Шаг 6: ⚡ Исполнение сделок
- Приоритизация: сначала закрытие, затем открытие
- Автоматическая адаптация точности (правила LOT_SIZE)
- Предотвращение накопления позиций (отклонение дублирования монета/направление)
- Автоматическая отмена всех ордеров после закрытия
- Запись времени открытия для отслеживания длительности позиции
- 📌 Отслеживание времени открытия позиции
↓
Шаг 7: 📝 Запись логов
- Сохранение полной записи решения в
decision_logs/ - Включает цепочку рассуждений, JSON решения, снимок аккаунта, результаты исполнения
- Хранение полных данных позиции (количество, плечо, время открытия/закрытия)
- Использование ключей
symbol_sideдля предотвращения конфликтов лонг/шорт - 📌 НОВОЕ (v2.0.2): Предотвращение конфликтов при удержании лонг + шорт, учет количества + плеча
↓
🔄 (Повтор каждые 3-5 минут)
Ключевые улучшения в v2.0.2
📌 Отслеживание длительности позиции:
- Система теперь отслеживает, как долго каждая позиция удерживается
- Отображается в промпте пользователя: "удерживается 2 часа 15 минут"
- Помогает AI принимать лучшие решения о том, когда выйти
📌 Точный расчет P/L:
- Ранее: Только процент (100U@5% = 1000U@5% = оба показывали "5.0")
- Теперь: Реальная прибыль в USDT = Стоимость позиции × Изменение цены × Плечо
- Пример: 1000 USDT × 5% × 20x = 1000 USDT фактической прибыли
📌 Расширенная свобода AI:
- AI может свободно анализировать все данные сырых последовательностей
- Больше не ограничен заранее определенными комбинациями индикаторов
- Может выполнять собственный анализ трендов, расчет поддержки/сопротивления
📌 Улучшенное отслеживание позиций:
- Использует ключ
symbol_side(например, "BTCUSDT_long") - Предотвращает конфликты при одновременном удержании лонг и шорт
- Хранит полные данные: количество, плечо, время открытия/закрытия
⚠️ Важные предупреждения о рисках
Торговые риски
- Рынки криптовалют чрезвычайно волатильны, решения AI не гарантируют прибыль
- Торговля фьючерсами использует плечо, убытки могут превысить основную сумму
- Экстремальные рыночные условия могут привести к ликвидации
- Комиссии за финансирование могут повлиять на стоимость удержания
- Риск ликвидности: Некоторые монеты могут испытывать проскальзывание
Технические риски
- Задержка сети может вызвать проскальзывание цены
- Лимиты API могут повлиять на исполнение сделок
- Тайм-ауты AI API могут вызвать сбои решений
- Системные ошибки могут вызвать неожиданное поведение
Рекомендации по использованию
✅ Рекомендуется
- Используйте только средства, потерю которых вы можете позволить для тестирования
- Начните с небольших сумм (рекомендуется 100-500 USDT)
- Регулярно проверяйте состояние работы системы
- Отслеживайте изменения баланса счета
- Анализируйте логи решений AI для понимания стратегии
❌ Не рекомендуется
- Инвестировать все средства или заемные деньги
- Запускать без присмотра на длительные периоды
- Слепо доверять решениям AI
- Использовать без понимания системы
- Запускать во время экстремальной волатильности рынка
🛠️ Частые проблемы
1. Ошибка компиляции: TA-Lib не найдена
Решение: Установите библиотеку TA-Lib
# macOS
brew install ta-lib
# Ubuntu
sudo apt-get install libta-lib0-dev
2. Ошибка точности: Точность превышает максимум
Решение: Система автоматически обрабатывает точность из Binance LOT_SIZE. Если ошибка сохраняется, проверьте сетевое подключение.
3. Тайм-аут AI API
Решение:
- Проверьте правильность API ключа
- Проверьте сетевое подключение (может потребоваться прокси)
- Тайм-аут системы установлен на 120 секунд
4. Frontend не может подключиться к backend
Решение:
- Убедитесь, что backend запущен (http://localhost:8080)
- Проверьте, не занят ли порт 8080
- Проверьте ошибки в консоли браузера
5. Сбой API пула монет
Решение:
- API пула монет опционален
- Если API не работает, система использует основные монеты по умолчанию (BTC, ETH и т.д.)
- Проверьте URL API и параметр auth в config.json
📄 Лицензия
Лицензия MIT - См. файл LICENSE для деталей
🤝 Вклад в проект
Приветствуются Issues и Pull Requests!
Руководство по разработке
- Сделайте Fork проекта
- Создайте ветку функции (
git checkout -b feature/AmazingFeature) - Зафиксируйте изменения (
git commit -m 'Add some AmazingFeature') - Отправьте в ветку (
git push origin feature/AmazingFeature) - Откройте Pull Request
📬 Контакты
- Twitter/X: @Web3Tinkle
- GitHub Issues: Создать Issue
🙏 Благодарности
- Binance API - Binance Futures API
- DeepSeek - DeepSeek AI API
- Qwen - Alibaba Cloud Qwen
- TA-Lib - Библиотека технических индикаторов
- Recharts - Библиотека графиков React
🔄 Журнал Изменений
📖 Для подробной истории версий и обновлений см.:
- Русский: CHANGELOG.zh-CN.md
- English: CHANGELOG.md
Последняя Версия: v3.0.0 (2025-10-30) - Масштабная Трансформация Архитектуры
Недавние Основные Моменты:
- 🚀 Полная переработка системы с веб-конфигурацией
- 🗄️ Архитектура на основе базы данных (SQLite)
- 🎨 Никакого редактирования JSON - вся конфигурация через веб-интерфейс
- 🔧 Комбинируйте AI модели с любой биржей
- 📊 Расширенный API слой с комплексными эндпоинтами
- 🔐 Аутентификация JWT + поддержка 2FA
- 🌐 Поддержка кастомных API (совместимых с OpenAI)
- 📈 Система шаблонов промптов с удаленной аутентификацией
⚡ Исследуйте возможности количественной торговли с силой AI!