Ошибки KuCoin

KuCoin отвечает полями code и msg: код 200000 — успех, любой другой — отказ. Коды — шестизначные числа, и отказ часто приходит с HTTP-статусом 200, поэтому смотреть нужно на код. Спот и фьючерсы у KuCoin — разные API с разными наборами кодов: например, нехватка средств на споте — 200004, на фьючерсах — 300003.

Ключ KuCoin состоит из трёх частей — ключа, secret и passphrase, — и ошибиться можно в любой. Если терминал не узнал отказ, во всплывающем сообщении после «Order:» будет ответ биржи как есть: KuCoin API 200004: Balance insufficient или KuCoin POST /orders HTTP 400: {"code":"…","msg":"…"}. Общий порядок разбора — на странице Сообщения об ошибках: как читать, настройка ключей — в Подключение бирж и API-ключи.

Что терминал объясняет сам

Ситуация	Коды	Что вы увидите
Биржа не узнала ключ или passphrase	`400003`, `400004`	Плашка «…: биржа отвергла API-ключ или secret — проверьте их в настройках подключения», у подключения в Настройки → Подключения подсказка «Биржа отвергла API-ключ или secret»
Неверная подпись	`400005`	При подключении — та же плашка; на заявке — «Заявка отклонена: неверный API-ключ или secret»
Ключ старого или нового поколения	—	Ничего: KuCoin подписывает ключи разных поколений по-разному, и терминал сам подбирает нужный вариант
Слишком много запросов	HTTP 429	Плашка «KuCoin: превышен лимит запросов (429), ограничение до … UTC». Терминал сам выдерживает паузу
Разошлись часы	`400002`	Ничего: терминал сверяет время с KuCoin и повторяет запрос
Заявки уже нет	HTTP 404 с `order_not_exist_or_not_allow_to_cancel`	Ничего: терминал сам спрашивает у биржи итоговый статус заявки
Не хватило монет при закрытии спотовой позиции	`200004`, `300003`, `100005`	Терминал сразу перечитывает кошелёк и повторяет продажу до трёх раз, каждый раз чуть меньшим объёмом — в пределах комиссии. Не помогло — показывает текст биржи
Закрывать на споте нечего	—	«KuCoin …: продавать нечего — остаток … = 0, позиция уже закрыта» — с названием пары и монеты. Заявка на биржу не уходит
Биржа приостановила торговлю монетой по API	по словам в ответе	«Торговля по API недоступна для этой монеты — ограничение биржи»

Отказ по белому списку IP (400006) или правам ключа (400007) в сообщении заявки приходит текстом биржи: ключ при этом верный. Но если биржа отказала так ещё при подключении, терминал может показать ту же плашку «биржа отвергла API-ключ или secret» — поэтому, увидев её, проверьте заодно права и белый список IP ключа.

Частые коды

Код	Как выглядит	Причина	Что делать
`400003`	Плашка «биржа отвергла API-ключ или secret»	Ключа нет: вставлен с ошибкой или удалён	Проверьте API Key — см. Биржа отвергла ключ
`400004`	Плашка «биржа отвергла API-ключ или secret»	Неверный passphrase	Вставьте Passphrase ключа заново
`400005`	Плашка или «Заявка отклонена: неверный API-ключ или secret»	Подпись не сошлась: secret не подходит к ключу	Вставьте API Secret заново
`400001`	Текст биржи: «Any of KC-API-KEY, KC-API-SIGN, KC-API-TIMESTAMP, KC-API-PASSPHRASE is missing in your request header»	Одно из трёх полей ключа пустое	Заполните все три поля подключения
`400002`	Обычно ничего; при резком скачке часов — текст биржи «KC-API-TIMESTAMP Invalid»	Часы компьютера разошлись с биржей	Повторите через минуту. Повторяется — включите синхронизацию времени в Windows
`400006`	Текст биржи: «The requested ip address is not on the api whitelist»	Ваш IP не в белом списке ключа	См. Права и белый список IP
`400007`	Текст биржи: «Access Denied»	У ключа нет права на это действие	Включите нужное право у ключа
`411100`	Текст биржи: «User is frozen»	Аккаунт заморожен на стороне KuCoin	Обратитесь в поддержку KuCoin
`200004`	Текст биржи в сообщении заявки: «Balance insufficient»	На спотовом счёте не хватает свободных средств	См. Не хватает средств
`300003`	Текст биржи в сообщении заявки: «Balance not enough…»	На фьючерсном счёте не хватает средств	Пополните фьючерсный счёт или уменьшите объём
`102435`	Текст биржи в сообщении заявки: «Below the minimum order size»	Объём меньше минимального для пары	Увеличьте объём
`300005`	Текст биржи в сообщении заявки: «The order will exceed the maximum risk limit of …»	Позиция с этой заявкой превысит лимит риска	Уменьшите объём или плечо
`300016`	Текст биржи: «The leverage cannot be greater than …»	Плечо выше допустимого для контракта	Выберите плечо ниже
`200001`	Текст биржи в сообщении заявки: «Order creation for this pair suspended»	Биржа временно не принимает заявки по паре	Подождите или выставьте заявку на сайте KuCoin
`900001`	Текст биржи в сообщении заявки: «symbol does not exist»	Пары нет на этом рынке KuCoin	Проверьте, что монета открыта на нужном рынке — спот или фьючерс
`429000`	Текст биржи: «Too Many Requests…»	Сработал общий лимит сервера KuCoin	Подождите несколько секунд и повторите

