API giełdy kryptowalut: co robi i co może zrobić Twój klucz

API giełdy kryptowalut to czytelna dla maszyny brama do giełdy. Zamiast klikać w wykres, Twój kod wysyła żądanie HTTP, a giełda odsyła cenę, saldo lub potwierdzenie zlecenia. To jest to, co obejmuje większość wyjaśnień. Część, którą początkujący pomijają — i która kosztuje ludzi pieniądze — to uprawnienia. Klucz API to nie hasło z jednym ustawieniem. To poświadczenie o określonym zakresie, a pola, które zaznaczasz podczas tworzenia, decydują o tym, co dokładnie ktoś mógłby z nim zrobić, gdyby wyciekł.

Ten przewodnik omawia, do czego służy API giełdy kryptowalut, w jaki sposób żądanie udowadnia, że pochodzi od Ciebie, co faktycznie pozwala każdy zakres uprawnień oraz limity stawek, które przerywają większość pierwszych integracji.

Co faktycznie robi API giełdy kryptowalut

API giełdy udostępnia dwie rodziny punktów końcowych (endpoints). Publiczne punkty końcowe nie wymagają uwierzytelnienia i zwracają dane rynkowe: ceny tickerów, świece, głębokość arkusza zleceń, czas serwera i listę zbywalnych symboli. Prywatne punkty końcowe wymagają podpisanego żądania i dotyczą Twojego konta: składanie i anulowanie zleceń, odczytywanie sald i pozycji oraz pobieranie wypełnień i rekordów księgi głównej.

Te punkty końcowe docierają przez dwa transporty, a dojrzałe systemy używają obu. REST to żądanie i odpowiedź, jedna akcja na raz: złożenie lub anulowanie zlecenia, sprawdzenie salda, pobranie historycznych świec. WebSocket to trwały strumień, używany do różnic arkusza zleceń na żywo, transakcji i powiadomień o wypełnieniu, gdzie odpytywanie byłoby zbyt wolne i zbyt kosztowne.

Praktyczne zastosowania to: boty handlowe, strategie market-making i ilościowe, trackery portfela, narzędzia podatkowe, które uzgadniają każde wypełnienie, oraz pulpity nawigacyjne, które mierzą Twój własny slippage zamiast ufać wykresowi giełdy.

Jak wywołanie API udowadnia, że to Ty

Utworzenie klucza w WEEX generuje trzy wartości, z których każda pełni inną funkcję:

• APIKey — publiczny identyfikator, który informuje giełdę, który klucz wykonuje wywołanie.
• SecretKey — sekret podpisu. Nigdy nie jest wysyłany przez sieć.
• Passphrase — fraza, którą wybierasz. Nie można jej odzyskać ani zmienić; jeśli ją zgubisz, tworzysz nowy klucz.

Każde prywatne żądanie jest podpisane. WEEX generuje nagłówek ACCESS-SIGN poprzez uruchomienie HMAC SHA256 na timestamp + METHOD + requestPath + "?" + queryString + body, a następnie zakodowanie wyniku w Base64. Żądanie głębokości podpisuje ciąg znaków, taki jak 1591089508404GET/api/v3/market/depth?symbol=BTCUSDT&limit=20.

Z tego projektu wynikają dwie rzeczy: sekret nigdy nie podróżuje, więc przechwycenie żądania nie przekazuje klucza, a ponieważ znacznik czasu znajduje się wewnątrz podpisanego ciągu, przechwycone żądanie nie może zostać później odtworzone z innym ładunkiem. Pełny schemat znajduje się w dokumentacji podpisu API WEEX.

Co faktycznie pozwalają uprawnienia Read, Spot i Futures

To tutaj powinna zacząć się rozmowa o bezpieczeństwie, a nie skończyć. Zakresy w WEEX są niezależne — zaznaczenie jednego nie oznacza innego, a nowe klucze są domyślnie tylko do odczytu.

Źródło: FAQ API futures WEEX, ostatnia aktualizacja 14-04-2026, oraz przewodnik przygotowania klucza API WEEX, oba sprawdzone 28 lipca 2026.

Zwróć uwagę na to, czego brakuje w tej tabeli: zakresu wypłat. Udokumentowane uprawnienia klucza API WEEX obejmują tylko odczyt i handel, więc sam klucz nie jest drogą do wyprowadzania monet z konta. Niektóre giełdy oferują klucze z włączoną wypłatą — jeśli używasz takiego, jest to ustawienie o najwyższym ryzyku w całym Twoim stosie i prawie nigdy nie powinno być włączone dla bota.

Czy handel przez API giełdy kryptowalut jest bezpieczny?

Rozsądnie, jeśli traktujesz klucz jako aktywną poświadczenie, a nie ciąg konfiguracyjny. API nie jest słabym punktem; słabym punktem jest obsługa kluczy. Klucze wyciekają z zatwierdzonych plików .env, zrzutów ekranu na czatach wsparcia i zewnętrznych "pulpitów handlowych", które proszą o uprawnienia do handlu, gdy wystarczyłby odczyt.

Trzy ustawienia wykonują większość pracy. Przyznaj najwęższy zakres, którego narzędzie faktycznie potrzebuje — narzędzie podatkowe nigdy nie musi handlować. Powiąż klucz z adresem IP; WEEX wyraźnie ostrzega, że klucze bez powiązania IP stanowią zagrożenie bezpieczeństwa, a klucz powiązany z IP jest prawie bezużyteczny dla kogoś, kto ukradnie go z innej sieci. Trzymaj klucze programistyczne i produkcyjne oddzielnie, aby móc usunąć jeden bez wyłączania drugiego.

