Создание API-ключей и необходимые разрешения
Какие права дать API-ключу, чтобы SmartDOM работал, и чего давать не нужно.
Какие права нужны
Заголовок раздела «Какие права нужны»| Право | Нужно ли | Зачем |
|---|---|---|
| Чтение (Read / Read-only) | Да | Баланс, позиции, открытые заявки. Без него подключение не пройдёт проверку. |
| Торговля (Trade / Spot & Margin Trading / Futures) | Да | Выставление и отмена заявок. Включите для тех рынков, на которых собираетесь торговать: спот и/или фьючерсы. |
| Вывод (Withdraw) | Нет | Терминалу не нужен. В случае утечки ключ с правом вывода опасен. |
| Переводы между аккаунтами (Transfer) | Нет | Не используется. |
Не включайте право вывода средств для ключа терминала. В случае утечки такого ключа деньги можно будет вывести без вашего участия.
Ограничение по IP
Заголовок раздела «Ограничение по IP»Биржи позволяют привязать ключ к списку IP-адресов. Это повышает безопасность, но если ваш адрес меняется (домашний интернет, мобильная сеть, VPN), терминал получит ошибку «IP-адрес не в whitelist API ключа». Варианты:
- не включать ограничение по IP, если адрес непостоянный;
- включить и внести текущий адрес, а при его смене обновлять список на бирже.
Passphrase
Заголовок раздела «Passphrase»OKX, Bitget и KuCoin при создании ключа просят придумать дополнительную фразу. Она вводится в SmartDOM вместе с ключом. Посмотреть её позже на бирже нельзя, поэтому сохраните её сразу. Для остальных бирж поле Passphrase не показывается.
На KuCoin ключу нужны права General, Spot Trading и Futures Trading. Торговый ключ без привязки к IP-адресу биржа отключает после 30 дней бездействия.
Общий порядок на бирже
Заголовок раздела «Общий порядок на бирже»- Войдите в личный кабинет биржи и откройте раздел управления API (обычно в меню профиля: «API Management», «API-ключи»).
- Создайте новый ключ. Название любое, например «SmartDOM».
- Отметьте права: чтение и торговля. Вывод не отмечайте.
- Пройдите подтверждение биржи (2FA, почта).
- Скопируйте API Key и Secret Key. Secret Key показывается один раз, потом его не восстановить, только создать новый ключ.
- Вставьте ключи в SmartDOM: Общий принцип подключения через API.
Срок действия и лимиты
Заголовок раздела «Срок действия и лимиты»- У некоторых бирж ключ без привязки к IP действует ограниченное время, потом его нужно продлить или создать новый. Симптом: подключение работало, а потом стало отвечать «Неверные API ключи».
- Не используйте один ключ в нескольких программах одновременно: они делят лимит запросов биржи.