Как исправить частые проблемы

Биржа отвергла ключ

Сверьте все три поля

В Настройки → Подключения у подключения KuCoin три поля: API Key, API Secret и Passphrase. Скопируйте ключ и secret заново, без пробелов по краям. Passphrase — это пароль, который вы задали при создании ключа API, а не пароль от входа на KuCoin.

Проверьте ключ на сайте KuCoin

Откройте управление API в профиле KuCoin и убедитесь, что ключ не удалён. Если secret или passphrase не сохранились, создайте новый ключ — посмотреть их потом нельзя.

Проверьте права и белый список IP

У ключа должно быть право на торговлю тем рынком, который включён в подключении переключателями Спот и Фьючерс. Если у ключа задан белый список IP, в нём должен быть ваш внешний адрес или адрес прокси.

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

Права и белый список IP

Коды 400006 и 400007 значат, что ключ верный, но биржа не пускает запрос. Для 400006 добавьте в белый список ключа внешний IP вашего компьютера; если подключение идёт через прокси (раздел Прокси в карточке подключения), добавляют адрес прокси. Для 400007 включите у ключа право на торговлю нужным рынком. Пересоздавать ключ обычно не нужно: права и список IP меняются в настройках существующего ключа.

Не хватает средств

На споте (200004) деньги, заблокированные открытыми заявками, для новой заявки недоступны. Снимите лишние заявки или уменьшите объём.

На фьючерсах (300003) деньги должны лежать на фьючерсном счёте KuCoin. Спотовый и фьючерсный счета у KuCoin раздельные — переведите средства между ними на сайте биржи.

При закрытии спотовой позиции продажей недостача часто возникает из-за комиссии, списанной в купленной монете. Терминал это учитывает: перечитывает кошелёк и повторяет продажу с чуть меньшим объёмом. После этого на кошельке может остаться «пыль» меньше шага объёма — продать её заявкой нельзя.

Объём на фьючерсах

Фьючерсные заявки KuCoin считаются в контрактах, а не в монетах: у каждого контракта свой размер. Терминал переводит объём из монет в контракты сам и округляет до ближайшего целого числа контрактов, но не меньше одного. Поэтому заявка меньше одного контракта уйдёт на биржу объёмом в один контракт — фактический объём окажется больше введённого. На мелких счетах проверяйте размер контракта монеты на сайте KuCoin.

Превышен лимит запросов

Терминал показывает время по UTC, до которого действует ограничение, и сам выдерживает паузу. Лимит считается на адрес: подключения KuCoin к одному рынку через один IP или прокси тратят общий запас. Если ограничение повторяется, уменьшите число окон и панелей с KuCoin или разнесите подключения по разным прокси. Подробнее — в Сообщениях терминала.

Дальше

Сообщения об ошибках

Где терминал показывает ошибки и как их читать.

Подключение бирж

Как создать ключ и добавить подключение в LootX.

Ошибки BingX

Ключ и подпись, режим позиций, лимиты.