nofx/README.uk.md

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

[![Go Version](https://img.shields.io/badge/Go-1.21+-00ADD8?style=flat&logo=go)](https://golang.org/)
[![React](https://img.shields.io/badge/React-18+-61DAFB?style=flat&logo=react)](https://reactjs.org/)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-3178C6?style=flat&logo=typescript)](https://www.typescriptlang.org/)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

**Мови / Languages:** [English](README.md) | [中文](README.zh-CN.md) | [Українська](README.uk.md) | [Русский](README.ru.md)

---

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

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

## 👥 Спільнота розробників

Приєднуйтесь до нашої спільноти розробників у Telegram для обговорення, обміну ідеями та отримання підтримки:

**💬 [Спільнота розробників NOFX](https://t.me/nofx_dev_community)**

---

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

### 🏆 Режим змагання кількох 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 логи**: Повні записи рішень для пост-аналізу

---

## 💰 Реєстрація акаунта Binance (Заощаджуйте на комісіях!)

Перед використанням цієї системи вам потрібен акаунт Binance Futures. **Використовуйте наше реферальне посилання для отримання знижки на комісії:**

**🎁 [Зареєструватися на Binance - Отримати знижку](https://www.binance.com/join?ref=TINKLEVIP)**

### Кроки реєстрації:

1. **Натисніть на посилання вище** щоб перейти на сторінку реєстрації Binance
2. **Завершіть реєстрацію** використовуючи email/номер телефону
3. **Пройдіть KYC верифікацію** (потрібно для торгівлі ф'ючерсами)
4. **Активуйте акаунт Futures**:
   - Перейдіть на головну сторінку Binance → Деривативи → USD-M Ф'ючерси
   - Натисніть "Відкрити зараз" для активації торгівлі ф'ючерсами
5. **Створіть API ключ**:
   - Перейдіть в Акаунт → Управління API
   - Створіть новий API ключ, **увімкніть дозвіл "Futures"**
   - Збережіть API Key та Secret Key (необхідно для config.json)
   - **Важливо**: Додайте свою IP адресу до білого списку для безпеки

### Переваги знижки:

- ✅ **Спотова торгівля**: Знижка до 30% на комісії
- ✅ **Торгівля ф'ючерсами**: Знижка до 30% на комісії
- ✅ **Довічна**: Постійна знижка на всі угоди

---

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

### 1. Вимоги до середовища

- **Go 1.21+**
- **Node.js 18+**
- **TA-Lib** бібліотека (розрахунок технічних індикаторів)

#### Встановлення TA-Lib

**macOS:**
```bash
brew install ta-lib
```

**Ubuntu/Debian:**
```bash
sudo apt-get install libta-lib0-dev
```

**Інші системи**: Див. [Офіційну документацію TA-Lib](https://github.com/markcheno/go-talib)

### 2. Клонування проєкту

```bash
git clone https://github.com/tinkle-community/nofx.git
cd nofx
```

### 3. Встановлення залежностей

**Backend:**
```bash
go mod download
```

**Frontend:**
```bash
cd web
npm install
cd ..
```

### 4. Конфігурація системи

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

```json
{
  "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 сервер):**

```bash
go build -o nofx
./nofx
```

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

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

```bash
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
```bash
# 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](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](https://x.com/Web3Tinkle)
- **GitHub Issues**: [Створити Issue](https://github.com/tinkle-community/nofx/issues)

---

## 🙏 Подяки

- [Binance API](https://binance-docs.github.io/apidocs/futures/en/) - Binance Futures API
- [DeepSeek](https://platform.deepseek.com/) - DeepSeek AI API
- [Qwen](https://dashscope.aliyuncs.com/) - Alibaba Cloud Qwen
- [TA-Lib](https://ta-lib.org/) - Бібліотека технічних індикаторів
- [Recharts](https://recharts.org/) - Бібліотека графіків 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!**