Co traderzy często pomijają: klucz tylko do handlu nie może opróżnić Twojego konta poprzez wypłatę, ale nadal może je zniszczyć. Atakujący z uprawnieniami futures może otworzyć pozycję z maksymalną dźwignią na niepłynnej parze i pozwolić likwidacji dokonać zniszczeń. Zakres ogranicza promień rażenia; nie eliminuje go. Limity pozycji i dźwigni w Twoim własnym kodzie to druga linia obrony.

Tworzenie klucza API w WEEX i limity, które gryzą jako pierwsze

Klucze są tworzone w ustawieniach konta, a nie przez API. Każde konto może posiadać do 10 grup kluczy API, więc nie ma powodu, aby używać jednego w wielu projektach. Następnie przeczytaj limity przed napisaniem logiki ponawiania prób, ponieważ to one przerywają pierwszą integrację:

Źródło: Ograniczenia dostępu API futures WEEX i FAQ, ostatnia aktualizacja 14-04-2026, sprawdzone 28 lipca 2026.

Trzy kolejne pułapki warte wymienienia. Błąd -1052 (niewystarczające uprawnienia) zazwyczaj oznacza, że pole Futures nigdy nie zostało zaznaczone, a nie że Twój podpis jest błędny. Połączenie WebSocket zwraca 403, jeśli nagłówek żądania nie zawiera User-Agent. A fraza dostępu musi być alfanumeryczna — znaki specjalne spowodują niepowodzenie uwierzytelnienia w sposób, który wygląda jak błąd podpisu.

Zanim zaryzykujesz kapitał, WEEX udostępnia punkty końcowe handlu papierowego pod /capi/v3/sim/ — saldo, pozycje, składanie zleceń i historia zleceń — które pozwalają debugować przepływ zleceń bez prawdziwych środków. Używaj ich, dopóki obsługa błędów i uzgadnianie nie będą nudne.

Krótka wersja

API giełdy kryptowalut to nie funkcja dla zaawansowanych traderów; to system uprawnień z dołączonym interfejsem handlowym. Ustaw odpowiedni zakres, powiąż IP, trzymaj frazę dostępu w miejscu, w którym jej nie zgubisz, a reszta to zwykła inżynieria. Gotowy do budowania? Utwórz klucz z API WEEX, zacznij od punktów końcowych symulacji i przejdź do handlu na żywo tylko wtedy, gdy Twoje logi są czyste. Jeśli chcesz szerszego spojrzenia na to, jak stos REST i WebSocket WEEX pasują do siebie, zobacz czy WEEX obsługuje handel przez API.

FAQ

1. Do czego służy API giełdy kryptowalut?

Odczytywanie danych rynkowych i kontrolowanie konta za pomocą kodu zamiast interfejsu internetowego — zautomatyzowany handel, śledzenie portfela, uzgadnianie podatkowe i niestandardowe analizy własnych wypełnień i slippage.

2. Czy handel przez API jest legalny?

Handel programistyczny jest standardową funkcją obsługiwaną przez giełdę i jest legalny w większości jurysdykcji. Liczy się Twój lokalny status regulacyjny i warunki samej giełdy — manipulacja rynkiem jest nielegalna, niezależnie od tego, czy robisz to ręcznie, czy za pomocą skryptu.

3. Czy ktoś może wypłacić moje środki za pomocą skradzionego klucza API?

Nie w WEEX, którego udokumentowane zakresy kluczy na kwiecień 2026 obejmują tylko odczyt i handel. Na giełdach, które oferują klucze z włączoną wypłatą, skradziony klucz z takim zakresem może przesuwać środki — dlatego powinien pozostać wyłączony.

4. Dlaczego mój nowy klucz API zwraca błąd natychmiast?

Nowo utworzone lub zmodyfikowane klucze potrzebują około 15 minut na propagację. Jeśli po tym czasie nadal nie działa, sprawdź pole wyboru uprawnień przed debugowaniem podpisu.

5. Czy muszę kodować, aby używać API giełdy?

Aby zbudować strategię, tak. Aby połączyć istniejący tracker lub narzędzie podatkowe, nie — wklejasz do niego klucz tylko do odczytu. Nigdy nie dawaj takiemu narzędziu uprawnień do handlu.

Ostrzeżenie o ryzyku

Kryptowalutowe aktywa są wysoce zmienne, a handel nimi może skutkować częściową lub całkowitą utratą kapitału. Handel przez API dodaje ryzyka, których nie ma handel ręczny: błąd w kodowaniu może wysłać setki niezamierzonych zleceń, zanim zauważysz, odrzucenie z powodu limitu stawek może pozostawić pozycję bez zabezpieczenia, a wyciekły klucz z uprawnieniami do handlu może zostać użyty do otwarcia pozycji z dźwignią na Twoim koncie, nawet gdy wypłaty są niemożliwe. Handel futures wzmacnia to wszystko — dźwignia może zlikwidować pozycję przy ruchu, który posiadacz spot by przeczekał. Testuj na punktach końcowych symulacji, przyznawaj najwęższe uprawnienia, które działają, powiązuj klucze z IP i nigdy nie handluj kapitałem, na którego utratę nie możesz sobie pozwolić.