nofx/README.uk.md

🤖 NOFX - AI-керована система автоматичної торгівлі ф'ючерсами Binance

Мови / Languages: English | 中文 | Українська | Русский

---

Автоматизована система торгівлі ф'ючерсами Binance на базі DeepSeek/Qwen AI, що підтримує змагання кількох AI-моделей у реальній торгівлі, з повним аналізом ринку, прийняттям рішень AI, механізмом самонавчання та професійним веб-інтерфейсом моніторингу.

⚠️ Попередження про ризики: Ця система експериментальна. Автоматична торгівля з AI несе значні ризики. Наполегливо рекомендується використовувати лише для навчання/досліджень або тестування з невеликими сумами!

---

✨ Основні можливості

🏆 Режим змагання кількох 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 капітал рахунку
• Фіксоване плече: Альткоїни 20x | BTC/ETH 50x
• Управління маржею: Загальне використання ≤90%, AI приймає автономні рішення
• Співвідношення ризик/дохід: Обов'язкове ≥1:2 (стоп-лосс:тейк-профіт)
• Запобігання накопиченню позицій: Заборона дублювання відкриття тієї ж монети/напрямку

🎨 Професійний UI

• Професійний торговий інтерфейс: Візуальний дизайн у стилі Binance
• Темна тема: Класична колірна схема (Золотий #F0B90B + темний фон)
• Дані в реальному часі: Оновлення кожні 5 секунд для рахунків, позицій, графіків
• Крива капіталу: Графік історичного тренду вартості рахунку (перемикання USD/відсоток)
• Графік порівняння продуктивності: Порівняння ROI кількох AI в реальному часі
• Плавні анімації: Плавні ефекти наведення, переходів та завантаження

📝 Повний запис рішень

• Ланцюг міркувань: Повний процес міркувань AI (CoT)
• Історична продуктивність: Загальний відсоток виграшів, середній прибуток, співвідношення прибутку/збитку
• Останні угоди: Деталі останніх 5 угод (ціна входу → ціна виходу → P/L%)
• Статистика по монетах: Продуктивність по кожній монеті (відсоток виграшів, середній P/L)
• JSON логи: Повні записи рішень для пост-аналізу

---

🚀 Швидкий старт

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. Конфігурація системи

Створіть файл config.json (використовуйте config.json.example як шаблон):

{
  "traders": [
    {
      "id": "qwen_trader",
      "name": "Qwen AI Trader",
      "ai_model": "qwen",
      "binance_api_key": "ВАШ_BINANCE_API_KEY",
      "binance_secret_key": "ВАШ_BINANCE_SECRET_KEY",
      "use_qwen": true,
      "qwen_key": "sk-xxxxx",
      "scan_interval_minutes": 3,
      "initial_balance": 1000.0
    },
    {
      "id": "deepseek_trader",
      "name": "DeepSeek AI Trader",
      "ai_model": "deepseek",
      "binance_api_key": "ВАШ_BINANCE_API_KEY_2",
      "binance_secret_key": "ВАШ_BINANCE_SECRET_KEY_2",
      "use_qwen": false,
      "deepseek_key": "sk-xxxxx",
      "scan_interval_minutes": 3,
      "initial_balance": 1000.0
    }
  ],
  "coin_pool_api_url": "http://x.x.x.x:xxx/api/ai500/list?auth=ВАШ_AUTH",
  "oi_top_api_url": "http://x.x.x.x:xxx/api/oi/top?auth=ВАШ_AUTH",
  "api_server_port": 8080
}

5. Запуск системи

Запуск backend (система AI торгівлі + API сервер):

go build -o nofx
./nofx

Запуск frontend (веб-панель):

Відкрийте новий термінал:

cd web
npm run dev

Доступ до інтерфейсу:

Веб-панель: http://localhost:3000
API сервер: http://localhost:8080

6. Зупинка системи

Натисніть Ctrl+C в обох терміналах

---

⚠️ Важливі попередження про ризики

Торговельні ризики

1. Ринки криптовалют надзвичайно волатильні, рішення AI не гарантують прибуток
2. Торгівля ф'ючерсами використовує плече, збитки можуть перевищити основну суму
3. Екстремальні ринкові умови можуть призвести до ліквідації
4. Комісії за фінансування можуть вплинути на вартість утримання
5. Ризик ліквідності: Деякі монети можуть відчувати проковзування

Технічні ризики

1. Затримка мережі може викликати проковзування ціни
2. Ліміти API можуть вплинути на виконання угод
3. Тайм-аути AI API можуть викликати збої рішень
4. Системні помилки можуть викликати неочікувану поведінку

Рекомендації щодо використання

✅ Рекомендується

• Використовуйте лише кошти, втрату яких ви можете дозволити для тестування
• Почніть з невеликих сум (рекомендується 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!

Керівництво з розробки

1. Зробіть Fork проєкту
2. Створіть гілку функції (git checkout -b feature/AmazingFeature)
3. Зафіксуйте зміни (git commit -m 'Add some AmazingFeature')
4. Надішліть до гілки (git push origin feature/AmazingFeature)
5. Відкрийте 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

---

🔄 Історія змін

v2.0.1 (2025-10-29)

Виправлення помилок:

• ✅ Виправлено логіку обробки даних ComparisonChart - перехід від групування по cycle_number до timestamp
• ✅ Вирішено проблему заморожування графіка при перезапуску backend та скиданні cycle_number
• ✅ Покращено відображення даних графіка - тепер показує всі історичні точки в хронологічному порядку
• ✅ Покращені відладочні логи для кращої діагностики

v2.0.0 (2025-10-28)

Основні оновлення:

• ✅ Механізм самонавчання AI (історичний аналіз, аналіз продуктивності)
• ✅ Режим змагання кількох трейдерів (Qwen vs DeepSeek)
• ✅ UI в стилі Binance (повна імітація інтерфейсу Binance)
• ✅ Графіки порівняння продуктивності (порівняння ROI в реальному часі)
• ✅ Оптимізація контролю ризиків (коригування ліміту позиції по монетах)

---

Останнє оновлення: 2025-10-29

⚡ Досліджуйте можливості кількісної торгівлі з силою AI!