Jak utworzyć klucz API WEEX bez blokady konta

Utworzenie klucza API WEEX zajmuje około dwóch minut. Uzyskanie takiego, który faktycznie działa przy pierwszym wywołaniu, zajmuje nieco więcej czasu, ponieważ trzy najczęstsze punkty awarii — zasada dotycząca znaków w haśle (passphrase), około 15-minutowe opóźnienie propagacji oraz fakt, że uprawnienia do handlu są oddzielne dla każdego rynku — są udokumentowane w miejscach, do których większość samouczków nigdy nie zagląda.

Ten przewodnik przeprowadzi Cię przez cały proces: co przygotować przed kliknięciem Utwórz, które pola uprawnień zaznaczyć dla spotu, a które dla kontraktów terminowych, jak lista dozwolonych adresów IP faktycznie przyjmuje dane wejściowe, jak przetestować klucz w punktach końcowych handlu papierowego (paper-trading) WEEX przed zaangażowaniem prawdziwych pieniędzy oraz jak odczytać dwa różne schematy kodów błędów, na które natrafisz. Wszystkie dane poniżej pochodzą z własnej dokumentacji API WEEX oraz strony Zarządzania API na dzień 6 sierpnia 2026 r.; FAQ dla programistów było ostatnio aktualizowane 14.04.2026 r.

Co przygotować przed utworzeniem klucza API WEEX

Zanim klucz zostanie uwierzytelniony, muszą zostać spełnione trzy warunki.

Uwierzytelnianie dwuskładnikowe musi być powiązane. WEEX zwraca błąd -1055 (USER_AUTH_NOT_SAFE, "Użytkownik musi powiązać telefon lub Google Authenticator"), gdy konto bez 2FA próbuje użyć klucza API. Powiąż Google Authenticator najpierw, a nie później.

Musisz wiedzieć, na jakim rynku handlujesz. Spot i kontrakty terminowe to oddzielne zakresy uprawnień i oddzielne domeny REST — api-spot.weex.com dla spotu, api-contract.weex.com dla kontraktów terminowych. Klucz, który działa idealnie w punktach końcowych spot, zwróci błąd uprawnień w kontraktach, jeśli nie zaznaczyłeś pola Futures.

Potrzebujesz adresu IP, z którego Twój kod będzie wysyłał zapytania. Nie adresu IP Twojego laptopa, jeśli bot działa na VPS. Błąd w tym zakresie powoduje błąd -1056 (ILLEGAL_IP), a ponieważ lista dozwolonych adresów jest ustawiana w momencie tworzenia, naprawienie tego oznacza edycję klucza i ponowne oczekiwanie na zakończenie propagacji.

Każde konto może posiadać do 10 grup kluczy API, więc jest miejsce, aby zachować klucz monitorujący tylko do odczytu oddzielnie od klucza handlowego, zamiast używać jednego do wszystkiego.

Jak utworzyć klucz API WEEX: Sześciostopniowa ścieżka

Cały proces odbywa się na platformie internetowej. Użytkownicy aplikacji mobilnej muszą dokończyć tworzenie klucza w przeglądarce.

1. Zaloguj się do WEEX i otwórz Konto → Zarządzanie API lub przejdź bezpośrednio do strony Zarządzania API.
2. Kliknij Utwórz klucz API i przejdź weryfikację bezpieczeństwa.
3. Nazwij klucz tak, aby identyfikował jego zadanie — grid-bot-spot, pnl-dashboard-readonly. Gdy zarządzasz kilkoma kluczami, nazwa typu api1 sprawia, że niewłaściwy klucz trafia do konfiguracji handlu na żywo.
4. Ustaw hasło (passphrase). Używaj tylko liter i cyfr. FAQ dla programistów WEEX wyraźnie odradza używanie znaków specjalnych, a hasło je zawierające jest częstą przyczyną błędów uwierzytelniania, które wyglądają jak błędy podpisu.
5. Zaznacz potrzebne uprawnienia. Nowe klucze domyślnie mają ustawienie Tylko do odczytu.
6. Wprowadź listę dozwolonych adresów IP, a następnie zapisz. APIKey, SecretKey i hasło są wyświetlane tylko raz.

Zapisz wszystkie trzy natychmiast. SecretKey nie może zostać później odzyskany, a hasła nie można zresetować ani zmodyfikować — jeśli zgubisz którekolwiek z nich, jedyną drogą naprzód jest usunięcie klucza i utworzenie nowego.

Które uprawnienia klucza API WEEX należy włączyć?

