API для копітрейдингу WEEX: ендпоінти, ліміти та 5 кодів помилок

API для копітрейдингу WEEX запрацювало 23 червня 2026 року (UTC+8), і воно є вужчим та суворішим за звичайне API для ф'ючерсів — саме тому варто ознайомитися з усіма деталями, перш ніж писати код. Провідний трейдер отримує один виділений ключ, не може торгувати на споті, не може торгувати парами поза білим списком копітрейдингу, а його налаштування тейк-профіту та стоп-лоссу зведені до єдиного формату. Підписники отримують те, чого не пропонують більшість бірж: REST-ендпоінт, що записує їхню власну конфігурацію копіювання, включаючи ліміти проковзування та кредитне плече для кожного символу.

Цей посібник охоплює функціонал API для копітрейдингу, список ендпоінтів для обох сторін, реальні діапазони параметрів для налаштувань ризику підписника, коди помилок, що можуть зупинити вашу першу інтеграцію, а також порівняння з тим, що пропонують Binance та Bybit.

Що може і чого не може API для копітрейдингу WEEX

API для копітрейдингу — це інтерфейс виключно для ф'ючерсів, розділений на дві ролі. Провідний трейдер розміщує ордери за допомогою спеціального API-ключа для копітрейдингу, а WEEX автоматично передає сигнали виконання підписникам — вам не потрібно самостійно писати логіку розсилки. Підписник використовує звичайний API-ключ для налаштування та керування відносинами копіювання.

Кошти, позиції та коефіцієнт ризику в акаунті копітрейдингу ізольовані від звичайного ф'ючерсного акаунта. Ця ізоляція корисна на практиці: невдалий день у вашій дискреційній торгівлі не призведе до ліквідації позицій, які копіюють ваші підписники. Це також вимагає звірки, оскільки /capi/v3/account/position/allPosition повертає позиції копіювання при виклику з ключем копітрейдингу та звичайні ф'ючерсні позиції при виклику зі звичайним ключем. Один шлях, різні відповіді залежно від того, якими даними ви авторизувалися.

Хто може створити API-ключ для копітрейдингу і чому він лише один

Лише акаунти, що пройшли перевірку елітних трейдерів WEEX, можуть створити API-ключ для копітрейдингу. Ви подаєте заявку через програму елітних трейдерів — станом на липень 2026 року WEEX налічує понад 5000 елітних трейдерів у 150+ країнах та фонд елітних трейдерів у розмірі $2,000,000. Після схвалення ключ створюється в розділі Центр користувача → Керування API → API копітрейдингу, захищений паролем фонду та двофакторною автентифікацією.

Ліміт, важливий для вашого плану розгортання: один ключ копітрейдингу на акаунт трейдера. Другого ключа для ротації немає, що виключає схему blue/green, яку використовують більшість квантових команд для ротації без простоїв. Якщо ви ротуєте ключ, ваша стратегія стає недоступною на час заміни — і всі підписники залишаються у своїх позиціях, поки ви офлайн. Плануйте ротації як міграцію бази даних, а не як фонове завдання.

Автентифікація відповідає стандартній схемі WEEX: заголовки ACCESS-KEY, ACCESS-SIGN, ACCESS-PASSPHRASE та ACCESS-TIMESTAMP, де підпис — це HMAC SHA256 від timestamp + METHOD + requestPath + "?" + queryString + body, закодований у Base64. Прив'яжіть IP до білого списку. Для ключа, що може керувати капіталом підписників, неприв'язаний ключ є значно більшим ризиком, ніж для особистого ф'ючерсного ключа.

Ендпоінти провідного трейдера використовують стек ф'ючерсних ордерів

Окремого виклику "розмістити копі-ордер" не існує. Провідні трейдери звертаються до стандартних ф'ючерсних ендпоінтів V3, а WEEX визначає ідентичність копіювання за типом ключа:

Три ендпоінти читання є специфічними для копіювання: GET /capi/v3/copy/trader/pairs (вага 1, без автентифікації), GET /capi/v3/copy/trader/openOrders (вага 10) та GET /capi/v3/copy/trader/historyOrders (вага 10, максимальний діапазон 90 днів, курсорна пагінація через nextKeyId та nextKeyTime).

Поле, яке варто відстежувати — followCount у кожному ордері. Воно показує, скільки підписників прикріплено до цієї позиції, і це найближчий показник вашого реального впливу на ринок. Провідний трейдер, що входить у тонкий альткоїн-перпетуал з 3 підписниками, і той самий трейдер з 300 підписниками — це різні стратегії, адже другий випереджає сам себе через розсилку копій. Якщо ваше середнє проковзування на вході погіршується зі зростанням followCount, це і є механізм, і рішення полягає у розмірі позиції, а не в кращій лімітній ціні.

Ендпоінти підписника: де WEEX випереджає більшість API копітрейдингу

