Налаштування API-ключа WEEX: як безпечно підключити сторонню платформу

Щоб підключити сторонню платформу до WEEX, створіть API-ключ WEEX у розділі «Обліковий запис» → «Керування API», надайте йому лише ті дозволи, які потрібні платформі, і вставте API-ключ, секретний ключ і парольну фразу на платформі. Якщо платформа є зареєстрованим брокером WEEX, кнопка «Увійти через WEEX» дасть змогу зробити те саме, не працюючи з ключем. У цьому посібнику розглянуто обидва способи підключення, безпечне розміщення першого ордера, найпоширеніші помилки та параметри безпеки, від яких залежить, якої шкоди може завдати витік ключа. Інструкції та обмеження актуальні станом на 7 жовтня 2026 року.

Швидке підключення чи ручний API-ключ WEEX: який спосіб обрати

Використовуйте швидке підключення, якщо платформа його пропонує, а в усіх інших випадках — ручний ключ.

Fast Connect — це авторизація WEEX через OAuth, про яку було оголошено 3 серпня 2026 року. На платформі партнера натисніть «Увійти через WEEX», перейдіть на сторінку авторизації WEEX, перегляньте дозволи (торгівлю та доступ для читання налаштовано заздалегідь) і підтвердьте дію. Потім WEEX створить API-ключ і надішле його на серверну частину платформи. Ви не побачите його й не копіюватимете. За даними WEEX, цей процес займає менше 10 секунд.

Є два нюанси. Сторінка авторизації розміщена на www.weex.com, тому перш ніж щось підтверджувати, перевірте адресу в адресному рядку. Крім того, правила OAuth WEEX дозволяють створювати один ключ на користувача для кожної сторонньої платформи. Щоб повторно підключити ту саму платформу, спочатку потрібно видалити старий ключ.

Ручний ключ працює з будь-яким програмним забезпеченням, що підтримує WEEX, зокрема з інструментами, які не є брокерами, і дає змогу повністю контролювати дозволи та прив’язку IP-адрес.

Як створити API-ключ WEEX: покрокова інструкція

1. Увійдіть у WEEX через вебсайт. Перейдіть до розділу «Обліковий запис», потім — «Керування API» і виберіть «Створити API-ключ». На сторінці WEEX API є кнопка «Створити API», яка відкриває той самий екран.
2. Назвіть ключ на честь платформи, для якої він призначений.
3. Створіть парольну фразу, використовуючи лише літери й цифри. У розділі FAQ WEEX зазначено, що спеціальні символи не приймаються. Відновити або змінити парольну фразу пізніше неможливо.
4. Виберіть дозволи. Для нових ключів за замовчуванням встановлено режим «Лише читання». Додавайте дозвіл на спотову торгівлю або ф’ючерси, лише якщо платформа здійснюватиме угоди на цьому ринку. Ці два торгові дозволи незалежні, тому ф’ючерсному боту не потрібен доступ до спотової торгівлі.
5. Прив’яжіть IP-адреси, якщо платформа публікує адреси, з яких вона підключається.
6. Пройдіть перевірку безпеки.
7. Скопіюйте API-ключ, секретний ключ і парольну фразу та збережіть їх у надійному місці. У посібниках HaasOnline і KoinX зазначено, що секретний ключ показується лише один раз.

Варто знати про три обмеження. Згідно з посібником WEEX із підготовки інтеграції, для кожного облікового запису можна створити до 10 груп API-ключів. Новий або відредагований ключ активується всюди приблизно за 15 хвилин. У посібнику KoinX також зазначено, що WEEX може попросити заповнити анкету для активації API та надіслати лист із підтвердженням, перш ніж ключ запрацює. Тож якщо ключ не працює в перші години, це не обов’язково означає, що його налаштовано неправильно.

Прив’язка ключа та розміщення першого ордера

На різних платформах три значення можуть називатися по-різному. Типовий приклад — HaasOnline, де підтримку WEEX додали 22 серпня 2026 року: відкрийте «Облікові записи бірж», виберіть спотову або ф’ючерсну торгівлю WEEX, введіть API-ключ як публічний ключ, а секретний ключ — як приватний, додайте парольну фразу та натисніть кнопку перевірки ключа. «Ключ доступу» та «публічний ключ» — це назви API-ключа.

Перш ніж запускати стратегію, вручну розмістіть через платформу один ордер:

1. Виберіть ліквідну торгову пару та вкажіть найменший дозволений платформою обсяг. Розмістіть лімітний ордер далеко від поточної ціни.
2. Переконайтеся, що ордер з’явився у відкритих ордерах безпосередньо на WEEX.
3. Скасуйте його на платформі та переконайтеся, що на WEEX він зник.

Цей цикл підтверджує, що ключ, дозвіл і відповідність торгової пари працюють, і нічого не коштує.

Якщо виникає помилка, зазвичай причина одна з наведених нижче:

• Помилка -1052, недостатньо дозволів. Для ключа не ввімкнено дозвіл на ф’ючерси або торгова пара не підтримується.
• Помилки дозволів для щойно створеного ключа. Зачекайте 15 хвилин.
• HTTP 429. Платформа надсилає забагато запитів. Ліміт WEEX для REST становить 500 одиниць ваги за 10 секунд на одну IP-адресу.
• Помилки підпису або парольної фрази. Одне з трьох значень вставлено не повністю або з зайвим пробілом.
• Запити відхиляються за ввімкненої прив’язки IP. Платформа підключається з адреси, якої немає у вашому списку.

У FAQ WEEX щодо API ф’ючерсів наведено повний перелік кодів.

Безпека API-ключа WEEX: шість параметрів, що обмежують збитки

Торговий ключ не дає змоги виводити кошти, але з його допомогою все одно можна втратити гроші. Відомий сценарій зловживання на будь-якій біржі: зловмисник використовує викрадений ключ лише для торгівлі, щоб купити неліквідний токен за завищеною ціною в облікового запису під власним контролем. Ці шість звичок допоможуть зменшити ризик.

1. Надавайте лише мінімально необхідні дозволи. Інструментам для податкової звітності та відстеження портфеля потрібен режим «Лише читання». Саме його запитує KoinX. Ключ лише для читання не може розміщувати ордери.
2. Прив’язуйте IP-адреси, якщо платформа це підтримує. У документації WEEX сказано, що ключі без прив’язки IP «становлять загрозу безпеці». Деякі сервіси не можуть працювати з фіксованим списком адрес. KoinX радить користувачам вимкнути обмеження за IP. Якщо платформі потрібен ключ без обмежень, залиште для нього режим лише читання.
3. Використовуйте окремий ключ для кожної платформи. Якщо можна створити до 10 груп ключів, немає причин спільно використовувати один ключ. Окремий ключ дає змогу відключити один сервіс, не порушуючи роботу інших, і визначити, який саме ключ витік.
4. Вважайте парольну фразу третім секретом. Не зберігайте її на знімках екрана, у чатах і зверненнях до служби підтримки. Рекомендація WEEX однозначна: «Ніколи не повідомляйте свою парольну фразу».
5. Відмовляйте, якщо запитують дозволи понад торгові. У посібниках з інтеграції серед дозволів для створюваних ключів зазначено «Лише читання», спотову торгівлю та ф’ючерси. Якщо платформа просить пароль для входу у WEEX або доступ до виведення коштів, їй потрібні можливості, яких торгівля не вимагає.
6. За найменшого сумніву видаляйте ключ. WEEX радить негайно видаляти скомпрометований ключ. Так само вчиняйте з ключами для платформ, якими більше не користуєтеся.

Як відключити платформу від WEEX

Видаліть ключ на самій платформі, а потім — у розділі керування API WEEX. Саме другий крок має вирішальне значення, адже ключ, видалений лише в налаштуваннях платформи, і далі працюватиме в усіх, хто має його копію.

Те саме правило діє для ключів, створених через Fast Connect. У посібнику WEEX з OAuth сказано, що наявний ключ потрібно видалити, перш ніж знову прив’язати обліковий запис до цієї платформи.

Підключення платформи до WEEX займає кілька хвилин, а вибір, зроблений за цей час, визначає рівень ризику, поки існує ключ: які дозволи надати, які IP-адреси прив’язати та чи буде ключ узагалі видалено після використання. Створювати ключі й керувати ними можна на сторінці WEEX API.

FAQ

1. Скільки API-ключів можна створити на WEEX?

Згідно з посібником WEEX із підготовки інтеграції, для кожного облікового запису можна створити до 10 груп API-ключів. Цього достатньо, щоб надати кожній підключеній платформі окремий ключ і мати змогу відкликати доступ одного сервісу, не впливаючи на інші.

2. Чи можна скинути втрачену парольну фразу API WEEX?

Ні. У документації WEEX зазначено, що втрачену парольну фразу неможливо відновити або змінити. Видаліть ключ, створіть новий із новою парольною фразою та оновіть дані на платформі, яка ним користувалася.

3. Чому мій новий API-ключ WEEX повертає помилку дозволів?

Зазвичай є три причини: не надано дозвіл на торгівлю, ключ не має доступу до ринку цієї торгової пари або ще не минув потрібний час. WEEX повідомляє, що активація нових або змінених ключів займає приблизно 15 хвилин, тож перш ніж змінювати налаштування, повторіть спробу після цього часу.

4. Чи підтримує WEEX підключення через TradingView або FIX?

У FAQ WEEX щодо API ф’ючерсів зазначено, що інтеграція з TradingView і FIX API не підтримуються. Підключення здійснюються через інтерфейси REST і WebSocket — безпосередньо або за допомогою платформи, яка їх інтегрувала.