Zaznacz tylko zakres, którego potrzebuje Twój kod. Opublikowany zestaw uprawnień WEEX na sierpień 2026 r.:

Warto zwrócić uwagę na dwie rzeczy.

Te zakresy są niezależne, a nie hierarchiczne. Zaznaczenie Futures nie przyznaje uprawnień Spot. Strategia, która zabezpiecza pozycję spot za pomocą kontraktu terminowego, wymaga zaznaczenia obu pól, w przeciwnym razie zawiedzie w połowie z błędem -1052 (INSUFFICIENT_PERMISSIONS) — co jest dokładnie tym rodzajem awarii, którego najmniej chcesz w trakcie handlu.

Ogólna porada dotycząca bezpieczeństwa przeniesiona z innych przewodników giełdowych — "zawsze wyłączaj uprawnienia do wypłat" — nie odnosi się do WEEX w sposób, w jaki ludzie zakładają. Udokumentowany zestaw uprawnień WEEX obejmuje Readonly, Spot i Futures; zakres wypłat nie znajduje się wśród opcji prezentowanych przy tworzeniu klucza. Eliminuje to najgorszy skutek wycieku klucza, ale nie czyni wyciekłego klucza handlowego nieszkodliwym. Ktoś z Twoimi danymi logowania Spot lub Futures nadal może opróżnić konto poprzez celowo złe wypełnienia zleceń na mało płynnych parach.

Hasło, klucz tajny i zasady listy dozwolonych adresów IP

Trzy poświadczenia pełnią różne funkcje, a tylko jedno z nich można odzyskać.

Lista dozwolonych adresów IP akceptuje do 10 adresów, wprowadzanych jako pojedynczy ciąg oddzielony przecinkami — 192.168.1.213,192.168.1.214,192.168.1.215, w formacie, którego używa strona Zarządzania API WEEX jako przykładu. Powiąż go. Dokumentacja WEEX bezpośrednio wskazuje, że nieograniczone klucze stanowią zagrożenie bezpieczeństwa i jest to jedyna kontrola, która sprawia, że wyciekły SecretKey jest prawie bezużyteczny dla każdego, kto go posiada.

Pułapka: jeśli Twój dostawca VPS zmieni Twój adres IP lub rozwijasz oprogramowanie z połączenia domowego z dynamicznym adresem, klucz przestaje działać bez ostrzeżenia i bez oczywistej przyczyny. Użyj statycznego adresu IP lub zaakceptuj, że będziesz okresowo edytować listę dozwolonych adresów — a każda edycja oznacza ponowne oczekiwanie na propagację.

Przetestuj swój klucz API WEEX przed zaryzykowaniem prawdziwych środków

Nie pozwól, aby zlecenie na żywo było Twoim pierwszym uwierzytelnionym zapytaniem.

WEEX podpisuje zapytania za pomocą HMAC SHA256 nad timestamp + method.toUpperCase() + requestPath + "?" + queryString + body, zakodowanym w Base64. Znacznik czasu jest w milisekundach — 13 cyfr — a zapytania są odrzucane, jeśli odbiegają o więcej niż 30 sekund od czasu serwera. Jeśli zegar Twojego serwera dryfuje, każde prywatne wywołanie kończy się błędem -1046, niezależnie od tego, jak poprawna jest reszta Twojego kodu. Zapytaj o punkt końcowy czasu serwera WEEX i zsynchronizuj się z nim, zamiast ufać lokalnemu zegarowi. Pełna specyfikacja znajduje się na stronie przygotowania API spot.

Rozsądna sekwencja testowa:

1. Najpierw wywołaj publiczny punkt końcowy. Brak uwierzytelniania. Jeśli to zawiedzie, problemem jest sieć lub domena, a nie Twój klucz.
2. Wywołaj zapytanie o saldo. To ćwiczy podpis, hasło i listę dozwolonych adresów IP razem, bez dotykania uprawnień, których możesz nie mieć.
3. Użyj punktów końcowych handlu papierowego. WEEX dostarcza demonstracyjne punkty końcowe kontraktów terminowych — GET /capi/v3/sim/balance, GET /capi/v3/sim/position/allPosition, POST /capi/v3/sim/order, GET /capi/v3/sim/order/history — które symulują pełną pętlę handlową w SUSDT bez zużywania prawdziwych aktywów. Obsługiwane są pozycje dwukierunkowe w trybie hedgingu, więc możesz poprawnie debugować logikę pozycji, zamiast ją przybliżać.
4. Złóż jedno zlecenie na żywo o minimalnej wielkości na płynnej parze, a następnie anuluj je.

