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 выводит личность копирования из типа ключа: Как вызывать API биржи, чтобы понять ключи, подписи и коды ошибок.

Три эндпоинта чтения специфичны для копирования: 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. Нет контрактов с маржой в монете, нет спота.

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

Вместо этого опрашивайте эндпоинт. Он имеет вес 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, чтобы увидеть, как продукт ведет себя в UI, прежде чем автоматизировать его, так как API отражает эту семантику, а не заменяет ее.

Часто задаваемые вопросы

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 может ухудшить ваши собственные исполнения из-за влияния на рынок. Автоматизированные системы добавляют операционный риск: устаревший белый список символов, истекшая метка времени, бан по лимиту скорости или необработанный код ошибки могут оставить позиции открытыми без активного управления. Лимит одного ключа означает, что скомпрометированные или ротированные учетные данные оставляют вас без запасного пути. Копитрейдинг не снимает необходимость рассчитывать позиции, которые вы могли бы позволить себе потерять. Ничто из этого не является инвестиционным советом — сверьте все параметры с текущей документацией API WEEX перед развертыванием капитала и подтвердите, что услуга доступна в вашей юрисдикции.