Jak zostać brokerem WEEX: zgłoszenie, konfiguracja API i uruchomienie

Aby zostać brokerem WEEX, prześlij formularz rejestracyjny dostępny na stronie WEEX dla brokerów, przejdź weryfikację due diligence i otrzymaj identyfikator brokera w formacie WEEX plus sześć cyfr. Potem zaczyna się praca techniczna: połącz użytkowników za pomocą OAuth lub ich własnych kluczy API, dodawaj identyfikator brokera na początku każdego zlecenia i rozliczaj prowizje za pomocą endpointów rabatowych. WEEX podaje, że zatwierdzenie trwa jeden dzień roboczy, a uruchomienie od czterech do pięciu dni roboczych. Poniższe sekcje przedstawiają kolejne etapy, wymieniają potrzebne materiały i omawiają kwestie bezpieczeństwa związane z przechowywaniem kluczy innych osób. Informacje aktualne na 7 października 2026 r.

Kto może złożyć wniosek i czego wymaga WEEX

O brokerstwo mogą ubiegać się osoby fizyczne, zespoły i firmy; wpłata depozytu nie jest wymagana. W FAQ na stronie WEEX Broker jako mile widzianych kandydatów wymieniono zespoły quant, instytucje finansowe i społecznościowych KOL-ów, a sam proces weryfikacji opisano jako standardowe due diligence.

Formularz to prosta część procesu. Późniejsza rejestracja OAuth wymaga więcej informacji, a ich wcześniejsze przygotowanie pozwoli zaoszczędzić kilka dni:

• Nazwa platformy w języku angielskim
• WEEX UID, który zostanie powiązany z tożsamością brokera
• Adresy URL polityki prywatności i regulaminu
• Logo platformy
• Osoba do kontaktu i adres e-mail
• Jeden lub więcej adresów URL callbacków
• Publiczne adresy IP, z których serwery wysyłają żądania

Dwie kwestie często zaskakują zespoły. Przed złożeniem wniosku trzeba mieć konto WEEX, ponieważ UID jest częścią rejestracji. Polityka prywatności i regulamin muszą być również dostępne na działających stronach.

Harmonogram zgłoszenia do WEEX Broker: od formularza do identyfikatora brokera

1. Prześlij formularz. Otwiera go przycisk „Złóż wniosek teraz” na stronie dla brokerów.
2. Poczekaj na weryfikację. Strona dla brokerów obiecuje kontakt w ciągu 24 godzin i „zatwierdzenie w 1 dzień roboczy”. We wprowadzeniu do API Broker podano, że zespół ds. rozwoju biznesu rozpatruje wnioski w ciągu trzech dni roboczych. Zaplanuj więc dłuższy termin.
3. Odbierz e-mail z zatwierdzeniem. Znajdziesz w nim identyfikator brokera, np. WEEX123456, początkową konfigurację stawki prowizji oraz dostęp do grupy wsparcia technicznego.
4. Uzyskaj dane uwierzytelniające OAuth. Po zarejestrowaniu przez WEEX adresów URL callbacków i adresów IP otrzymasz clientId i klucz secret.
5. Przeprowadź integrację i uruchom platformę. Ogłoszenie WEEX z 07.2026 przewiduje integrację techniczną od drugiego do czwartego dnia oraz uruchomienie piątego dnia.

W praktyce o harmonogramie decyduje nie tyle weryfikacja WEEX, ile tempo, w jakim Twoja strona dostarczy stabilne adresy URL callbacków i stałe wychodzące adresy IP.

Łączenie użytkowników: przepływ OAuth WEEX w siedmiu krokach

OAuth pozwala użytkownikowi autoryzować Twoją platformę na stronie WEEX i przekazuje gotowy klucz API do Twojego backendu. Przewodnik integracji OAuth opisuje ten proces następująco.

1. W backendzie wygeneruj jednorazową wartość state o długości od 22 do 128 znaków oraz wartość PKCE code_verifier o długości co najmniej 43. Oblicz challenge jako Base64URL(SHA256(code_verifier)). Akceptowana jest wyłącznie metoda S256.
2. Przekieruj użytkownika na https://www.weex.com/pl/oauth, przekazując clientId, responseType=code, scope=create:apikey, wartość state, swój redirectUri oraz code challenge.
3. Użytkownik zapoznaje się z prośbą i zatwierdza ją w WEEX.
4. WEEX przekierowuje użytkownika na Twój callback z wartościami code i state. Sprawdź, czy state zgadza się z wydaną przez Ciebie wartością.
5. Z backendu wyślij żądanie POST na https://gateway.weex.com/v1/oauth/token, przekazując code, redirectUri i code verifier. Żądanie zawiera nagłówki Client-Id, Sign, Timestamp i Nonce. Sign to zakodowany w Base64 skrót HMAC-SHA256 z wartości timestamp, nonce, method, path i body, utworzony przy użyciu Twojego client secret jako klucza.
6. Otrzymaj token dostępu ważny przez 3,600 sekund oraz token odświeżania ważny przez 36,000 sekund. Odświeżenie unieważnia poprzedni token dostępu.
7. Wyślij żądanie POST na https://gateway.weex.com/v1/oauth/resource/create-api z tokenem bearer. Odpowiedź zawiera apiKey, secret i passphrase użytkownika, a wartości te są zwracane tylko raz.

