Перейти к основному содержимому

Создание API-ключей для подключения бирж

Перед началом​

Для подключения биржевых аккаунтов к Firedrake вам потребуется аккаунт на поддерживаемой бирже:

  • Binance
  • Bybit

Если у вас ещё нет аккаунта:

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

Общий принцип работы API-ключей​

Firedrake подключается к биржам исключительно через API-ключи, созданные на стороне биржи.

API-ключи позволяют платформе:

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

Firedrake торгует только фьючерсами. Права на спотовую торговлю при этом всё равно нужны: платформа использует их для своих служебных запросов к бирже.

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

Критически важно: доступ на чтение / запись​

⚠️ Без (торгового) доступа на чтение/запись Firedrake работать не сможет.

API-ключ обязан иметь:

  1. разрешение на чтение данных аккаунта,
  2. разрешение на торговые операции (ордера, позиции).

Ключи с режимом только для чтения подходят только для мониторинга и не поддерживаются Firedrake.

Требования к API-ключам​

Для корректной работы Firedrake API-ключ должен иметь:

  • ✅ Futures / Derivatives trading — торговля фьючерсами: ордера и позиции с правами на чтение и запись
  • ✅ Spot trading — нужна для служебных запросов платформы (на споте Firedrake не торгует)
  • ✅ Account read access — чтение балансов, позиций и ордеров

❌ Разрешения Withdraw, Transfer, Universal Transfer, Margin Loan / Repay должны быть отключены.

Ключ с правом вывода (Withdraw на Bybit, Enable Withdrawals на Binance) не пройдёт проверку при сохранении аккаунта в Firedrake.

Создание API-ключей на Binance​

Шаг 1. Перейдите в API Management​

  1. Авторизуйтесь в аккаунте Binance.
  2. Откройте: Account → API Management.

Binance не позволяет создавать API-ключи без включённых базовых мер безопасности. Если KYC не завершён — создание ключей будет недоступно.

Binance API Management Step 1

Шаг 2. Выберите тип API-ключа​

При создании ключа выберите:

  • ✅ System generated API Key (HMAC)

❌ Self-generated API keys (RSA / Ed25519) не поддерживаются Firedrake.

Binance API Creation Step 2

Шаг 3. Укажите имя ключа и подтвердите создание​

  1. Укажите произвольное имя (например: firedrake).
  2. Подтвердите создание через 2FA / email.

После этого Binance сгенерирует:

  • API Key
  • Secret Key

🔐 Ключи появятся только один раз. Мы рекомендуем сразу вставить их в форму подключения Привязанные аккаунты на Firedrake и НЕ сохранять их на персональном компьютере или других устройствах. После подключения аккаунта к Firedrake эти ключи больше нигде не понадобятся.

Отдельно, в целях безопасности, рекомендуем менять ключи время от времени (раз в 1-3 месяца).

Шаг 4. Настройте белый список IP (обязательный шаг)​

⚠️ Binance не позволяет включить фьючерсную торговлю для API-ключа без белого списка IP.

Поэтому:

  1. Включите опцию Restrict access to trusted IPs only.
  2. Добавьте IP-адреса серверов Firedrake (см. список ниже).
  3. Сохраните изменения.

Только после этого Binance позволит активировать доступ к фьючерсам.

Шаг 5. Настройте разрешения API-ключа​

В разделе API restrictions включите:

  • ✅ Enable Reading
  • ✅ Enable Spot & Margin Trading — нужно для служебных запросов платформы
  • ✅ Enable Futures — обязательно: через это право Firedrake торгует фьючерсами

Убедитесь, что отключены:

  • ❌ Enable Withdrawals
  • ❌ Permits Universal Transfer
  • ❌ Enable Margin Loan, Repay & Transfer

Сохраните изменения.

Binance API Creation Step 2

Создание API-ключей на Bybit​

Шаг 1. Перейдите в раздел API​

  1. Авторизуйтесь в аккаунте Bybit.
  2. Откройте: Account → API.
Bybit API Management Step 1

Шаг 2. Выберите тип API-ключа​

При создании ключа выберите:

  • ✅ System-generated API Keys (HMAC)

