KuCoin

Как подключить аккаунт KuCoin к SmartDOM по API-ключу и что терминал сможет делать с этим подключением.

Что даёт подключение

После подключения SmartDOM показывает балансы и позиции аккаунта, ведёт список заявок и позволяет торговать из стакана. Без подключения биржа доступна только для просмотра котировок.

Параметр	Значение
Рынки для торговли	Spot и Futures (USDT-perpetual)
Passphrase при подключении	Нужен
Demo trading (testnet)	Нет

Где находится в SmartDOM

Настройки → Подключение → «+ Добавить подключение».

Пошаговая инструкция

Создайте API-ключ в личном кабинете KuCoin (раздел API Management). При создании биржа просит придумать passphrase: запишите её сразу, позже на сайте её посмотреть нельзя. Включите права General, Spot Trading и Futures Trading: ключ только с General пройдёт проверку, но заявки выставляться не будут. Какие права нужны вообще: Создание API-ключей и необходимые разрешения.
Ограничение по IP на KuCoin необязательно, но торговый ключ без привязки к IP биржа отключает после 30 дней бездействия. Если адрес постоянный, укажите его в белом списке.
В SmartDOM откройте Настройки → Подключение и нажмите + Добавить подключение.
В поле Биржа выберите KuCoin.
В поле Название введите любое понятное имя, например «KuCoin основной». Оно нужно, чтобы отличать подключения между собой.
Вставьте API Key, Secret Key и Passphrase.
Нажмите Проверить и сохранить. Терминал обратится к бирже и убедится, что ключи рабочие. Пока идёт проверка, показывается «Проверка ключей…».
Новое подключение появится в списке со статусом Отключено. Нажмите Подключить, чтобы начать торговать.

Особенности

При проверке терминал обращается к спотовому и фьючерсному аккаунту по очереди. Достаточно, чтобы ключ подошёл хотя бы к одному рынку: подключение сохранится, а в карточке будет указано, какие рынки прошли проверку.
Терминал работает с обычным (классическим) аккаунтом KuCoin. Режим Unified Trading Account не поддерживается. Это отличается от Bybit и OKX, где единый счёт, наоборот, обязателен.
Спот торгуется со счёта Trading, фьючерсы — с фьючерсного счёта. Средства на счёте Funding терминал не видит: переведите их на нужный счёт на сайте биржи, иначе заявка вернётся с сообщением «Недостаточно средств на балансе для размещения ордера».
Объём на фьючерсах KuCoin считается в контрактах. Терминал переводит монеты в целое число контрактов, округляя вниз. Если выбранный объём меньше одного контракта, заявка не уйдёт с сообщением «Выбранный объём слишком мал для этого инструмента». На дорогих контрактах (например, BTC или ETH) один контракт может стоить десятки долларов, поэтому маленькие пресеты объёма в долларах дадут ноль контрактов. Объёмы в стакане и ленте фьючерсов биржа тоже отдаёт в контрактах.
Режим позиций на фьючерсах должен быть One-Way. Если на аккаунте включён режим хеджирования (Hedge), заявка не отправится, появится сообщение «Аккаунт KuCoin в режиме хеджирования (Hedge/Dual)…». Терминал не переключает режим сам: переключите его на сайте биржи, предварительно закрыв позиции и сняв ордера.
Плечо. В режиме cross плечо меняется на бирже прямо из терминала. В режиме isolated у KuCoin плечо задаётся на каждую заявку: терминал запоминает выбранное значение для инструмента и подставляет его в следующие заявки. Режим маржи терминал не переключает.
Take Profit и Stop Loss на фьючерсах ставятся как стоп на всю позицию и срабатывают по mark price; отложенные заявки срабатывают по последней цене. На споте условные заявки ставятся с фиксированным объёмом на момент постановки.
Перенос заявки перетаскиванием на фьючерсах и перенос условных заявок на споте биржа выполняет через отмену и новую заявку, поэтому номер заявки на бирже меняется. Лимитные заявки на споте переносятся без отмены.
История сделок загружается с биржи: спот за последние 7 дней, фьючерсы за 3 месяца.

Типовые ошибки

«Неверные API ключи»: ключ скопирован не полностью, удалён на бирже или создан для другого аккаунта (коды KuCoin 400003 и 400005).
«Неверная passphrase»: фраза не совпадает с заданной при создании ключа (код 400004). Посмотреть её на бирже нельзя, при сомнении создайте новый ключ.
«IP-адрес не в whitelist API ключа»: на бирже включён белый список адресов, а ваш текущий адрес в него не внесён (код 400006).
«У API ключа недостаточно прав»: не включены права Spot Trading или Futures Trading (код 400007).
«Локальные часы рассинхронизированы с биржей (>30 сек)»: включите автоматическую синхронизацию времени в Windows (код 400002).
«Недостаточно средств на балансе для размещения ордера» при заявке на фьючерсах: на фьючерсном счёте нет свободной маржи, средства лежат на Funding или на споте (код 330008). Переведите их на фьючерсный счёт на сайте биржи.
«API-ключи KuCoin не настроены или недействительны» при выставлении заявки, хотя подключение прошло проверку: ключ создан без права торговли либо удалён на бирже. Создайте новый ключ и измените подключение кнопкой Изменить.

Полный список сообщений и что с ними делать: Типовые ошибки подключения.