Це та частина API, яка є справді незвичною. Підписники отримують доступ на запис до власної конфігурації копіювання через REST:

Зверніть увагу на асиметрію ваги: closePos коштує 50, що вп'ятеро більше за будь-який інший ендпоінт. WEEX надає кожному IP-зваженому ендпоінту незалежний бюджет 500 на 10 секунд, тому ця вага означає приблизно 10 викликів closePos на 10 секунд проти близько 50 для ендпоінтів з вагою 10. Цикл, що закриває ордери по одному, швидко обмежить швидкість, а помилки 429 вимагають відступу, а не повторної спроби. Якщо ви закриваєте книгу підписника під час швидкого руху, stopCopy плюс одне рішення щодо залишку експозиції дешевше, ніж ітерація closePos по кожній позиції — і це все ще працюватиме, коли наївний цикл отримуватиме помилки ліміту швидкості.

Параметри ризику копітрейдингу та їхні реальні діапазони

POST /capi/v3/copy/follower/settings приймає або unified конфігурацію для списку символів, або масив per_symbol. Це реальні прийняті значення — числа, що вирішують, чи буде ваш запит успішним:

Два з цих параметрів можуть коштувати грошей. slippageRatio: 0 виглядає як найбезпечніше значення, але є найнебезпечнішим: воно повністю вимикає ліміт проковзування, тому копі-ордер виконується за ціною, яку пропонує книга в момент надходження сигналу. Якщо вам потрібен захист, діапазон становить від 0.001 до 0.01 (0.1% до 1%), і ви повинні вказати це явно.

Друге — це компроміс дизайну, прихований у примітці: у режимі per_symbol параметр marginType приймає лише trader. Обираючи детальний контроль за символами, ви успадковуєте режим маржі провідного трейдера для кожного символу. Якщо ви хотіли ізольовану маржу на одній волатильній парі, поки трейдер використовує крос-маржу, per_symbol цього не дозволить — unified може. Більшість інтеграцій обирають per_symbol, бо це звучить точніше, але втрачають контроль над режимом маржі.

Ще одна річ, яка завадить кожному, хто будує цикл читання-зміни-запису: GET та POST на цьому шляху не мають однакових назв полів. Читання налаштувань повертає settingMode, maxHoldSize та takeProfitRatio; запис потребує settingType, maxHoldQty та stopProfitRatio. GET також потребує traderId і повертає масив — один елемент для unified, по одному на символ для per_symbol. Пряме повернення об'єкта відповіді в POST призведе до помилки валідації параметрів, тому мапіть поля явно, не припускаючи симетрії.

Які пари підтримує API копітрейдингу і чому не варто їх хардкодити

GET /capi/v3/copy/trader/pairs повернув 124 символи, всі з маржею в USDT, станом на 30 липня 2026 року — від BTCUSDT та ETHUSDT до нових лістингів, таких як ASTERUSDT, PUMPUSDT та STBLUSDT. Жодних контрактів з маржею в монетах, жодного споту.

Цей список змінюється, і статичні версії, що циркулюють у матеріалах запуску, вже застаріли. Статична таблиця пар у посібнику WEEX API містить 74 тікери; перевірка через ендпоінт 30 липня 2026 року показала, що STXUSDT та IPUSDT є в таблиці, але відсутні у відповіді API, тоді як BTCUSDT, XRPUSDT та DOGEUSDT активні, але відсутні в таблиці. Створюйте свій білий список на основі даних, інакше ваш бот відхилить Bitcoin, приймаючи дві пари, які більше не копіюються.

Опитуйте ендпоінт. Він має вагу 1 — найдешевший виклик у всьому інтерфейсі копітрейдингу — і не потребує автентифікації, тому немає причин кешувати його довше, ніж на торгову сесію. Перед активацією пари перевірте сам контракт: сторінка безстрокових контрактів BTC/USDT показує поточну ціну маркування, ставку фінансування та зворотний відлік, за якими будуть розраховуватися ваші копі-позиції.

П'ять кодів помилок, що зупинять вашу першу інтеграцію

Блок 50xx специфічний для копітрейдингу, і саме тут виникають помилки при портуванні коду:

-5003 та -5004 разом є справжньою небезпекою при портуванні. Код стратегії, що масштабує вихід з позиції частковими тейк-профітами або встановлює лімітний TP, працює зі звичайним ф'ючерсним ключем, але видає помилку з ключем копіювання. TP/SL копіювання — це "все або нічого" і тільки за ринком, оскільки часткові або лімітні виходи неможливо послідовно відобразити для підписників з різними розмірами позицій. Плануйте логіку виходу з урахуванням цього обмеження.

Також враховуйте -1046 (час дії минув — синхронізуйте годинник, не повторюйте сліпо), -1056 (ILLEGAL_IP, запит з-поза білого списку) та -1059 (HIGH_FREQUENCY_ORDER_LIMITED, обмеження на сплески ордерів, що працює окремо від бюджету ваги). -5000 завершує блок 50xx і просто вказує на необхідність зв'язатися з WEEX.

