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

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

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

Binance
Bybit

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

👉 Регистрация на Binance
👉 Регистрация на Bybit

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

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

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

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

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

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

Критически важно: read / write доступ

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

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

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

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

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

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

✅ Spot trading — торговля на спотовом рынке
✅ Futures / Derivatives trading — торговля фьючерсами
✅ Account read access — чтение балансов, позиций и ордеров

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

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

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

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

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

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

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

✅ System generated API Key (HMAC)

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

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

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

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

API Key
Secret Key

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

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

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

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

Поэтому:

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

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

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

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

✅ Enable Reading
✅ Enable Spot & Margin Trading
✅ Enable Futures

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

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

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

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

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

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

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

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

✅ System-generated API Keys (HMAC)

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

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

API-ключ должен быть создан в режиме Read-Write и иметь:

✅ Trade — Spot
✅ Trade — Derivatives (USDT Perpetual / Linear Futures)
✅ Account / Positions / Orders (Read)

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

❌ Withdraw — не выбран

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

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

API Key
API Secret

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

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

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

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

Перейдите в Firedrake → Accounts → Add Exchange Account.
Выберите биржу (Binance или Bybit).
Вставьте:
- API Key
- Secret Key
Сохраните настройки.

Firedrake автоматически проверит ключ и начнёт синхронизацию.

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

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