Buduj w oparciu o punkty końcowe V3. V1 i V2 są wycofywane, a zaskakująco duża część zgłoszeń "API nie działa" wynika z kodu napisanego dla starszej wersji.

Błędy klucza API WEEX i ich rzeczywiste przyczyny

Dwa schematy kodów błędów działają jednocześnie — dokumentacja V3 używa ujemnych czterocyfrowych kodów, podczas gdy starsze odniesienie w centrum pomocy WEEX wymienia starsze kody 4xxxx. Oba opisują te same podstawowe awarie. To mapowanie to część, która oszczędza najwięcej czasu na debugowaniu:

To 15-minutowe okno propagacji zasługuje na podkreślenie, ponieważ jest to najczęściej błędnie diagnozowany problem z API WEEX. Nowo utworzone i nowo zmodyfikowane klucze potrzebują około 15 minut, aby rozprzestrzenić się w systemach WEEX. Programiści, którzy edytują listę dozwolonych adresów, ponawiają próbę natychmiast, otrzymują -1056 i zaczynają przepisywać swoją funkcję podpisywania, debugują problem, który rozwiązałby się sam. Pełna lista znajduje się w odniesieniu do kodów błędów API WEEX.

Jeśli uprawnienia są poprawne, a klucz nadal zwraca błędy ograniczeń, samo konto mogło uruchomić kontrolę ryzyka platformy — podejrzane logowania lub seria zapytań o wysokiej częstotliwości mogą automatycznie wyłączyć dostęp do API. Wymaga to reaktywacji przez obsługę klienta, a nie nowego klucza.

Limity stawek API WEEX i obsługiwane pary handlowe

Limity stawek różnią się w zależności od rynku, a limity zleceń spot i futures nie są tą samą liczbą — warto to wiedzieć przed określeniem częstotliwości zleceń strategii.

Punkty końcowe niebędące zleceniami są ograniczone stawką według IP z systemem wag; składanie zleceń jest ograniczone według konta (userId) i nie zużywa wagi IP. Nagłówki odpowiedzi informują o Twoim statusie: X-USED-WEIGHT-1M i X-REMAINING-WEIGHT-1M dla wagi IP, X-ORDER-COUNT- i X-ORDER-REMAINING- dla liczby zleceń. Czytanie tych nagłówków zamiast lokalnego liczenia zapytań to to, co odróżnia bota, który wdzięcznie degraduje, od takiego, który zostaje zbanowany w trakcie pozycji.

Limit anulowania futures wynoszący 50/min jest tym, który sprawia problemy. Strategia wyceniająca obie strony na kilku parach może go wyczerpać podczas szybkiego ruchu — dokładnie wtedy, gdy anulowanie ma największe znaczenie. Budżetuj anulowania celowo i preferuj modyfikowanie lub używanie postOnly zamiast churnu typu anuluj-i-zastąp.

Nie każda para WEEX jest zbywalna przez API. API obsługuje ponad 140 par, przy czym lista futures przekracza setkę symboli, a lista spot jest znacznie krótsza — około dwóch tuzinów głównych. Sprawdź swój symbol na liście par spot i futures obsługiwanych przez API przed budowaniem wokół niego; nieobsługiwana para zwraca błąd uprawnień, który wygląda identycznie jak brakujący zakres uprawnień. Symbole są rozróżniane wielkością liter i muszą być wielkimi literami.

Dwie luki w możliwościach, które należy zaplanować: WEEX obecnie nie obsługuje integracji webhooków TradingView ani protokołu FIX. Jeśli Twój zamierzony przepływ pracy zależy od któregokolwiek z nich, jedyną drogą są API REST i WebSocket.

Co jest najważniejsze

Jeśli zapamiętasz trzy rzeczy: powiąż listę dozwolonych adresów IP, zachowaj hasło alfanumeryczne i poczekaj 15 minut, zanim stwierdzisz, że nowy klucz API WEEX jest zepsuty. Te trzy czynniki odpowiadają za zdecydowaną większość awarii w pierwszej godzinie.

Poza tym, dyscyplina, która oddziela ludzi prowadzących strategie API przez lata od ludzi, którzy bankrutują w drugim miesiącu, jest nudna i mało efektowna — jeden klucz na zadanie, tylko do odczytu dla wszystkiego, co tylko musi patrzeć, statyczny adres IP i faktycznie monitorowane nagłówki odpowiedzi. Klucz API WEEX to poświadczenie z uprawnieniami handlowymi do Twojego konta. Traktuj go z taką samą dbałością jak samo hasło do konta.