Як API копітрейдингу WEEX порівнюється з Binance та Bybit

Те, що означає "API копітрейдингу", сильно відрізняється залежно від майданчика, і цю різницю варто перевірити перед припущенням про сумісність:

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

Деталі параметрів змінюються без особливого розголосу на такій новій поверхні, тому сприймайте офіційну документацію API копітрейдингу як джерело істини та порівнюйте її зі своєю інтеграцією перед кожним релізом.

Що робити далі

API копітрейдингу WEEX — це невелика, спеціалізована поверхня: 10 шляхів ордерів, запозичених з ф'ючерсного API, 3 читання провідного трейдера, 7 ендпоінтів підписника, один ключ на трейдера та блок помилок 50xx, що кодує більшість обмежень. Три речі, які потрібно правильно налаштувати перед першим живим сигналом: список пар (опитуйте його, не хардкодьте), slippageRatio (ніколи не залишайте 0, якщо не маєте на увазі безліміт) та TP/SL для всієї позиції за ринком. Все інше — стандартна інтеграція контрактів WEEX.

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

FAQ

1. Хто може використовувати API копітрейдингу WEEX?

Лише акаунти, схвалені як елітні трейдери WEEX, можуть створювати API-ключ копітрейдингу та програмно розміщувати копі-ордери. Підписникам не потрібен спеціальний ключ — вони налаштовують та керують копіюванням за допомогою звичайного API-ключа.

2. Скільки API-ключів копітрейдингу я можу створити?

Один на акаунт трейдера. Другого ключа для ротації немає, тому плануйте зміну облікових даних як вікно планового обслуговування.

3. Чи підтримує API копітрейдингу WEEX спотову торгівлю?

Ні. Це лише ф'ючерси, і тільки для пар з білого списку копітрейдингу — 124 символи з маржею в USDT станом на 30 липня 2026 року. Спотові виклики та пари поза білим списком відхиляються.

4. Чи може підписник змінювати налаштування копіювання через API?

Так. POST /capi/v3/copy/follower/settings записує конфігурацію копіювання, включаючи режим розміру, максимальну кількість утримання, коефіцієнти тейк-профіту та стоп-лоссу, ліміт проковзування, тип маржі та кредитне плече. Підписники також можуть викликати closePos та stopCopy.

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

Майже напевно це -5003 або -5004. Ключі копіювання приймають лише TP/SL всієї позиції (quantity має бути 0), виконані за ринком (executePrice має бути null або 0). Часткові або лімітні виходи відхиляються.

6. Який ліміт швидкості в API копітрейдингу?

Ендпоінти копіювання зважуються за IP, і кожен ендпоінт з обмеженням IP має незалежний бюджет 500 на 10 секунд. Вага відрізняється — closePos має вагу 50 проти 10 для більшості інших, тому приблизно 10 проти 50 викликів на 10 секунд. Порушення повертає 429, а -1059 — це окремий дросель на сплески ордерів.

7. Чи окремі кошти копітрейдингу від мого звичайного ф'ючерсного акаунта?

Так. Кошти, позиції та коефіцієнт ризику повністю ізольовані, тому два акаунти не можуть ліквідувати один одного. Зауважте, що /capi/v3/account/position/allPosition повертає той акаунт, який відповідає ключу, яким ви підписали запит.

Попередження про ризики

Криптоактиви дуже волатильні, і торгівля ними може призвести до часткової або повної втрати капіталу. API копітрейдингу WEEX додає ризики, що виходять за межі звичайної торгівлі ф'ючерсами. Кредитне плече на копі-позиціях за замовчуванням становить 10x і може бути встановлене вище, що стискає рух, необхідний для вашої ліквідації. Встановлення slippageRatio на 0 повністю видаляє ліміт проковзування, тому копі-ордери можуть виконуватися далеко від ціни провідного трейдера під час волатильності. Як підписник, ви піддаєтеся контрагентському та поведінковому ризику від провідного трейдера, чия стратегія може змінитися без попередження, а минулі результати не гарантують майбутніх; як провідний трейдер, зростання followCount може погіршити ваші власні виконання через вплив на ринок. Автоматизовані системи додають операційний ризик: застарілий білий список символів, прострочений часовий штамп, бан за ліміт швидкості або необроблений код помилки можуть залишити позиції відкритими без активного керування. Ліміт на один ключ означає, що скомпрометовані або ротовані облікові дані залишають вас без шляху відступу. Копітрейдинг не скасовує необхідність розміщувати позиції, які ви можете дозволити собі втратити. Ніщо з цього не є інвестиційною порадою — перевіряйте всі параметри згідно з поточною документацією WEEX API перед розгортанням капіталу та підтвердьте, що послуга доступна у вашій юрисдикції.