Подключение бирж
API-ключи бирж: какие права давать, как хранятся, какие площадки поддерживаются.
Чтобы торговать в Live-режиме (и видеть балансы), Anlytra нужны API-ключи вашей биржи. Ключи добавляются в Настройки, Подключения и привязываются к вашему аккаунту.
Как добавить ключ
- Откройте Настройки, Подключения и нажмите «Добавить».
- Выберите биржу.
- Укажите метку (label) — например
defaultилиbot-1. Метка уникальна в пределах пары (вы, биржа). - Вставьте ключ и секрет, созданные на бирже. Для OKX и KuCoin дополнительно нужна passphrase.
При добавлении платформа сразу проверяет ключ валидирующим запросом к бирже и выставляет статус:
| Статус | Что значит |
|---|---|
| Active | Биржа приняла ключ, балансы читаются |
| InvalidCredentials | Биржа отклонила сам ключ — пересоздайте его |
| Unverified | Проверка не удалась по сети/прокси — стоит повторить позже |
| Revoked | Ключ отозван вами; хранится для аудита, но не используется |
Какие права давать ключу
Anlytra нужен доступ к фьючерсному торговому счёту:
- чтение балансов и позиций;
- торговля фьючерсами (размещение и закрытие ордеров);
- у некоторых бирж — изменение плеча.
Обязательно выключите право вывода средств (withdrawals), если биржа его предлагает. Anlytra никогда не выводит средства — только торгует внутри фьючерсного счёта.
Безопасность
- Секреты шифруются перед записью в базу (ASP.NET Data Protection, key-ring в БД) и расшифровываются только в момент вызова биржи.
- Наружу API отдаёт только маскированный публичный ключ — вернуть секрет через API нельзя.
- Ключ можно отозвать в любой момент; после этого он перестаёт резолвиться в клиент биржи немедленно.
Метки и Live-режим
Live-исполнитель резолвит ключи по метке default — для активации Live у вас должен быть Active-ключ с меткой default на каждой бирже стратегии. Остальные метки (например, отдельный ключ для ручных экспериментов) можно держать параллельно.
Поддерживаемые площадки
Рыночные данные (котировки, фандинг, стаканы) собираются со всех подключённых ингестом бирж. Для Live-торговли ключи имеют смысл только на биржах с исполнителем ордеров:
- Binance
- BingX
- Bitget
- BitMart
- Bybit
- CoinEx
- Gate.io
- KuCoin
- OKX
- WhiteBit
- XT
Активация Live для стратегии, у которой хотя бы одна биржа вне этого списка, вернёт ошибку с указанием биржи (см. Режимы стратегии).
Список расширяется по мере добавления order-исполнителей. Ориентируйтесь на сообщение об ошибке при активации Live — оно всегда называет актуальную причину отказа.