# Улучшение системы торговли Market Analyzer ## 🎯 Обзор Документ описывает комплексное улучшение системы торговли Market Analyzer, направленное на создание надежного, безопасного и функционального решения для управления сделками на MOEX через T-Bank API. ## 📋 Основные улучшения ### 1. Trade Executor Enhanced #### Что было до улучшений: - Базовый агент `@trade-executor` с минимальным функционалом - Ручное управление сделками - Отсутствие автоматизированных скриптов - Нет проверки баланса перед сделками #### Что стало после улучшений: - **Улучшенный агент** `trade-executor-enhanced` с полным циклом управления - **Автоматизированные скрипты** для всех операций - **Обязательная проверка баланса** перед любыми сделками - **Интеграция с существующими модулями** ### 2. Набор торговых скриптов #### Баланс и учёт - **`src/get_account_balance.py`** - Улучшенный скрипт для получения баланса - Автоматическое переключение окружения - Детальная информация о позициях - Fallback режим при недоступности API - Конвертация валют в рубли - **`get_real_account_balance.py`** - Легаси скрипт для обратной совместимости #### Создание сделок - **`src/create_trade_orders.py`** - Полностью автоматизированное создание сделок - Валидация параметров сделки - Расчёт размера позиции - Создание всех типов ордеров - Логирование в журнал сделок - Проверка достаточности капитала #### Управление сделками - **`src/manage_trade.py`** - Комплексное управление существующими сделками - Просмотр открытых сделок - Отмена сделок - Закрытие по рыночной цене - Модификация SL/TP - Мониторинг сделок #### Мониторинг позиций - **`src/monitor_trade.py`** - Универсальный монитор сделок - Детекция TP исполнения - Автоматический перевод SL в безубыточок - Проверка срабатывания SL - Учет торговых часов MOEX - Логирование всех событий ### 3. Архитектура системы ``` Market Trading System ├── Agents │ └── trade-executor-enhanced.md (улучшенный агент) ├── Scripts │ ├── src/get_account_balance.py (баланс) │ ├── src/create_trade_orders.py (создание сделок) │ ├── src/manage_trade.py (управление) │ └── src/monitor_trade.py (мониторинг) ├── API Integration │ └── src/api/tbank.py (T-Bank API) ├── Trade Management │ └── src/api/trade_journal.py (журнал сделок) └── Documentation ├── src/README.md (документация скриптов) └── trade-executor-example.md (пример использования) ``` ## 🔧 Технические детали ### Принцип работы агента 1. **Баланс Check (Обязательно)** ```python # Первое действие - проверка баланса python src/get_account_balance.py --env real ``` 2. **Выбор окружения** ```python # Запрос пользователя: sandbox или real set_tbank_env(env) ``` 3. **Валидация сигнала** - Проверка confidence ≥ 60% - Валидация SL/TP относительно направления - Проверка RR ≥ 2.0 4. **Создание сделки** ```python # Использование автоматизированного скрипта python src/create_trade_orders.py --ticker SBER --direction BUY --entry 100.0 --sl 95.0 --tp 110.0 ``` 5. **Мониторинг** ```python # Автоматический запуск мониторинга python src/monitor_trade.py --ticker SBER --trade-id --daemon ``` ### Безопасность #### Тестовый режим (Sandbox) - Виртуальные деньги - Никакого риска потери средств - Идеально для тестирования #### Реальный режим (Real) - Реальные деньги - Рыночное исполнение ордеров - Требует осторожности #### Защита от ошибок - Валидация всех параметров - Проверка достаточности капитала - Автоматический fallback при сбоях API - Логирование всех операций ## 📊 Примеры использования ### Полный цикл сделки ```bash # 1. Проверка баланса python src/get_account_balance.py --env real # 2. Создание сделки python src/create_trade_orders.py \ --ticker SBER \ --direction BUY \ --entry 245.50 \ --sl 240.00 \ --tp 255.00 \ --capital 100000 \ --risk 1.0 \ --confidence 75 \ --env real # 3. Мониторинг python src/monitor_trade.py \ --ticker SBER \ --trade-id \ --daemon \ --env real # 4. Управление python src/manage_trade.py --env real --list ``` ### Автоматизированный workflow через агента ```bash # Запуск агента opencode trade-executor-enhanced # Агент автоматически: # 1. Проверит баланс # 2. Запросит окружение # 3. Валидирует сигнал # 4. Создаст сделку # 5. Запустит мониторинг ``` ## 🚀 Преимущества новой системы ### 1. Безопасность - Обязательная проверка баланса - Валидация всех параметров - Защита от убыточных сделок - Четкое разделение sandbox/real ### 2. Автоматизация - Полностью автоматизированное создание сделок - Автоматический мониторинг - Автоматический перевод SL в безубыточок - Автоматическое логирование ### 3. Надежность - Fallback режимы при сбоях - Детальная логика всех операций - Проверка доступности API - Восстановление после ошибок ### 4. Гибкость - Поддержка любых тикеров - Настраиваемые параметры риск-менеджмента - Различные режимы мониторинга - Интеграция с существующими компонентами ### 5. Прозрачность - Детальная информация о балансе - Полное логирование всех операций - Четкое отображение P&L - История сделок в JSON формате ## 🔍 Интеграция с существующей системой ### С @tech-analyst - Агент получает сигналы из `reports/tickers/{TICKER}.md` - Использует confidence для валидации сделок - Соблюдает правила риск-менеджмента ### С @fund-analyst - Учитывает фундаментальный контекст - Корректирует параметры сделок - Соблюдает правила трехуровневого анализа ### С системой мониторинга - Автоматический запуск мониторинга после создания сделки - Интеграция с OrderBook Monitor - Использование исторических данных стакана ### С журналом сделок - Все сделки логируются в `reports/trades.json` - Поддержка истории сделок - Расчет статистики и P&L ## 📈 Производительность ### Скорость операций - Проверка баланса: ~2-5 секунд - Создание сделки: ~10-15 секунд - Мониторинг: ~1-5 секунд за проверку ### Надежность - Rate limiting T-Bank API: 15 секунд timeout - Fallback режим при недоступности API - Автоматическое восстановление после сбоев ### Масштабируемость - Поддержка множества одновременных сделок - Параллельный мониторинг нескольких позиций - Эффективное использование ресурсов ## 🛠️ Настройка и конфигурация ### Конфигурация через .env ```env # T-Bank API TBANK_TOKEN=t.wqnyx3rg3L8_P3GUrXXP29SPdebJRvYYD5b_Z5-5PjA1ky5_jJRaQlZRVV6eYe60WxuQBHzUI7RgxJpJskj_8g TBANK_REAL_TOKEN=t.JEWjjGv... (ваш реальный токен) # Счёта TBANK_ACCOUNT_ID=3ed6a662-... (sandbox) TBANK_ACCOUNT_ID_REAL=... (real) # Комиссии TBANK_COMMISSION_PCT=0.3 MOEX_EXCHANGE_FEE_PCT=0.01 ``` ### Настройка агента ```markdown # В .opencode/agents/trade-executor-enhanced.md - Изменить приоритеты скриптов - Настроить параметры риск-менеджмента - Добавить дополнительные проверки ``` ## 📊 Мониторинг и аналитика ### Логирование - Баланс: `reports/monitor_logs/monitor_{ticker}.log` - Сделки: `reports/trades.json` - Мониторинг: `reports/monitor_{ticker}.log` ### Статистика - Win rate - Средний RR - Общая прибыль/убыток - Количество сделок - Время удержания позиции ### Отчеты - Ежедневные отчеты по сделкам - Еженедельная статистика - Месячный P&L анализ ## 🚨 Важные замечания ### Рекомендации по использованию 1. **Всегда тестируйте в sandbox** перед использованием реального счёта 2. **Проверяйте баланс** перед созданием сделок 3. **Используйте stop-loss** для ограничения убытков 4. **Мониторьте позиции** особенно в волатильные периоды 5. **Не инвестируйте больше, чем готовы потерять** ### Ограничения - Работает только с MOEX тикерами - Требует стабильного интернет-соединения - Зависит от доступности T-Bank API - Соблюдает торговые часы MOEX ### Риски - Рыночные риски - Технические риски (сбои API) - Операционные риски (ошибки конфигурации) - Ликвидность (особенно для малоликвидных тикеров) ## 📞 Поддержка ### При возникновении проблем 1. Проверьте логи в `reports/` 2. Убедитесь, что `.env` файл правильно настроен 3. Проверьте доступность T-Bank API 4. Обратитесь к документации ### Контакты поддержки - Документация: `src/README.md` - Примеры использования: `trade-executor-example.md` - Конфигурация: `.opencode/agents/trade-executor-enhanced.md` ## 🎯 Заключение Новая система торговли предоставляет: - **Полный цикл управления сделками** - **Высокий уровень безопасности** - **Автоматизацию рутинных операций** - **Глубокую интеграцию с существующей экосистемой** - **Масштабируемость и надежность** Система готова к использованию и обеспечивает профессиональный подход к торговле на MOEX через T-Bank API.