API WEEX Copy Trading: Endpointy, limity i 5 kodów błędów

API WEEX copy trading zostało uruchomione 23 czerwca 2026 r. (UTC+8) i jest węższe oraz bardziej rygorystyczne niż ogólne API futures — co sprawia, że przed napisaniem jakiegokolwiek kodu warto dokładnie przeczytać drobny druk. Główny trader (lead trader) otrzymuje jeden dedykowany klucz, nie może dotykać rynku spot, nie może handlować parami spoza białej listy copy tradingu, a jego zachowania typu take-profit i stop-loss są wymuszone w jednym formacie. Obserwatorzy (followers) otrzymują coś, czego większość giełd w ogóle nie udostępnia: endpoint REST, który zapisuje ich własną konfigurację kopiowania, w tym limity poślizgu (slippage) i dźwignię dla poszczególnych symboli.

Ten przewodnik omawia, co faktycznie robi API copy tradingu, listę endpointów po obu stronach, rzeczywiste zakresy parametrów dla ustawień ryzyka obserwatora, kody błędów, które zepsują Twoją pierwszą integrację, oraz porównanie tego interfejsu z tym, co publikują Binance i Bybit.

Co API WEEX copy trading może, a czego nie może

API copy tradingu to interfejs przeznaczony wyłącznie dla kontraktów futures, podzielony na dwie role. Główny trader składa zlecenia za pomocą dedykowanego klucza API Copy Trading, a WEEX automatycznie przesyła wynikowe sygnały wykonania do obserwatorów — nigdy nie musisz samodzielnie pisać logiki rozsyłania. Obserwator używa zwykłego klucza API do konfigurowania i kontrolowania relacji kopiowania.

Środki, pozycje i wskaźnik ryzyka na koncie copy trading są odizolowane od zwykłego konta futures. Ta izolacja jest przydatna operacyjnie: zły dzień w Twoim portfelu dyskrecjonalnym nie może zlikwidować pozycji, które kopiują Twoi obserwatorzy. Jest to również uciążliwe zadanie uzgadniania, ponieważ /capi/v3/account/position/allPosition zwraca pozycje kopiowania, gdy jest wywoływane z kluczem kopiowania, oraz zwykłe pozycje futures, gdy jest wywoływane ze zwykłym kluczem. Ta sama ścieżka, inna odpowiedź, w zależności od tego, jakimi danymi uwierzytelniającymi się podpisałeś.

Kto może utworzyć klucz API copy trading i dlaczego otrzymujesz tylko jeden

Tylko konta, które przeszły weryfikację elite traderów WEEX, mogą utworzyć klucz API Copy Trading. Aplikujesz poprzez program elite trader — od lipca 2026 r. WEEX wymienia ponad 5000 elite traderów w ponad 150 krajach oraz fundusz elite traderów o wartości 2 000 000 $. Po zatwierdzeniu klucz jest tworzony w Centrum Użytkownika → Zarządzanie API → API Copy Trading, zabezpieczony hasłem do funduszy oraz weryfikacją dwuetapową.

Limit, który ma znaczenie dla Twojego planu wdrożenia: jeden klucz copy trading na konto tradera. Nie ma drugiego klucza do rotacji, co wyklucza przełączanie kluczy typu blue/green, z którego korzysta większość zespołów quant w celu rotacji danych uwierzytelniających bez przestojów. Jeśli wykonasz rotację, Twoja strategia będzie nieaktywna przez czas trwania zmiany — a wszyscy obserwatorzy pozostaną w swoich istniejących pozycjach, gdy będziesz offline. Planuj rotacje tak, jak planowałbyś migrację bazy danych, a nie jako zadanie w tle.

Uwierzytelnianie to standardowy schemat kontraktu WEEX: nagłówki ACCESS-KEY, ACCESS-SIGN, ACCESS-PASSPHRASE i ACCESS-TIMESTAMP, gdzie podpis to HMAC SHA256 nad timestamp + METHOD + requestPath + "?" + queryString + body, następnie zakodowany w Base64. Powiąż białą listę IP. W przypadku klucza, który może przesuwać kapitał obserwatorów, niepowiązany klucz stanowi znacznie większe ryzyko niż w przypadku osobistego klucza futures.

Endpointy głównego tradera ponownie wykorzystują stos zleceń futures

Nie ma osobnego wywołania "złóż zlecenie kopiowania". Główni traderzy korzystają ze standardowych endpointów futures V3, a WEEX wnioskuje o tożsamości kopiowania na podstawie typu klucza:

Trzy endpointy odczytu są specyficzne dla kopiowania: GET /capi/v3/copy/trader/pairs (waga 1, bez autoryzacji), GET /capi/v3/copy/trader/openOrders (waga 10) i GET /capi/v3/copy/trader/historyOrders (waga 10, maksymalny zakres 90 dni, paginacja kursora przez nextKeyId i nextKeyTime).

Pole, które warto monitorować, to followCount przy każdym zleceniu śledzenia. Informuje ono, ilu obserwatorów jest przypisanych do tej konkretnej pozycji i jest to najbliższa rzecz do pomiaru Twojego własnego wpływu na rynek w czasie rzeczywistym. Główny trader wchodzący w mało płynną parę altcoin perp z 3 obserwatorami i ten sam trader wchodzący z 300 nie realizują tej samej strategii — ten drugi wyprzedza samego siebie poprzez rozsyłanie kopiowania. Jeśli Twój średni poślizg wejścia pogarsza się wraz ze wzrostem followCount, to jest to mechanizm, a rozwiązaniem jest wielkość pozycji, a nie lepsza cena limit.

Endpointy obserwatora: gdzie WEEX idzie dalej niż większość API copy tradingu

To połowa API, która jest naprawdę nietypowa. Obserwatorzy otrzymują dostęp do zapisu własnej konfiguracji kopiowania przez REST:

Zwróć uwagę na asymetrię wag: closePos kosztuje 50, pięć razy więcej niż jakikolwiek inny endpoint w zestawie. WEEX nadaje każdemu endpointowi ważonemu przez IP niezależny budżet 500 na 10 sekund, więc ta waga przekłada się na około 10 wywołań closePos na 10 sekund w porównaniu do około 50 dla endpointów o wadze 10. Pętla, która zamyka zlecenia śledzenia jedno po drugim, szybko się dławi, a błędy 429 niosą ze sobą obowiązek wycofania się, a nie ponowienia próby. Jeśli zamykasz portfel obserwatora podczas szybkiego ruchu, stopCopy plus jedna decyzja dotycząca pozostałej ekspozycji jest tańsza niż iterowanie closePos przez każdą pozycję — i nadal będzie odpowiadać, gdy naiwna pętla będzie zużywać limity szybkości.

Parametry ryzyka copy tradingu i ich rzeczywiste zakresy

POST /capi/v3/copy/follower/settings przyjmuje albo konfigurację unified dla listy symboli, albo tablicę per_symbol. Oto faktycznie akceptowane wartości — liczby, które decydują o tym, czy Twoje żądanie konfiguracji zakończy się sukcesem:

Dwa z tych parametrów kosztują pieniądze. slippageRatio: 0 wygląda jak najbezpieczniejsza wartość w tabeli, a jest najbardziej niebezpieczna: całkowicie wyłącza limit poślizgu, więc zlecenie kopiowania wypełnia się po cenie, którą oferuje arkusz, gdy sygnał dotrze. Jeśli chcesz ochrony, zakres wynosi od 0,001 do 0,01 (0,1% do 1%) i musisz to wyraźnie określić.

Drugi to kompromis projektowy ukryty w notatce o dozwolonych wartościach: w trybie per_symbol, marginType akceptuje tylko trader. Wybierz szczegółową kontrolę dla każdego symbolu, a odziedziczysz tryb marży głównego tradera dla każdego symbolu. Jeśli chciałeś izolowanej marży na jednej zmiennej parze, podczas gdy główny trader używa cross, per_symbol nie może tego wyrazić — unified może. Większość integracji sięga po per_symbol, ponieważ brzmi to bardziej precyzyjnie, i rezygnuje z kontroli trybu marży, aby to osiągnąć.

Jeszcze jedna rzecz, która ugryzie każdego budującego pętlę odczyt-modyfikacja-zapis: GET i POST na tej ścieżce nie współdzielą nazw pól. Odczyt ustawień zwraca settingMode, maxHoldSize i takeProfitRatio; zapis wymaga settingType, maxHoldQty i stopProfitRatio. GET wymaga również traderId i zwraca tablicę — jeden element dla unified, jeden na symbol dla per_symbol. Ponowne przesłanie obiektu odpowiedzi bezpośrednio do POST spowoduje niepowodzenie walidacji parametrów, więc mapuj pola jawnie, zamiast zakładać symetrię.

Które pary obsługuje API copy tradingu i dlaczego nie powinieneś ich kodować na sztywno

GET /capi/v3/copy/trader/pairs zwróciło 124 symbole, wszystkie z depozytem zabezpieczającym w USDT, podczas sprawdzania 30 lipca 2026 r. — od BTCUSDT i ETHUSDT po nowsze notowania, takie jak ASTERUSDT, PUMPUSDT i STBLUSDT. Brak kontraktów z depozytem w coinach, brak spotu.

