mirror of
https://github.com/NoFxAiOS/nofx.git
synced 2026-07-12 23:36:55 +08:00
Add multi-language README support
- Add English README.md with language switcher - Add Chinese README.zh-CN.md (中文版) - Add Ukrainian README.uk.md (Українська версія) - Add Russian README.ru.md (Русская версия) - Each README includes language navigation links - Covers all core features, installation, and usage
This commit is contained in:
tinkle
291
README.uk.md
Normal file
291
README.uk.md
Normal file
@@ -0,0 +1,291 @@
|
||||
# 🤖 NOFX - AI-керована система автоматичної торгівлі ф'ючерсами Binance
|
||||
|
||||
[](https://golang.org/)
|
||||
[](https://reactjs.org/)
|
||||
[](https://www.typescriptlang.org/)
|
||||
[](LICENSE)
|
||||
|
||||
**Мови / Languages:** [English](README.md) | [中文](README.zh-CN.md) | [Українська](README.uk.md) | [Русский](README.ru.md)
|
||||
|
||||
---
|
||||
|
||||
Автоматизована система торгівлі ф'ючерсами 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:**
|
||||
```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
|
||||
|
||||
---
|
||||
|
||||
## 📬 Контакти
|
||||
|
||||
Для питань або пропозицій, будь ласка, створіть [GitHub 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
|
||||
|
||||
---
|
||||
|
||||
**Останнє оновлення**: 2025-10-28
|
||||
|
||||
**⚡ Досліджуйте можливості кількісної торгівлі з силою AI!**
|
||||
Reference in New Issue
Block a user