❌ Self-generated API keys (RSA) не поддерживаются Firedrake.

Bybit API Creation Step 2

Шаг 3. Настройте разрешения​

  1. Выберите API Transaction и укажите имя ключа (например, firedrake).
  2. В блоке API Key Permissions выберите Read-Write.
  3. Выберите Only IPs with permissions granted are allowed to access the OpenAPI и вставьте IP-адреса серверов Firedrake одной строкой через запятую (готовая строка — в списке ниже). Bybit предупреждает: ключ без привязки к IP-адресам перестаёт действовать через 3 месяца.
  4. В группе Unified Trading включите:
    • ✅ Contract → Orders — обязательно
    • ✅ Contract → Positions — обязательно
    • ✅ SPOT → Trade — нужно для служебных запросов платформы

Без Contract → Orders и Contract → Positions, а также с ключом Read-Only ключ не пройдёт проверку при сохранении аккаунта в Firedrake.

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

  • ❌ Withdraw — не выбран
Bybit API Permissions Step 3

Шаг 4. Сохраните ключи​

После создания Bybit покажет:

  • API Key
  • API Secret

🔐 Ключи появятся только один раз. Мы рекомендуем сразу вставить их в форму подключения Привязанные аккаунты на Firedrake и НЕ сохранять их на персональном компьютере или других устройствах. После подключения аккаунта к Firedrake эти ключи больше нигде не понадобятся.

Отдельно, в целях безопасности, рекомендуем менять ключи время от времени (раз в 1-3 месяца).

Добавление API-ключей в Firedrake​

После создания ключей:

  1. Перейдите в Платформа → Привязанные аккаунты → Добавить аккаунт.
  2. Выберите биржу (Binance или Bybit).
  3. Вставьте:
    • API-ключ
    • Секретный ключ
  4. Сохраните настройки.

Сразу после сохранения Firedrake проверяет ключи на бирже. Если биржа их принимает, начинается синхронизация аккаунта. Если нет — аккаунт сохраняется, но остаётся выключенным, а в окне появляются причина и инструкция, что делать. Подробнее — в разделе Если биржа не принимает ключи.

Рекомендации по безопасности API-ключей​

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

Минимальные разрешения​

Создавайте API-ключи только с теми правами, которые необходимы для торговли.

Белый список IP (настоятельно рекомендуется)​

Использование белого списка IP:

  • защищает ключи от компрометации,
  • снижает риск блокировок со стороны биржи,
  • обязательно для Binance Futures.

IP-адреса серверов Firedrake. Скопируйте их кнопкой копирования в правом верхнем углу блока.

Для Bybit вставьте строку целиком. Bybit принимает адреса только через запятую, без пробелов и переносов строк. Иначе он пишет «Формат IP-адреса или неверен, или превысил максимальное ограничение».

18.143.60.129,13.214.168.178,57.180.152.8,35.75.105.6,57.180.6.217,52.199.51.87,35.72.90.105,54.248.187.231,54.238.251.198,35.78.40.101,35.73.221.100,52.68.250.9

Для Binance добавляйте адреса по одному:

18.143.60.129
13.214.168.178
57.180.152.8
35.75.105.6
57.180.6.217
52.199.51.87
35.72.90.105
54.248.187.231
54.238.251.198
35.78.40.101
35.73.221.100
52.68.250.9

Если что-то не работает​

Если ключ не проходит проверку, причина видна в окне с ошибкой и в колонке Статус и информация аккаунта. Чаще всего это одно из следующего:

  1. Ключ только для чтения — создайте ключ с доступом на чтение/запись.
  2. У ключа нет прав на торговлю фьючерсами — на Binance это Enable Futures, на Bybit — Contract → Orders и Contract → Positions. Ключ Binance без Enable Futures не принимается.
  3. Ключ привязан к другим IP-адресам — добавьте IP-адреса Firedrake в белый список ключа.
  4. Скопирована только часть секретного ключа — копируйте ключ и секрет целиком сразу после создания.
  5. Срок действия ключа истёк или ключ удалён на бирже — создайте новый.

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

Как заменить ключи в аккаунте, описано в статье Подключение биржевого аккаунта.