OKX FAQ API
Do czego odnosi się hasło dostępu?
To jest hasło, które wpisałeś podczas ubiegania się o klucz API. Musisz je zapamiętać samodzielnie. Po jego zapomnieniu nie można go odzyskać i będziesz musiał utworzyć nowy klucz API.
Jak utworzyć klucz API?
W aplikacji:
1. Zaloguj się na swoje Konto OKX > Wybierz Menu (⋮⋮⋮) > Przewiń w dół i wybierz klucz API > Utwórz klucz API
2. Wypełnij nazwę API > Wybierz konto oraz cel > Wprowadź listę dozwolonych adresów IP > Wybierz uprawnienia > Wprowadź parafrazę
W sieci:
1. Zaloguj się na swoje Konto OKX > Przejdź do swojego Profilu i wybierz API i połączenia > Utwórz klucz API
2. Wpisz nazwę klucza API > Wybierz konto oraz Używane do
3. Wprowadź listę dozwolonych adresów IP > Wybierz Uprawnienia > Wprowadź Parafrazę
Uwaga:
Adresy IP pomagają zabezpieczyć Twój klucz API. Możesz powiązać do 20 adresów na klucz, oddzielając je przecinkiem lub spacją.
Musisz wyświetlić informacje o API i uzyskać dostęp do jego interfejsu. Proszę, zachowaj swoje hasło w bezpiecznym miejscu. Możesz utworzyć nowe API, jeśli zgubisz hasło, ponieważ nie możemy odzyskać istniejących API.
Jak zarządzać lub edytować klucz API?
Aby zarządzać lub edytować swój klucz API na OKX:
Zaloguj się na swoje Konto OKX i przejdź do Profil > API.
Zobaczysz listę swoich istniejących kluczy API. Kliknij na ten, którym chcesz zarządzać.
Stąd możesz:
Wyświetl nazwę klucza API, uprawnienia oraz powiązaną białą listę IP.
Edytuj nazwę klucza, uprawnienia (Odczyt, Handel, wypłać) lub powiązane adresy IP.
Usuń klucz, jeśli nie jest już potrzebny.
Uwaga: Nie możesz zobaczyć frazy dostępu po jej pierwotnym utworzeniu. Jeśli ją zgubisz, będziesz musiał usunąć istniejący klucz i utworzyć nowy. Zawsze przechowuj swoje dane uwierzytelniające w bezpiecznym miejscu.
Jak rozróżnić handel spot od handlu z dźwignią, jeśli handluję za pomocą API?
Sposób rozróżniania spot i handlu z dźwignią za pomocą API może się różnić w zależności od typu i ustawień Twojego konta. Zalecamy zapoznanie się z dokumentacją API OKX, aby uzyskać najdokładniejsze i najaktualniejsze parametry dotyczące konfiguracji Twojego konta.
Jeśli potrzebujesz dalszych wyjaśnień, skontaktuj się z Asystentem OKX, aby uzyskać spersonalizowane wskazówki.
Jak utworzyć klucz API do dysku demo?
Aby dokonać transakcji na demo disk API, musisz utworzyć klucz API na demo disk. Postępuj zgodnie z poniższymi krokami:
Zaloguj się na swoje Konto OKX > handel > handel demo > Centrum osobiste > Utwórz klucz API konta demo > Rozpocznij handel demo
Czy klucz API wygaśnie?
Klucze API, które nie są powiązane z adresem IP i mają uprawnienia do transakcji lub wypłat, zostaną automatycznie usunięte po 14 dniach nieaktywności. Klucze API nie będą uznawane za nieaktywne, jeśli są używane do wywoływania prywatnych lub związanych z kontem interfejsów wymagających weryfikacji tożsamości, takich jak przeglądanie salda konta, danych rozliczeniowych lub składanie zleceń.
Tylko klucze API z dostępem tylko do odczytu powiązane z adresem IP lub określonymi uprawnieniami nie wygasną.
Czym są uprawnienia Pożyczka, zarabiaj i Transfer?
Transfer: Pozwala kluczowi na transfer środków między Twoimi kontami. Dostępne dla wszystkich kont.
Pożyczka: Umożliwia kluczowi pożyczanie, spłacanie i zarządzanie pożyczkami. Widoczne tylko, jeśli Twoje konto ma wymaganą kwalifikację do funkcji.
Zarabiaj: Umożliwia kluczowi subskrypcję i wykup produktów Zarabiaj. Widoczne tylko, jeśli Twoje konto ma wymaganą kwalifikację do funkcji.
Jeśli Twój klucz API miał wcześniej włączone uprawnienia do Handlu, wszystkie trzy uprawnienia zostaną automatycznie aktywowane po tej aktualizacji. Nie jest wymagana żadna ręczna konfiguracja.
Czy można składać zlecenia w jednostkach waluty podczas składania zleceń przez interfejs?
Nie; w przypadku zleceń kontraktowych interfejs domyślnie pokazuje zlecenia w liczbie kontraktów. Jeśli potrzebujesz obliczyć konwersję między liczbą kontraktów a monetami, możesz skorzystać z interfejsu konwersji liczby kontraktów na monety tutaj.
Jak uzyskać wskaźnik zmienności interfejsu?
Interfejs nie może bezpośrednio uzyskać wzrostu lub spadku ceny, ale można to obliczyć za pomocą wzoru.
Wzrost i spadek wartości najnowszej ceny transakcji w porównaniu do ceny otwarcia świecy K sprzed 24 godzin / 100% ceny otwarcia świecy K sprzed 24 godzin.
Powyższe dane dotyczące formuły można uzyskać poprzez interfejs rynku tutaj.
Jaka jest przyczyna komunikatu o błędzie „51000 Parameter posSide error” podczas składania zlecenia?
Najpierw musisz sprawdzić tryb konta; tryb kupna i sprzedaży/tryb otwierania i zamykania, który można zobaczyć tutaj, aby uzyskać posMode.
Uwaga:
W przypadku otwierania i zamykania pozycji oraz składania zleceń z użyciem kontraktu wymagany jest parametr posSide, w którym należy wpisać kupno lub sprzedaż.
Jeśli jest to tryb kupna i sprzedaży lub transakcja kryptowalutowa bądź z dźwignią przeprowadzana w trybie otwierania i zamykania, posSide obsługuje tylko wartość netto lub brak transmisji.
Który interfejs można użyć, aby uzyskać wartość nominalną kontraktu oraz minimalną liczbę zlecenia?
Możesz użyć interfejsu, aby uzyskać podstawowe informacje o produktach handlowych tutaj.
wartość nominalna kontraktu: ctVal, minimalna liczba zlecenia: minSz.
Jaki jest format instId?
Możesz bezpośrednio skorzystać z interfejsu, aby uzyskać podstawowe informacje o produktach handlowych tutaj.
Jak ustawić stop loss i take profit?
Jeśli zlecenie jest powiązane z take profit stop loss, możesz odnieść się do interfejsu zleceń tutaj: parametry tablicy attachAlgoOrds.
Jeśli jednak jest to osobne zlecenie stop loss, możesz odnieść się do interfejsu prowizji strategii tutaj.
Dlaczego pojawia się błąd podczas ustawiania ceny wyzwalającej dla take profit i stop loss: 51046, 51047, 51048, 51049?
Zasady ustalania ceny wyzwalającej stop-loss/ceny wyzwalającej take-profit – podczas sprzedaży cena wyzwalająca take-profit jest wyższa niż ostatnia cena transakcji, a cena wyzwalająca stop-loss jest niższa niż ostatnia cena transakcji; natomiast podczas kupna cena wyzwalająca take-profit jest niższa niż ostatnia cena transakcji, a cena wyzwalająca stop-loss jest wyższa niż ostatnia cena transakcji.
Co oznacza "Błąd interfejsu: 50102 Żądanie znacznika czasu wygasło"?
Ten błąd występuje, gdy znacznik czasu wygasł. Należy wywołać interfejs czasu systemowego, aby zsynchronizować lokalny czas z czasem naszego serwera. Utrzymanie różnicy czasu w granicach 30 sekund może pomóc uniknąć tego problemu.
Uwaga: czas w nagłówku żądania jest podany w UTC0. Podczas wywoływania interfejsu czasu serwera czas jest podawany w UTC + 8.
Co oznacza "Błąd interfejsu: 50101 APIKey nie pasuje do bieżącego środowiska"?
Jest to spowodowane niezgodnością między kluczem API a aktualnym środowiskiem. Wywołania konta rzeczywistego wymagają użycia klucza API konta rzeczywistego, a wartość parametru x-simulated-trading w nagłówku żądania musi wynosić 0. Wywołania konta symulowanego wymagają użycia klucza API konta symulowanego, a wartość parametru x-simulated-trading w nagłówku żądania musi wynosić 1.
Co oznacza „Błąd interfejsu: 51010 Żądanie nieobsługiwane w obecnym trybie konta"?
To dotyczy twojego trybu konta. Jeśli chcesz ustawić dźwignię lub kontrakt na pojedynczą walutę, musisz przełączyć się na jeden z trzech pozostałych trybów, z wyjątkiem trybu spot! Możesz to ustawić w ustawieniach interfejsu tutaj, albo na stronie internetowej lub w aplikacji.
Uwaga: pierwsze ustawienie musi zostać skonfigurowane na stronie lub w aplikacji; opcja ustawień w głównym menu strony handlu - tryb konta.
Co oznacza "Błąd interfejsu: 51121 Liczba zlecenia musi być wielokrotnością rozmiaru partii"?
W API zlecenia kontraktowe są wyrażone w jednostkach kontraktów i muszą być wielokrotnością minimalnej liczby zlecenia dla pary walutowej. Minimalną liczbę zlecenia można uzyskać poprzez pole minSz w interfejsie produktu tutaj.
„Błąd wypłaty: 58207 Adres wypłaty nie znajduje się na liście dozwolonych dla zwolnienia z weryfikacji”; dlaczego weryfikacja na liście dozwolonych nadal zgłasza błąd, skoro na stronie wypłaty jest wyłączona?
Aby wypłacić monety za pomocą interfejsu API, należy dodać adres wypłaty na stronie i zaznaczyć przycisk „niezweryfikowany przez Visa”. To, czy weryfikacja na liście dozwolonych jest wyłączona na stronie, nie wpłynie na działanie interfejsu.
Co oznacza „Błąd interfejsu: 50004 przekroczenie czasu oczekiwania na odpowiedź punktu końcowego API” (nie oznacza to, że żądanie zakończyło się sukcesem lub niepowodzeniem, prosimy o sprawdzenie wyniku żądania)?
Błąd 50004 jest zwykle spowodowany nadmiernym obciążeniem serwera. Godziny 8, 16 i 24 to momenty zbierania opłat kapitałowych każdego dnia. W tym czasie obciążenie serwera jest wysokie. Zaleca się rozłożenie transakcji na różne godziny. Jeśli błąd 50004 pojawi się w innych godzinach, można spróbować ponownie później. Jeśli zlecenie zostanie złożone z błędem 50004, nie odzwierciedla to rzeczywistego wyniku żądania interfejsu. Żądanie może zakończyć się sukcesem lub niepowodzeniem. Prosimy o odniesienie się do rzeczywistego wyniku.
Co oznacza błąd „50119 API key doesn’t exist”?
Ten błąd zwykle występuje, gdy domena Twojego konta nie odpowiada Twojemu regionowi.
Dla użytkowników EEA prosimy o zmianę nazwy domeny w żądaniu API na eea.okx.com zamiast www.okx.com.
Dla użytkowników z USA prosimy o zmianę nazwy domeny w żądaniu API na us.okx.com zamiast www.okx.com.
Jeśli korzystasz z oprogramowania firm trzecich do łączenia się z OKX i widzisz ten błąd, skontaktuj się z dostawcą oprogramowania, aby sprawdzić, czy obsługuje domeny regionalne. Na przykład użytkownicy z EOG muszą łączyć się przez eea.okx.com, w przeciwnym razie żądanie zakończy się niepowodzeniem.
Dlaczego pojawia się błąd „50110” podczas łączenia z oprogramowaniem firm trzecich?
Ten błąd może wystąpić, jeśli obecny typ klucza API nie jest kompatybilny z powiązaniem oprogramowania firm trzecich. Spróbuj złożyć wniosek o klucz API typu transakcja, bez powiązywania listy adresów IP, a następnie ponownie połącz oprogramowanie firm trzecich.
Jak mogę uzyskać najnowszą cenę transakcji dla określonej pary walutowej?
Szczegóły tutaj dla Symboli giełdowych oraz dla Symbolu giełdowego, więcej tutaj. Interfejs Symboli giełdowych służy do uzyskania najnowszej ceny transakcji par walutowych w partiach, a Symbol giełdowy służy do uzyskania najnowszej ceny transakcji pojedynczych par walutowych.
Przykład parametru odpowiedzi ceny ostatniej transakcji w sekcji Tickers
Jakie są wymagania, aby utworzyć klucz API?
Do utworzenia klucza API wymagane jest minimalne saldo aktywów pod zarządzaniem (AUM) w wysokości 100 USD.
Wymagany jest AUM większy niż 100 USD (AUM > 100U), aby utworzyć klucz API
Dla kont głównych lub subkont, tylko konta z AUM > 100U mogą tworzyć klucze API
Uwaga: Ten wymóg dotyczy tylko użytkowników z niektórych obszarów
Co powinienem zrobić, jeśli WebSocket nie może się połączyć lub ciągle się rozłącza?
Potwierdź, że używasz poprawnego adresu URL WebSocket dla swojej strony i usługi API. Sprawdź swoją sieć, ustawienia proxy, TLS, parametry subskrypcji, mechanizm Ping/Pong oraz logikę ponownego łączenia. Jeśli problem będzie się utrzymywał, podaj kanał, czas wystąpienia, pełną treść komunikatu o błędzie oraz zanonimizowane logi.
Jak rozwiązywać problemy z kodem błędu API lub nieprawidłowym parametrem żądania?
Sprawdź kod błędu w oficjalnej dokumentacji API dla Twojej strony, a następnie weryfikuj punkt końcowy, metodę HTTP, parametry żądania, tryb konta oraz ograniczenia produktu. Jeśli przyczyna nadal nie jest jasna, podaj pełny kod błędu, sCode/sMsg, czas wystąpienia oraz zanonimizowane żądanie i odpowiedź.
Dlaczego moje zlecenie API nie zostało złożone, zmienione lub anulowane?
Proszę użyć komunikatu o błędzie i kodu błędu zwróconych przez API, aby określić konkretną przyczynę. Jeśli nie jesteś pewien, co oznacza błąd, prosimy o podanie pełnych parametrów żądania oraz szczegółów błędu, abyśmy mogli przeprowadzić dalsze dochodzenie.
Co powinienem zrobić, jeśli dane rynkowe, świece lub dane z księgi zleceń wyglądają na nieprawidłowe?
Potwierdź nazwę kanału, instId, parametry subskrypcji oraz częstotliwość żądań, a także rozróżnij dane migawki od aktualizacji przyrostowych. W przypadku ksiąg zleceń zweryfikuj również identyfikatory sekwencji i znaczniki czasu. Jeśli dane wydają się być niekompletne, zanotuj kanał, zakres czasowy oraz zredagowaną surową odpowiedź.
Dlaczego salda API, pozycje lub wartości depozytu zabezpieczającego różnią się od tych na stronie internetowej lub w aplikacji?
Najpierw rozróżnij konto handlowe i konto finansowania, następnie zweryfikuj tryb konta, wymiar waluty, punkt końcowy oraz czas aktualizacji danych. W przypadku obliczeń salda, pozycji i depozytu zabezpieczającego korzystaj z najnowszej dokumentacji produktu i API dla odpowiedniej witryny.
Co powinienem zrobić, jeśli wpłata, wypłata lub transfer przez API się nie powiedzie?
Sprawdź uprawnienia API, walutę, sieć, docelowe konto oraz wszelkie wymagania dotyczące książki adresowej lub białej listy, a następnie rozwiąż problem, korzystając z zwróconego kodu błędu. Ograniczenia dotyczące bezpieczeństwa konta, zgodności lub ryzyka mogą wymagać dalszej weryfikacji przez wsparcie dla odpowiedniej witryny.
Jak utworzyć i używać klucz API dla subkonta?
Utwórz klucz API w ramach zamierzonego subkonta i używaj uprawnień, hasła oraz domeny witryny tego subkonta. Nie mieszaj klucza API, sekretu ani hasła konta nadrzędnego z tymi subkonta.
Co powinienem zrobić po przekroczeniu limitu szybkości API?
Zmniejsz częstotliwość żądań zgodnie z limitem dla konkretnego punktu końcowego i stosuj kolejki żądań, wykładnicze opóźnienia lub punkty końcowe wsadowe tam, gdzie to odpowiednie. Zakres limitu i przydział mogą się różnić w zależności od punktu końcowego, więc nie zakładaj, że wszystkie punkty końcowe mają ten sam limit.
Gdzie mogę znaleźć dokumentację API, SDK i przykłady kodu?
Dokumentacja API (V5) — www.okx.com/docs-v5/en. Referencje REST i WebSocket, dziennik zmian, kody błędów, przykłady żądań/odpowiedzi dla każdego punktu końcowego. Oficjalne SDK (GitHub) — github.com/okxapi Przykład kodu można znaleźć w SDK.
Jakie informacje powinienem podać, jeśli mogę tylko powiedzieć „API nie działa”?
Podaj punkt końcowy, metodę HTTP, zamierzoną operację, pełny kod błędu lub komunikat, czas wystąpienia, witrynę konta, środowisko sieciowe oraz zanonimizowane żądanie i odpowiedź. Nigdy nie wysyłaj API Secret, Passphrase, kodu weryfikacyjnego ani niezanonimizowanego podpisu.
Uwaga:
Jeśli masz pytania dotyczące WebSocket lub innych tematów związanych z API, kliknij link do artykułu i zeskanuj kod QR na dole artykułu za pomocą aplikacji OKX, aby dołączyć do grupy i skontaktować się z naszym specjalistą ds. wsparcia API.
Jak zeskanować: w aplikacji stuknij Menu > ikonę Skanuj i zeskanuj Kod QR.