Projekt przepływu wyznaczają trzy ograniczenia. Użytkownik może mieć tylko jeden klucz API powiązany z daną platformą zewnętrzną; kolejna próba zwróci błąd 81001 „api key already bound”. Żądania z niezarejestrowanych adresów IP są blokowane. Jeśli status API użytkownika nie jest normalny, nowy klucz może nie działać od razu, dlatego interfejs powinien uwzględniać stan oczekiwania.

OAuth jest opcjonalny. Platforma może przyjmować klucze utworzone przez użytkowników i wklejane przez nich samodzielnie. Opisane niżej tagowanie zleceń jest wymagane w obu wariantach.

Tagowanie zleceń i sprawdzanie uprawnień do prowizji

Każde zlecenie musi mieć identyfikator brokera na początku client order ID: newClientOrderId musi zaczynać się od b-{brokerId}, na przykład b-WEEX123456-20260319001. Zasada dotyczy rynku spot i kontraktów futures.

Łatwo przeoczyć dwie kwestie. W endpoincie zleceń spot client order ID jest opcjonalny, a jeśli go nie podasz, WEEX przypisze go samodzielnie. Tak wysłane zlecenie nie będzie miało prefiksu brokera, dlatego dodawaj to pole do każdego żądania. Ponadto limity długości są sprzeczne: we wprowadzeniu do programu brokerskiego dopuszczono 64 znaki, natomiast endpoint zleceń futures określa zakres od 1 do 36. Prefiks b-WEEX123456- zajmuje 13 znaków. Zaprojektowanie pozostałej części ID tak, aby mieściła się w pozostałych 23 znakach, spełnia oba limity.

Następnie skorzystaj z trzech endpointów w API rabatów brokerskich:

• Uprawnienia. GET /api/v3/apiReferral/checkUserEligibility przyjmuje WEEX UID i zwraca informację, czy użytkownik jest uprawniony, powód oraz informację, czy konto jest już powiązane z innym kodem polecającym. Wywołaj endpoint, gdy użytkownik łączy konto, zapisz wynik i nie uwzględniaj nieuprawnionych użytkowników w prognozach prowizji.
• Stawki. GET /api/v3/apiReferral/rebateRatio zwraca Twój poziom (BRONZE, SILVER lub GOLD) oraz sześć wskaźników: dla rynku spot i futures, bezpośrednich osób zaproszonych, użytkowników bez kodu polecającego oraz poleceń z programu „Zaproś znajomych”.
• Rejestry. GET /api/v3/apiReferral/rebate/recentRecord zwraca rejestry prowizji według symbolu i monety prowizji, domyślnie dla SPOT lub dla FUTURES. Maksymalny zakres zapytania wynosi 90 dni, a maksymalny rozmiar strony to 100.

Rejestry są zwracane według symbolu i okresu rozliczeniowego. Zawierają pola dotyczące wolumenu obrotu, opłaty, potrącenia opłaty, stawki rabatu i prowizji. Nie zawierają identyfikatora użytkownika ani zlecenia. Aby podzielić prowizję na użytkowników, na przykład przy dzieleniu się przychodami z autorami strategii, prowadź własny rejestr zleceń oparty na client order ID. Strona dla brokerów podaje, że rozliczenie prowizji odbywa się codziennie.

Bezpieczeństwo kluczy API dla brokerów: przechowywanie kluczy innych osób

Gdy konto połączy pierwszy użytkownik, w Twojej bazie danych znajdą się dane uwierzytelniające umożliwiające handel prawdziwymi środkami. Dokumentacja WEEX wyznacza minimalny poziom zabezpieczeń, ale odpowiedzialny broker powinien pójść dalej.

