Интеграция с биржами

Общий обзор

Firedrake интегрируется напрямую с биржами Binance и Bybit, используя их официальные API. Это подключение позволяет платформе безопасно взаимодействовать с вашим биржевым аккаунтом: получать информацию и исполнять сделки, никогда не получая прямого доступа к вашим средствам (кастодиальное хранение).

Firedrake поддерживает следующие рынки:

• Binance: USDⓈ-Margined фьючерсы с USDT как маржинальной валютой.
• Bybit: Линейные USDT бессрочные фьючерсы.

Спот-аккаунты не подключаются, спот-ордера не выставляются.

Как это работает

Используя ваши API ключи, Firedrake непрерывно мониторит:

• Балансы аккаунтов.
• Историю сделок.
• Состояние рынка в реальном времени в соответствии с вашими стратегиями.

Когда срабатывает стратегия или вы открываете позицию вручную (через хуки или API), Firedrake автоматически:

1. Открывает ордера: Мгновенно размещает первый ордер на вход.
2. Управляет позицией: Сразу же выставляет Тейк-профит, Стоп-лосс и сетку страховочных ордеров согласно вашим настройкам.
3. Отслеживание в реальном времени: Подключается через WebSocket к потоку данных пользователя (user data stream) для отслеживания изменений позиции и сработавших ордеров в реальном времени.

Важно: Архитектура платформы позволяет Firedrake отличать собственные ордера от ордеров других ботов или ручных сделок. Firedrake управляет исключительно своими позициями, что технически допускает подключение других систем к тому же суб-аккаунту. Тем не менее, мы настоятельно не рекомендуем использовать другие алгоритмические системы на том же суб-аккаунте во избежание конфликтов логики.

Рассмотрим, как Firedrake реагирует на внешние изменения позиции:

Случай 1: Сторонняя система докупает токен, по которому у Firedrake уже открыта позиция.

• Firedrake пересчитает и перевыставит Тейк-профит и Стоп-лосс ордера в соответствии с новым объемом позиции.
• Сетка страховочных ордеров (DCA) останется без изменений.

Случай 2: Сторонняя система продает токен, по которому у Firedrake открыта позиция.

• Частичная продажа: Если позиция закрыта не полностью, Firedrake скорректирует Тейк-профит и Стоп-лосс под оставшийся объем. Сетка страховочных ордеров останется без изменений.
• Полная продажа: Если позиция закрыта полностью, Firedrake зафиксирует закрытие сделки и автоматически отменит все связанные с ней отложенные ордера.

Хранение средств: Firedrake никогда не хранит ваши средства. Все сделки исполняются напрямую на бирже через API. Firedrake отправляет инструкции, биржа их исполняет, а средства всегда остаются на вашем биржевом счете.

Что означает доступ по API

API ключ — это, по сути, пульт дистанционного управления с ограниченными правами доступа. Права этого доступа определяете вы сами при создании ключа.

• API Ключ: Безопасный идентификатор, позволяющий серверам Firedrake общаться с вашим аккаунтом.
• Права, заданные пользователем: Вы решаете, что именно разрешено делать Firedrake.

Чего Firedrake НЕ МОЖЕТ делать

• ❌ Выводить средства с вашего счета.
• ❌ Менять учетные данные или пароли.
• ❌ Получать доступ к другим сервисам биржи, не разрешенным явно.

Необходимые права

Для корректной работы платформы необходимо создать ключ с правами Read/Write (Чтение/Запись) для:

• Ордеров (Orders)
• Позиций (Positions)
• Торговли фьючерсами (USDⓈ-M фьючерсы на Binance, деривативы / Contract на Bybit).

Права на торговлю на споте тоже нужны. Firedrake не торгует на споте, но платформа использует эти права для своих служебных запросов к бирже. Пошаговая инструкция для каждой биржи — в статье Создание API-ключей.

Безопасность: При создании ключей вы должны ограничить их использование, указав только IP-адреса серверов Firedrake. Это гарантирует, что даже в случае компрометации ключа, им невозможно будет воспользоваться с любого другого устройства.

Что Firedrake НЕ отслеживает

Firedrake отслеживает только данные, необходимые для исполнения и управления настроенными вами стратегиями.

Платформа:

• не отслеживает активность аккаунта, не связанную с работой бота
• не отслеживает ручные сделки за пределами своих собственных ордеров
• не анализирует или интерпретирует ваше финансовое положение

Поддерживаемые биржи

На данный момент Firedrake интегрирован с биржами Bybit и Binance.

Почему эти биржи?

Мы выбрали эти платформы из-за их надежности и зрелости:

• Ликвидность: Это крупнейшие биржи с огромной ликвидностью, что гарантирует быстрое исполнение ордеров по ожидаемой цене.
• Стабильность API: Обе биржи предоставляют надежные и стабильные API, поддерживающие высокочастотные торговые операции.
• Регуляция: Высокие стандарты соблюдения нормативных требований.
• Надежность: Проверенная репутация в вопросах ввода и вывода средств.

В ближайшее время мы планируем подключить и другие биржи. Если у вас есть пожелания по интеграции, пожалуйста, напишите нам через форму обратной связи.

Надежность системы и обработка сбоев

Мы спроектировали Firedrake устойчивым к сбоям. Вот что происходит в различных нештатных ситуациях:

Если серверы Firedrake недоступны

• Новые сделки: Открытие новых сделок прекращается.
• Существующие сделки: Вам следует вручную мониторить открытые позиции на бирже до восстановления работы серверов.
• Уведомления: Наша система автоматического мониторинга обнаружит сбой и немедленно уведомит вас по email и в Telegram.
• Восстановление: Сразу после перезапуска серверы «догоняют» пропущенную информацию через API и продолжают работу.
  • Примечание: Если позиция закрылась во время простоя серверов, страховочные ордера или стоп-лоссы могут не удалиться автоматически. Вы получите уведомление о необходимости проверки.

Если недоступен API биржи

• Уведомления: Вы получите оповещение по email и в Telegram.
• Влияние: Новые сделки не будут открываться. При закрытии старых сделок могут остаться неотмененные лимитные ордера (например, страховочные), которые нужно будет отменить вручную.

Если биржа не принимает ваши API-ключи

• Когда: Ключ удалили на бирже, истёк срок его действия, изменились его права или IP-адреса.
• Влияние: Если биржа раз за разом отклоняет ключи, Firedrake выключает аккаунт. Боты и стратегии по нему перестают торговать. Кратковременные проблемы с сетью или сбои на бирже к выключению аккаунта не приводят.
• Уведомления: Причина видна в колонке Статус и информация аккаунта, а если подключён Telegram, бот присылает сообщение об отключении аккаунта.
• Восстановление: Создайте новый API-ключ и замените его в аккаунте. Аккаунт включится снова, как только новые ключи пройдут проверку. Подробнее — в статье Подключение биржевого аккаунта.

Высокая нагрузка и ограничения со стороны биржи

Firedrake использует продвинутую систему прокси-серверов и балансировщика нагрузки.

• Предварительная проверка: Каждый API запрос проверяется на соответствие текущим лимитам перед отправкой.
• Балансировка: Если один сервер приближается к лимиту, система автоматически перенаправляет запросы через другой.
• Повторные попытки: Если запрос не прошел, он тут же выполняется повторно через другой прокси-маршрут. Такая инфраструктура значительно уменьшает вероятность проблем с лимитами API.

Частичный сбой ордера

Система постоянно перепроверяет правильность выставления ордеров. Если какой-то из параметров ордера не совпадает с тем, что должно быть в настройках, Firedrake перевыставит такой ордер, чтобы он точно соответствовал конфигурации бота.

Модель безопасности

Безопасность пользователей — наш приоритет.

• Белый список IP: При создании ключей вы строго ограничиваете их использование IP-адресами серверов Firedrake. Никакая другая машина не сможет подключиться с этими ключами.
• Шифрование: Все ключи шифруются и никогда не хранятся в открытом виде.
• Изоляция: Сервисы, осуществляющие работу с биржами, запущены на изолированных серверах, к которым нет доступа из публичного интернета.

Перед подключением биржи

Убедитесь, что:

• Вы понимаете, что трейдинг сопряжен с рисками
• Вы создали отдельный суб-аккаунт для Firedrake
• API ключи не имеют прав на вывод средств
• Вы начинаете тестирование с небольших сумм