Gotowy do budowania? Utwórz swój klucz na stronie Zarządzania API i zacznij od punktów końcowych handlu papierowego.

FAQ

1. Jak utworzyć klucz API WEEX?

Zaloguj się do WEEX, przejdź do Konto → Zarządzanie API, kliknij Utwórz klucz API, przejdź weryfikację bezpieczeństwa, ustaw alfanumeryczne hasło, wybierz uprawnienia i dodaj listę dozwolonych adresów IP. APIKey, SecretKey i hasło są wyświetlane raz przy tworzeniu i muszą zostać natychmiast zapisane.

2. Dlaczego mój nowy klucz API WEEX nie działa?

Najczęściej chodzi o czas. Nowe i zmodyfikowane klucze potrzebują około 15 minut na propagację w systemach WEEX. Następnie sprawdź w kolejności: 2FA powiązane z kontem, wywołujący adres IP na liście dozwolonych, hasło bez znaków specjalnych, poprawne uprawnienia handlowe zaznaczone dla rynku, na który uderzasz, oraz zegar serwera w granicach 30 sekund od czasu serwera WEEX.

3. Czy mogę odzyskać utracone hasło API WEEX?

Nie. Hasła nie można zmodyfikować ani odzyskać. Jeśli je zgubisz, usuń klucz i utwórz nowy. SecretKey jest równie nieodzyskiwalny — jest wyświetlany tylko przy tworzeniu.

4. Ile kluczy API może mieć jedno konto WEEX?

Do 10 grup kluczy API na użytkownika, z maksymalnie 10 adresami IP na klucz, wprowadzonymi jako lista oddzielona przecinkami.

5. Czy klucz API WEEX pozwala na wypłaty?

Udokumentowane uprawnienia API WEEX obejmują Readonly, Spot i Futures. Zakres wypłat nie znajduje się wśród opcji prezentowanych przy tworzeniu klucza. Skompromitowany klucz handlowy nadal może powodować straty poprzez wrogie przepływy zleceń, więc traktuj wyciekłe poświadczenia jako sytuację awaryjną i natychmiast usuń klucz.

6. Czy potrzebuję oddzielnych kluczy API WEEX dla spot i futures?

Niekoniecznie — jeden klucz może posiadać zarówno uprawnienia Spot, jak i Futures. Jednak uprawnienia są niezależne, więc oba pola muszą być zaznaczone, a oba rynki używają różnych domen REST: api-spot.weex.com i api-contract.weex.com.

7. Czy mogę przetestować klucz API WEEX bez prawdziwych środków?

Tak. WEEX udostępnia punkty końcowe kontraktów terminowych handlu papierowego pod /capi/v3/sim/ obejmujące saldo, pozycje, składanie zleceń i historię zleceń, używając symulowanego SUSDT. Debuguj logikę strategii tam, zanim skierujesz klucz na rynki na żywo.

Ostrzeżenie o ryzyku

Aktywa kryptograficzne są zmienne, a handel sterowany przez API giełdy kryptowalut może wzmocnić zarówno szybkość, jak i wielkość strat. Pojedynczy błąd logiczny, nieobsłużona odpowiedź 429 lub wyczerpany budżet stawek anulowania może pozostawić otwarte pozycje na szybkim rynku, a straty mogą być częściowe lub całkowite.

Ryzyka specyficzne przy tworzeniu i używaniu klucza API WEEX: wyciek poświadczeń — każdy posiadający Twój SecretKey i hasło z nieograniczonego klucza może handlować Twoim saldem; awaria automatyzacji — boty nie zatrzymują się, gdy Twoje założenia zawodzą; ryzyko płynności — zlecenia API na cienkich parach mogą wypełnić się daleko od oczekiwanej ceny; ryzyko dźwigni na kontraktach terminowych, gdzie likwidacja może nastąpić, zanim Twój kod zareaguje; oraz ryzyko operacyjne wynikające ze zmian IP, dryfu zegara lub wycofanych wersji punktów końcowych, które po cichu wyłączają działającą strategię.

Nigdy nie udostępniaj swojego SecretKey ani hasła, usuń każdy klucz, który podejrzewasz o kompromitację, bez czekania na potwierdzenie, i ustalaj wielkość pozycji przy założeniu, że Twoja automatyzacja ostatecznie zawiedzie w najgorszym możliwym momencie. Nic tutaj nie jest poradą inwestycyjną.