• Przechowuj dane secret w backendzie. Zgodnie z przewodnikiem OAuth client secret, code verifier oraz secret key i passphrase każdego użytkownika nigdy nie mogą pojawić się w kodzie frontendu. FAQ dla brokerów dodaje, że kluczy, wartości secret i passphrase nie wolno przekazywać w parametrach URL. Po callbacku przekieruj użytkownika na czystą stronę, a frontendowi pozwól pobrać status.
• Szyfruj zapisane klucze i maskuj je w logach. Log debugowania zawierający pełną wartość secret to najczęstsza przyczyna wycieku kluczy z systemów, które poza tym są dobrze zabezpieczone.
• Ustal stałe wychodzące adresy IP. WEEX blokuje żądania z niezarejestrowanych adresów. Zmiana regionu chmury lub dodanie proxy bez aktualizacji rejestracji może jednocześnie odciąć wszystkich użytkowników.
• Przygotuj się na jednorazowe zwrócenie danych. Jeśli zapis w pamięci masowej nie powiedzie się po pomyślnym wywołaniu create-api, secret przepada, a użytkownik musi usunąć klucz i ponownie połączyć konto. Zadbaj, aby ten krok był transakcyjny.
• Przyznawaj tylko niezbędne uprawnienia. W przypadku subkonta każdy klucz z uprawnieniami wykraczającymi poza sam odczyt wymaga listy dozwolonych adresów IP, zawierającej maksymalnie 10 pozycji. Proś o TRANSFER lub WITHDRAW tylko wtedy, gdy produkt umożliwia przesyłanie środków.
• Przestrzegaj limitów. Żądania REST współdzielą limit 500 jednostek wagi na 10 sekund. W przypadku HTTP 429 stopniowo zmniejszaj częstotliwość żądań i ustaw alerty dla serii nieudanych autoryzacji, które mogą sygnalizować testowanie wykradzionych danych uwierzytelniających.

Lista kontrolna przed uruchomieniem dla pierwszego prawdziwego użytkownika

• Przetestuj cały przepływ na koncie testowym: połącz konto, sprawdź, czy wynik weryfikacji uprawnień to true, zrealizuj oznaczone zlecenie i upewnij się, że po kolejnym rozliczeniu transakcja pojawi się w rejestrze prowizji.
• Sprawdź swój poziom i wskaźniki w endpoincie stawek, zamiast zakładać, że obowiązuje stawka z nagłówka oferty.
• Przetestuj format client order ID zarówno dla rynku spot, jak i futures.
• Ponownie użyj starej wartości state i wykorzystanego kodu autoryzacyjnego. Obie próby powinny zakończyć się niepowodzeniem.
• Wyślij żądanie z niezarejestrowanego adresu IP. Powinno zostać zablokowane.
• Skorzystaj z demonstracyjnych endpointów w ścieżce /sim/, opisanych w FAQ WEEX dotyczącym API futures, aby przetestować logikę zleceń bez używania prawdziwych środków.
• Przygotuj instrukcję obsługi zgłoszeń. Dokumentacja WEEX podaje adres support@weex.com i społeczność na Telegramie, a po zatwierdzeniu wniosku otrzymasz dostęp do grupy wsparcia technicznego.

Uzyskanie statusu brokera WEEX wymaga wypełnienia formularza i krótkiej weryfikacji. Żeby prawidłowo otrzymywać prowizje, trzeba starannie tagować zlecenia, sprawdzać uprawnienia każdego użytkownika i codziennie uzgadniać rozliczenia. Wniosek można złożyć na stronie WEEX Broker.

FAQ

1. Ile trwa zatwierdzenie wniosku WEEX Broker?

Strona dla brokerów WEEX obiecuje kontakt w ciągu 24 godzin i zatwierdzenie w jeden dzień roboczy. Dokumentacja API podaje, że zespół ds. rozwoju biznesu rozpatruje wnioski w ciągu trzech dni roboczych. Zgodnie z ogłoszeniem WEEX z 07.2026 integracja techniczna zajmuje następnie około czterech do pięciu dni roboczych.

2. Czy zostanie brokerem WEEX wiąże się z jakimiś kosztami?

Nie. Strona dla brokerów informuje, że depozyt nie jest wymagany, a rozpoczęcie współpracy nic nie kosztuje. Kandydaci przechodzą standardową weryfikację due diligence, a zatwierdzeni brokerzy otrzymują bezpłatny dostęp do panelu brokerskiego i pulpitu danych.

3. Jak wygląda identyfikator brokera WEEX?

To słowo WEEX, po którym następuje sześć cyfr, na przykład WEEX123456. Identyfikator otrzymasz w e-mailu z zatwierdzeniem. Identyfikator zlecenia client order ID każdego zlecenia wysyłanego przez platformę musi zaczynać się od b-, po którym podaje się ten identyfikator.

4. Czy platforma może zintegrować się z WEEX Broker bez OAuth?

Tak. Użytkownicy mogą utworzyć klucze API na WEEX i ręcznie wprowadzić je na platformie. OAuth eliminuje ten ręczny krok, a tagowanie zleceń i endpointy prowizyjne działają tak samo w obu wariantach.