Ta lista się zmienia, a statyczne wersje krążące w materiałach startowych są już nieaktualne. Statyczna tabela par w instrukcji API WEEX Copy Trading zawiera 74 tickery; sprawdzone w odniesieniu do endpointu na żywo 30 lipca 2026 r., STXUSDT i IPUSDT znajdują się w tej tabeli, ale są nieobecne w odpowiedzi API, podczas gdy BTCUSDT, XRPUSDT i DOGEUSDT są aktywne, ale brakuje ich w tabeli. Buduj swoją białą listę na podstawie dokumentu, a Twój bot odrzuci Bitcoina, akceptując dwie pary, które już się nie kopiują.

Zamiast tego odpytuj endpoint. Ma wagę 1 — najtańsze wywołanie w całym interfejsie copy tradingu — i nie wymaga autoryzacji, więc nie ma dobrego powodu, aby buforować go poza sesją handlową. Zanim włączysz parę, sprawdź sam kontrakt: strona wieczysta BTC/USDT pokazuje cenę mark na żywo, stopę finansowania i odliczanie, do którego rozliczą się Twoje pozycje kopiowania.

Pięć kodów błędów, które zepsują Twoją pierwszą integrację

Blok 50xx jest specyficzny dla copy tradingu i to tutaj zawodzi przeniesiony kod:

-5003 i -5004 razem stanowią prawdziwe zagrożenie przy portowaniu. Kod strategii, który skaluje pozycję z częściowymi take-profitami lub ustawia TP po cenie limit, działa dobrze na zwykłym kluczu futures, a zawodzi przy każdym wywołaniu z kluczem kopiowania. TP/SL kopiowania to wszystko albo nic i tylko po cenie rynkowej, ponieważ częściowe lub limitowane wyjścia nie mogą być spójnie odzwierciedlone u obserwatorów z różnymi wielkościami pozycji. Zaplanuj logikę wyjścia wokół tego ograniczenia, zamiast odkrywać to podczas sesji na żywo.

Uwzględnij również -1046 (timestamp wygasł — zsynchronizuj zegar, nie ponawiaj prób ślepo), -1056 (ILLEGAL_IP, co oznacza, że żądanie pochodzi spoza Twojej białej listy) i -1059 (HIGH_FREQUENCY_ORDER_LIMITED, ograniczenie liczby zleceń, które jest oddzielone od budżetu wagowego i łatwo je wywołać za pomocą gadatliwego generatora sygnałów). -5000 dopełnia blok 50xx i po prostu informuje o konieczności kontaktu z WEEX.

Jak API WEEX copy trading wypada na tle Binance i Bybit

To, co oznacza "API copy trading", drastycznie różni się w zależności od miejsca, a różnicę warto sprawdzić, zanim założysz przenośność:

Wzorce w branży są takie, że giełdy wystawiają stronę lead-tradera, a stronę obserwatora trzymają wewnątrz aplikacji. Publikacja przez WEEX endpointu zapisu po stronie obserwatora jest znaczącą różnicą: oznacza to, że narzędzie strony trzeciej, pulpit nawigacyjny portfela lub nakładka ryzyka mogą programowo dostosować lub zabić relację kopiowania bez scrapowania ekranu. Jeśli budujesz narzędzia dla obserwatorów, a nie strategię lead-tradera, to jest to decydująca funkcja i dlatego API kopiowania jest dla integratorów warte więcej, niż sugeruje nagłówek "mamy API copy trading".

Szczegóły parametrów zmieniają się bez większego rozgłosu na tak nowym interfejsie, więc traktuj oficjalną dokumentację API copy tradingu jako źródło prawdy i porównuj ją ze swoją integracją przed każdym wydaniem.

Co zrobić dalej

API WEEX copy trading to mały, oparty na opiniach interfejs: 10 ścieżek zleceń ponownie wykorzystanych z API futures, 3 odczyty lead-tradera, 7 endpointów obserwatora, jeden klucz na tradera i blok błędów 50xx, który koduje większość jego ograniczeń. Trzy rzeczy, które należy dobrze ustawić przed pierwszym sygnałem na żywo, to lista par (odpytuj ją, nie koduj na sztywno), slippageRatio (nigdy nie zostawiaj go na 0, chyba że masz na myśli brak limitu) oraz TP/SL po cenie rynkowej dla pełnej pozycji. Wszystko inne to standardowa integracja kontraktu WEEX.

