USER_GUIDE.md•20.5 kB
# 📖 Руководство Пользователя: Как Использовать AI Trading Agent
## 🎯 Что Это За Система?
Это **AI-ассистент трейдера**, который работает прямо в Cursor IDE. Он:
- ✅ Анализирует рынок по вашему запросу
- ✅ Находит безопасные точки входа (confluence ≥8/10)
- ✅ Объясняет каждое решение детально
- ✅ Предлагает сделки, но **ВЫ принимаете решение**
- ✅ Мониторит открытые позиции
**НЕ делает:**
- ❌ Автономную торговлю без вашего разрешения
- ❌ Гарантии прибыли
- ❌ Решения за вас
---
## 🚀 Быстрый Старт
### Шаг 1: Первый Запрос (30 секунд)
Просто напишите в чате Cursor:
```
"Проверь BTC - как обстановка на рынке?"
```
Агент:
1. Проверит цену BTC
2. Оценит тренд
3. Дам краткий обзор
**Ожидаемый ответ:**
```
📊 BTC: $50,250 (+1.2% за 24h)
📈 Trend: Восходящий на 1h, консолидация на 4h
🎯 RSI: 56 (нейтральный, здоровый)
💡 Ближайшая поддержка: $49,800
Сопротивление: $51,000
Вывод: Стабилен, небольшой uptrend. Безопасно для alt longs.
```
---
### Шаг 2: Полный Анализ Рынка (5-10 минут)
Напишите:
```
"Найди точки входа на рост"
```
или
```
"Проанализируй рынок и найди лучшие возможности"
```
**Что делает агент:**
1. **Проверяет BTC** (всегда первым!)
2. **Определяет market regime** (trending_up / trending_down / ranging)
3. **Сканирует рынок** (анализирует 50+ активов)
4. **Фильтрует по качеству** (score ≥7.0)
5. **Deep Dive для топ-кандидатов** (score ≥8.0)
6. **Smart Money проверки** (CVD, Order Blocks)
7. **Самопроверка** (проходит чеклист)
8. **Представляет результаты** (структурированный отчет)
**Ожидаемый формат ответа:**
```
🔍 ГЛУБОКИЙ АНАЛИЗ РЫНКА
📊 Рыночные данные [14:30]
• BTC: $50,250 (+1.2%) - стабилен ✅
• Market Sentiment: Умеренно бычий (62% green)
• Проанализировано: 47 активов
📈 LONG ВОЗМОЖНОСТИ:
1️⃣ ETH/USDT Long
💡 ДОСКОНАЛЬНО ОБЪЯСНЯЮ ЛОГИКУ:
• Почему ETH: RSI oversold (24), у сильной поддержки $3,000
• Почему сейчас: Формируется бычья свеча, volume spike
• Confluence: 8.5/10
✅ Trend alignment (все TF bullish)
✅ RSI oversold (24)
✅ Volume confirmation (1.8x avg)
✅ У поддержки ($3,000)
✅ BTC stable
✅ Паттерн Hammer
✅ MACD bullish crossover
✅ ADX strong (32)
✅ CVD bullish absorption ⚡
✅ Цена в Order Block ⚡
🔍 САМОПРОВЕРКА:
✅ Все таймфреймы проверены
✅ 9/10 индикаторов подтверждают
✅ Нет противоречащих паттернов
✅ S/R уровни определены
✅ BTC не показывает слабость
✅ R:R = 1:2.5
✅ Риск = 1% ($0.30)
✅ Probability = 73%
⚡ ДЕТАЛЬНЫЙ ПЛАН СДЕЛКИ:
• Entry: $3,000 (текущая цена у поддержки)
• Stop-Loss: $2,920 (ниже EMA50 и Order Block)
• Take-Profit: $3,150 (сопротивление на 4h)
• Risk/Reward: 1:2.5
• Position size: 0.01 ETH (риск $0.30 = 1%)
• Safe time window: 12 часов
⚠️ ЧТО МОЖЕТ ПОЙТИ НЕ ТАК:
• Риск #1: BTC разворот → План: Exit если BTC -1.5%
• Риск #2: Rejection от $3,100 → План: Partial exit 50% на $3,100
✅ МОЯ РЕКОМЕНДАЦИЯ: ОТКРЫВАТЬ
Confluence 8.5/10, вероятность 73%, R:R 1:2.5
Это качественный setup с минимальным риском.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📉 SHORT ВОЗМОЖНОСТИ:
1️⃣ SOL/USDT Short
[Аналогичный детальный анализ]
✅ МОЯ РЕКОМЕНДАЦИЯ: ПОДОЖДАТЬ
Confluence только 6.5/10 - недостаточно для входа.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💰 ОБЩИЙ РИСК ПОРТФЕЛЯ: 1%
🎯 CONFIDENCE В АНАЛИЗЕ: 8.5/10
🤔 ОТКРЫВАЕМ ETH Long?
```
---
## 📋 Типовые Сценарии Использования
### Сценарий 1: Утренний Анализ (9:00 AM)
**Ваш запрос:**
```
"Доброе утро! Проанализируй рынок на сегодня"
```
**Что делает агент:**
- Проверяет BTC статус
- Market overview
- Определяет regime
- Сканирует возможности
- Выдаёт топ 2-3 setup или говорит "подождать"
**Время:** 5-10 минут
---
### Сценарий 2: Проверка Конкретного Актива
**Ваш запрос:**
```
"Что думаешь про ETH? Хочу long на $3,000"
```
**Что делает агент:**
- Получает данные ETH
- Multi-timeframe анализ
- Индикаторы (RSI, MACD, etc.)
- Паттерны и S/R уровни
- Confluence scoring
- Вердикт: РЕКОМЕНДУЮ или НЕ РЕКОМЕНДУЮ с объяснением
**Время:** 2-3 минуты
---
### Сценарий 3: Мониторинг Открытых Позиций
**Ваш запрос:**
```
"Как мои позиции?"
```
или
```
"Статус ETH Long"
```
**Что делает агент:**
- Проверяет все открытые позиции
- Анализирует прогресс к TP
- Проверяет индикаторы
- Даёт update с рекомендациями
- Использует CTA скрипты для критических моментов
**Пример ответа:**
```
⏱️ 14:45 | ETH/USDT Long Update
💰 P/L: +2.1% ($0.63) ✅
📊 Current: $3,063 (Entry: $3,000)
SL: $2,920 | TP: $3,150
Progress: 39% к TP1 (4.5h / 12h safe window)
📈 Indicators:
• RSI: 59 → 62 (momentum strengthening) ✅
• MACD: Histogram growing ✅
• Volume: 1.4x avg (good support) ✅
🎯 Status: 🟢 Healthy - on track
▶️ Action: HOLD - все factors positive
Next check: 16:00 (при достижении 1:1 R:R)
```
**Критические CTA:**
Если позиция близко к SL:
```
🚨 КРИТИЧЕСКОЕ ПРЕДУПРЕЖДЕНИЕ - ТРЕБУЕТСЯ ДЕЙСТВИЕ!
ETH Long: Цена $2,925 → Stop Loss $2,920 (осталось 0.5% = $5)
⏰ ТВОЯ ЗАДАЧА ПРЯМО СЕЙЧАС:
1. Открой график ETH на 15m
2. Проверь: есть ли признаки разворота?
3. Решение в течение 5 минут
📱 Поставь таймер на 5 минут.
```
Если достигнут TP1:
```
💰 ПРИБЫЛЬ ДОСТИГНУТА - ЗАФИКСИРУЙ СЕЙЧАС!
ETH Long: +3.5% ($1.05) ✅ TP1 достигнут!
🎯 ПЛАН ДЕЙСТВИЙ (выполни в течение 2 минут):
1. Закрой 50-60% позиции → Зафиксируй $0.60 прибыли
2. Переведи SL в breakeven → Риск = 0
3. Оставь 40-50% для TP2
✅ Готов зафиксировать? (Ответь "да" или "держу всё")
```
---
### Сценарий 4: Поиск Возможностей в Конкретном Направлении
**Ваш запрос:**
```
"Найди перепроданные активы для long"
```
или
```
"Есть ли возможности для short?"
```
**Что делает агент:**
- Использует специализированные инструменты:
- `find_oversold_assets()` для LONG
- `find_overbought_assets()` для SHORT
- `find_breakout_opportunities()`
- `find_trend_reversals()`
- Фильтрует по качеству
- Представляет топ-кандидатов
---
### Сценарий 5: Валидация Вашей Идеи
**Ваш запрос:**
```
"Хочу long BTC на $50,000, как думаешь?"
```
**Что делает агент:**
- Анализирует BTC по всем критериям
- Проверяет ваш entry price
- Рассчитывает оптимальные SL/TP
- Даёт вердикт: РЕКОМЕНДУЮ или НЕ РЕКОМЕНДУЮ
- Объясняет почему
---
## 🎯 Ключевые Команды
### Быстрые Команды
| Команда | Что делает | Время |
|---------|------------|-------|
| `"Проверь BTC"` | Краткий анализ BTC | 30 сек |
| `"Как рынок?"` | Market overview | 1-2 мин |
| `"Найди точки входа"` | Полный анализ рынка | 5-10 мин |
| `"Статус позиций"` | Мониторинг открытых | 1-2 мин |
| `"Анализ ETH"` | Детальный анализ актива | 2-3 мин |
### Специализированные Запросы
| Запрос | Инструмент |
|--------|------------|
| `"Найди перепроданные активы"` | `find_oversold_assets()` |
| `"Найди перекупленные активы"` | `find_overbought_assets()` |
| `"Пробои (breakouts)"` | `find_breakout_opportunities()` |
| `"Развороты тренда"` | `find_trend_reversals()` |
| `"Проверь ликвидность BTC"` | `check_liquidity("BTCUSDT")` |
| `"Корреляция ETH с BTC"` | `get_btc_correlation("ETH/USDT")` |
---
## ⚠️ Важные Правила
### Что Агент ВСЕГДА Делает:
1. ✅ **Проверяет BTC первым** (для любого анализа)
2. ✅ **Ищет в ОБЕ стороны** (LONG и SHORT)
3. ✅ **Анализирует минимум 50 активов** перед выводом "нет возможностей"
4. ✅ **Использует Smart Money tools** (CVD, Order Blocks) для топ-кандидатов
5. ✅ **Проходит самопроверку** перед рекомендацией
6. ✅ **Объясняет детально** каждое решение
### Что Агент НИКОГДА Не Делает:
1. ❌ Не предлагает сделки с confluence < 7/10
2. ❌ Не игнорирует BTC при анализе альткоинов
3. ❌ Не предлагает leverage > 3x для $30 депозита
4. ❌ Не входит против тренда старшего таймфрейма
5. ❌ Не предлагает сделки без чёткого SL
6. ❌ Не обещает гарантированную прибыль
---
## 💡 Советы по Эффективному Использованию
### 1. Будьте Конкретны
❌ Плохо: `"Проанализируй рынок"`
✅ Хорошо: `"Найди точки входа на рост с confluence ≥8"`
❌ Плохо: `"Что думаешь про ETH?"`
✅ Хорошо: `"Валидация ETH long на $3,000 - стоит ли входить?"`
### 2. Используйте Правильные Запросы
**Для полного анализа:**
```
"Проведи полный анализ рынка и найди лучшие возможности"
```
**Для быстрой проверки:**
```
"Быстрый чек BTC - как обстановка?"
```
**Для мониторинга:**
```
"Статус всех открытых позиций"
```
### 3. Доверяйте, Но Проверяйте
- ✅ Агент даёт детальный анализ с объяснениями
- ✅ Проходит самопроверку через чеклист
- ✅ Показывает confluence score и probability
- ⚠️ **НО:** Вы принимаете финальное решение!
### 4. Учитесь на Анализе
Агент объясняет:
- Почему именно этот актив
- Почему именно сейчас
- Почему именно такие SL/TP
- Что может пойти не так
**Используйте это для обучения!**
---
## 📊 Понимание Результатов
### Confluence Score (0-10)
**Что это:**
- Оценка качества setup на основе 10+ факторов
- Чем выше, тем лучше
**Интерпретация:**
- **9-10:** Идеальный setup (редко)
- **8-8.9:** Отличный setup (рекомендуется)
- **7-7.9:** Хороший setup (можно, но осторожно)
- **6-6.9:** Слабый setup (не рекомендуется)
- **<6:** Плохой setup (избегать)
**Минимум для рекомендации:** 8.0/10
---
### Probability (0-100%)
**Что это:**
- Вероятность успеха сделки
- Основана на исторических данных и текущих условиях
**Интерпретация:**
- **>75%:** Очень высокая вероятность
- **70-75%:** Высокая вероятность (минимум для входа)
- **65-70%:** Средняя вероятность (осторожно)
- **<65%:** Низкая вероятность (не рекомендуется)
**Минимум для рекомендации:** 70%
---
### Risk/Reward (R:R)
**Что это:**
- Соотношение потенциальной прибыли к риску
- Пример: R:R 1:2 = риск $1, прибыль $2
**Интерпретация:**
- **1:3+:** Отличное соотношение
- **1:2-1:2.9:** Хорошее соотношение (минимум)
- **1:1.5-1:1.9:** Приемлемое (осторожно)
- **<1:1.5:** Плохое (не рекомендуется)
**Минимум для рекомендации:** 1:2
---
## 🎓 Примеры Диалогов
### Пример 1: Успешный Анализ
**Вы:**
```
"Найди точки входа на рост"
```
**Агент:**
```
[Полный анализ с 2-3 качественными setup]
✅ МОЯ РЕКОМЕНДАЦИЯ: ETH Long
Confluence 8.5/10, вероятность 73%, R:R 1:2.5
🤔 ОТКРЫВАЕМ?
```
**Вы:**
```
"Да, открывай ETH Long"
```
**Агент:**
```
✅ Позиция открыта!
📝 Рекомендую записать в trading journal:
- Дата: [date]
- Актив: ETH/USDT
- Direction: Long
- Entry: $3,000, SL: $2,920, TP: $3,150
- Confluence: 8.5/10
- Reasoning: [краткое объяснение]
Мониторинг запущен. Следующая проверка через 30 минут.
```
---
### Пример 2: "Нет Возможностей"
**Вы:**
```
"Найди точки входа"
```
**Агент:**
```
🤔 Проанализировал рынок.
Проверил 47 активов.
Нашёл 3 потенциальных setup:
• BTC: confluence 5.5/10 (недостаточно)
• ETH: confluence 6/10 (слабовато)
• SOL: confluence 6.5/10 (R:R только 1:1.3)
❌ Ни один не проходит мой чеклист качества
(минимум 7/10 + R:R 1:2).
Сейчас рынок:
• BTC в консолидации
• Волатильность низкая
• Нет чётких breakout signals
Рекомендация: ПОДОЖДИ 4-6 часов.
Часто после такой консолидации формируется breakout.
Я буду мониторить и сообщу когда появятся quality setups.
Лучше пропустить сомнительную сделку, чем потерять деньги! 💪
```
---
### Пример 3: Мониторинг с CTA
**Вы:**
```
"Статус ETH Long"
```
**Агент:**
```
⏱️ 15:30 | ETH/USDT Long Update
💰 P/L: +3.2% ($0.96) ✅
📊 Current: $3,096 (Entry: $3,000)
SL: $2,920 | TP: $3,150
Progress: 60% к TP (6h / 12h safe window)
📈 Indicators: Все positive ✅
🎯 Status: 🟢 Healthy
💰 ПРИБЫЛЬ ДОСТИГНУТА - ЗАФИКСИРУЙ СЕЙЧАС!
ETH Long: +3.2% ($0.96) ✅ TP1 близко!
🎯 ПЛАН ДЕЙСТВИЙ (выполни в течение 2 минут):
1. Закрой 50-60% позиции → Зафиксируй $0.50 прибыли
2. Переведи SL в breakeven → Риск = 0
3. Оставь 40-50% для TP2
✅ Готов зафиксировать? (Ответь "да" или "держу всё")
```
---
## 🚨 Частые Ошибки
### ❌ Ошибка 1: Слишком Общий Запрос
**Плохо:**
```
"Проанализируй"
```
**Хорошо:**
```
"Найди точки входа на рост с confluence ≥8"
```
---
### ❌ Ошибка 2: Игнорирование Рекомендаций
**Плохо:**
Агент говорит "подождать", вы всё равно входите.
**Хорошо:**
Доверяйте системе. Если confluence <8, лучше подождать.
---
### ❌ Ошибка 3: Не Мониторите Позиции
**Плохо:**
Открыли позицию и забыли про неё.
**Хорошо:**
Регулярно спрашивайте статус или используйте автоматический мониторинг.
---
### ❌ Ошибка 4: Игнорирование CTA
**Плохо:**
Агент говорит "закрой 50%", вы игнорируете.
**Хорошо:**
CTA появляются в критических моментах. Следуйте им!
---
## 📚 Дополнительные Ресурсы
### Файлы для Изучения
1. **`prompts/agent_core_instructions.md`**
- Полные инструкции для агента
- Понимание его логики работы
2. **`prompts/market_analysis_protocol_optimized.md`**
- Протокол анализа рынка
- Как агент находит возможности
3. **`prompts/position_monitoring_protocol.md`**
- Протокол мониторинга позиций
- CTA скрипты
4. **`knowledge_base/`**
- База знаний по трейдингу
- Методологии и стратегии
---
## 🎯 Чеклист Первого Дня
- [ ] Проверил BTC через агента
- [ ] Сделал первый полный анализ рынка
- [ ] Понял формат ответов агента
- [ ] Прочитал confluence score и probability
- [ ] Понял когда агент говорит "подождать"
- [ ] Готов начать использовать систему
---
## 💬 Поддержка
Если что-то непонятно:
1. Спросите агента: `"Объясни как работает confluence score"`
2. Прочитайте соответствующий файл в `prompts/` или `knowledge_base/`
3. Проверьте примеры в `USAGE_EXAMPLES.md`
---
**Версия:** 1.0
**Дата:** 2024
**Система:** AI Trading Agent для Bybit
*Удачной торговли! 🚀*