Помилки Gate
Мітки помилок Gate у LootX: INVALID_KEY, INVALID_SIGNATURE, BALANCE_NOT_ENOUGH, REQUEST_EXPIRED і ліміт заявок по одній парі.
Gate повідомляє про помилку не числом, а текстовою міткою: {"label":"BALANCE_NOT_ENOUGH","message":"…"}. Мітка — головне: по ній зрозуміло, що сталося, а message додає подробиці. Якщо термінал не впізнав мітку, у спливному повідомленні після «Order:» стоїть відповідь біржі як є — наприклад, Gate POST …: HTTP 400 {"label":"BALANCE_NOT_ENOUGH",…}.
Спот і ф’ючерси USDT у Gate — різні розділи API зі своїми правами ключа. Ліміти запитів на споті рахуються окремо по кожній парі, тому активна торгівля однією монетою впирається в ліміт раніше, ніж загальний потік запитів. Загальний порядок розбору помилок — на сторінці Повідомлення про помилки: як читати, налаштування ключів — у Підключення бірж та API-ключі.
Що термінал пояснює сам
| Ситуація | Мітка | Що ви побачите |
|---|---|---|
| Біржа відхилила ключ | INVALID_KEY — у відповіді на запит або на підписку приватного потоку |
Плашка з ім’ям підключення: «…: біржа відхилила API-ключ або secret — перевірте їх у налаштуваннях підключення». У Налаштування → Підключення біля підключення підказка «Біржа відхилила API-ключ або secret». Термінал повторює спробу приблизно раз на 30 секунд |
| Підпис не підтверджено | INVALID_SIGNATURE |
При підключенні — та сама плашка, у заявці — «Заявку відхилено: неправильний API-ключ або secret» |
| Підпис не зійшовся лише по монеті з нелатинською назвою | INVALID_SIGNATURE |
Нічого: термінал сам повторює запит з іншою формою підпису й далі підписує цією монетою правильно |
| Занадто багато запитів | HTTP 429 і 418 | «⚠ … rate limit (429), пауза ~3 с — до 12:00:03 UTC». Паузу до трьох секунд термінал вичікує сам і надсилає запит після неї. Повторні відмови поспіль подовжують паузу: 8, 25, потім 60 секунд |
| Розійшлися годинники | REQUEST_EXPIRED |
Відмова не вважається помилкою ключа, підключення не рветься. Термінал звіряє час із біржею при підключенні та раз на хвилину |
| Заявки вже немає | ORDER_NOT_FOUND |
Нічого: скасування вважається виконаним |
| Позиції немає | POSITION_NOT_FOUND |
Нічого: термінал вважає позицію за контрактом нульовою |
| Обсяг або сума спотової заявки менша за мінімум | — | «Gate …: обсяг … менший за мінімальний …» або «Gate …: сума заявки … менша за мінімум біржі …». Термінал перевіряє це до відправлення, заявка на біржу не йде |
| Не вистачило монет при закритті спотової позиції | BALANCE_NOT_ENOUGH |
Термінал повторює продаж з обсягом, зменшеним на розмір комісії. Не допомогло — показує текст біржі |
| Закривати на споті нічого | — | «Gate …: на гаманці немає SOL — позицію вже закрито». Заявка на біржу не йде |
| Режим позицій на ф’ючерсах | — | Термінал дізнається режим рахунку — одинарний або подвійний — і будує заявку під нього |
| Біржа призупинила торгівлю монетою по API | за словами у відповіді | «Торгівля по API недоступна для цієї монети — обмеження біржі» |
Довідкові запити — історія угод і рух коштів — при відмові авторизації не рвуть підключення: торгівля продовжує працювати, навіть якщо такий запит не пройшов.
Часті коди
| Мітка | Як виглядає | Причина | Що робити |
|---|---|---|---|
INVALID_KEY |
Плашка «біржа відхилила API-ключ або secret» | Ключ неправильний або видалений | Перевірте ключ на сайті Gate і вставте заново в API Key — див. Біржа відхилила ключ |
INVALID_SIGNATURE |
Плашка або «Заявку відхилено: неправильний API-ключ або secret» | Secret не підходить до ключа | Вставте API Secret заново |
REQUEST_EXPIRED |
Текст біржі в повідомленні заявки | Годинник комп’ютера розійшовся з біржею, найчастіше після виходу зі сну | Повторіть заявку за хвилину. Повторюється — увімкніть синхронізацію часу в Windows |
BALANCE_NOT_ENOUGH |
Текст біржі в повідомленні заявки | Не вистачає вільних коштів: частину заблоковано заявками або пішло на комісію | Див. Не вистачає коштів |
| HTTP 429, «Request Rate Limit Exceeded» | «rate limit (429), пауза ~N с…» | Перевищено ліміт запитів | Дочекайтеся кінця паузи |
| «Request Rate Limit Exceeded (007), currency_pair:…» | Те саме | Більше 10 заявок на секунду по одній спотовій парі | Див. Ліміт заявок по одній парі |
ORDER_NOT_FOUND |
Нічого | Скасовуваної заявки вже немає: виконана або знята | Нічого робити не потрібно |
POSITION_NOT_FOUND |
Нічого | За контрактом немає відкритої позиції | Нічого робити не потрібно |
Як виправити часті проблеми
Біржа відхилила ключ
Перевірте, що ключ існує
Відкрийте керування ключами APIv4 у профілі Gate. Якщо ключа немає в списку, його видалили — створіть новий.
Скопіюйте ключ і secret заново
Secret Gate показує лише при створенні ключа — якщо він не зберігся, створіть новий ключ. У Налаштування → Підключення вставте значення в API Key і API Secret без пробілів по краях.
Перевірте права ключа
У ключа має бути ввімкнена торгівля на тих ринках, що позначені біля підключення перемикачами Спот і Ф’ючерс: спотова торгівля — для споту, безстрокові ф’ючерси — для ф’ючерсів. Права на читання даних акаунта для торгівлі не обов’язкові.
Перевірте прив’язку до IP
Якщо ключ прив’язано до списку IP, у ньому має бути зовнішня адреса вашого комп’ютера. Працюєте через проксі (розділ Проксі в картці підключення) — додайте адресу проксі.
Після виправлення термінал перепідключиться сам при наступній спробі.
Ліміт заявок по одній парі
На споті Gate обмежує виставлення заявок окремо по кожній парі: не більше 10 запитів на секунду на одну монету, ліміти різних пар незалежні. Відповідь «Request Rate Limit Exceeded (007), currency_pair:…» — це саме таке посекундне обмеження по одній монеті, а не блокування акаунта.
- Коротку паузу термінал вичікує сам: заявка піде за пару секунд, торгівля іншими монетами не зупиняється.
- Якщо відмови йдуть поспіль, пауза зростає до хвилини. Час її закінчення видно в повідомленні, за UTC.
Не вистачає коштів
Кошти під відкритими заявками заблоковано — зніміть зайві заявки або зменшіть обсяг. На ф’ючерсах під заявку потрібна маржа з урахуванням плеча.
При закритті спотової позиції продажем нестача часто виникає через комісію: при купівлі вона може списатися в купленій монеті, і продати весь куплений обсяг уже не можна. Термінал звіряє обсяг із гаманцем і при відмові повторює продаж із трохи меншим обсягом. Після цього на гаманці може залишитися «пил» менший за крок обсягу — продати його заявкою не можна.
Годинники розійшлися
Мітка REQUEST_EXPIRED означає, що час запиту занадто далекий від часу біржі. Зазвичай так буває після виходу комп’ютера зі сну. Термінал звіряє годинник із Gate раз на хвилину, тож відмова минає сама. Якщо вона повторюється постійно, увімкніть у Windows автоматичне встановлення часу та один раз синхронізуйте годинник вручну в параметрах дати й часу.