Jeśli chcesz być liderem, a nie integratorem, API copy tradingu jest dostępne dopiero po zatwierdzeniu jako elite trader — zacznij od centrum WEEX Copy Trade, aby zobaczyć, jak produkt zachowuje się w interfejsie użytkownika, zanim go zautomatyzujesz, ponieważ API odzwierciedla te semantyki, zamiast je zastępować.

FAQ

1. Kto może korzystać z API WEEX copy trading?

Tylko konta zatwierdzone jako elite traderzy WEEX mogą utworzyć klucz API Copy Trading i składać zlecenia kopiowania programowo. Obserwatorzy nie potrzebują specjalnego klucza — konfigurują i kontrolują kopiowanie za pomocą zwykłego klucza API.

2. Ile kluczy API copy trading mogę utworzyć?

Jeden na konto tradera. Nie ma drugiego klucza do rotacji, więc planuj zmiany danych uwierzytelniających jako zaplanowane okno serwisowe.

3. Czy API WEEX copy trading obsługuje trading spot?

Nie. Jest to tylko dla futures i tylko dla par na białej liście copy tradingu — 124 symbole z depozytem w USDT na dzień 30 lipca 2026 r. Wywołania spot i pary spoza białej listy są odrzucane.

4. Czy obserwator może zmieniać ustawienia kopiowania przez API?

Tak. POST /capi/v3/copy/follower/settings zapisuje konfigurację kopiowania, w tym tryb wielkości, maksymalną ilość posiadania, wskaźniki take-profit i stop-loss, limit poślizgu, typ marży i dźwignię. Obserwatorzy mogą również wywołać closePos i stopCopy.

5. Dlaczego moje zlecenie take-profit nie działa z kluczem API copy trading?

Prawie na pewno -5003 lub -5004. Klucze kopiowania akceptują tylko TP/SL pełnej pozycji (quantity musi wynosić 0) wykonane po cenie rynkowej (executePrice musi być null lub 0). Częściowe lub limitowane wyjścia są odrzucane.

6. Jaki jest limit szybkości w API copy tradingu?

Endpointy kopiowania są ważone przez IP, a każdy endpoint ograniczony przez IP ma niezależny budżet 500 na 10 sekund. Wagi różnią się — closePos to 50 w porównaniu do 10 dla większości innych, więc około 10 kontra 50 wywołań na 10 sekund. Przekroczenie zwraca 429, a -1059 to oddzielne ograniczenie dla rafali zleceń.

7. Czy środki copy tradingu są oddzielone od mojego zwykłego konta futures?

Tak. Środki, pozycje i wskaźnik ryzyka są w pełni odizolowane, więc dwa konta nie mogą się wzajemnie likwidować. Pamiętaj, że /capi/v3/account/position/allPosition zwraca to konto, które pasuje do klucza, którym się podpisałeś.

Ostrzeżenie o ryzyku

Aktywa kryptograficzne są wysoce zmienne, a handel nimi może skutkować częściową lub całkowitą utratą kapitału. API WEEX copy trading dodaje ryzyko wykraczające poza zwykły handel futures. Dźwignia na pozycjach kopiowania jest domyślnie ustawiona na 10x i może być ustawiona wyżej, co skraca ruch potrzebny do likwidacji. Ustawienie slippageRatio na 0 całkowicie usuwa limit poślizgu, więc zlecenia kopiowania mogą wypełnić się daleko od ceny głównego tradera w zmiennych warunkach. Jako obserwator jesteś narażony na ryzyko kontrahenta i ryzyko behawioralne głównego tradera, którego strategia może zmienić się bez powiadomienia, a którego przeszłe wyniki nie przewidują przyszłych wyników; jako główny trader, rosnący followCount może pogorszyć Twoje własne wypełnienia poprzez wpływ na rynek. Zautomatyzowane systemy dodają ryzyko operacyjne: nieaktualna biała lista symboli, wygasły timestamp, ban za limit szybkości lub nieobsługiwany kod błędu mogą pozostawić pozycje otwarte bez aktywnego zarządzania. Limit jednego klucza oznacza, że skompromitowane lub obrócone dane uwierzytelniające pozostawiają Cię bez ścieżki awaryjnej. Copy trading nie usuwa potrzeby ustalania wielkości pozycji, na których utratę mógłbyś sobie pozwolić. Nic tutaj nie jest poradą inwestycyjną — zweryfikuj wszystkie parametry z aktualną dokumentacją API WEEX przed zainwestowaniem kapitału i potwierdź, że usługa jest dostępna w Twojej jurysdykcji.