OKX FAQ API

Opublikowano 20 wrz 2024Zaktualizowano 20 lip 202610 min czytania142

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. Jeśli je zapomnisz, nie będziesz mógł 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 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 Zastosowanie

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:

  1. Zaloguj się na swoje Konto OKX i przejdź do Profil > API.

  2. Zobaczysz listę swoich istniejących kluczy API. Kliknij na ten, którym chcesz zarządzać.

  3. Stąd możesz:

    • Wyświetl nazwę klucza API, uprawnienia oraz powiązaną białą listę adresów 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 kluczowej 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 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.

Jaki jest powód 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 być 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, gdy jest wyłączona na stronie wypłaty?

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 zostało złożone z błędem 50004, nie odzwierciedla to rzeczywistego wyniku żądania interfejsu. Żądanie może zakończyć się sukcesem lub niepowodzeniem. Proszę odnieść 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, sprawdź u dostawcy oprogramowania, 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 uzyskać klucz API typu transakcja, bez powiązania listy IP, a następnie ponownie połącz oprogramowanie firm trzecich.

Jak mogę uzyskać najnowszą cenę transakcji dla określonej pary walutowej?

Szczegóły tutaj dotyczące Symboli giełdowych, a dla symbolu giełdowego, więcej informacji tutaj. Interfejs Symboli giełdowych służy do uzyskiwania najnowszej ceny transakcji par walutowych w partiach, natomiast symbol giełdowy służy do uzyskiwania 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

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ą wsparcia API.

Jak zeskanować: w aplikacji stuknij Menu > ikonę Skanuj i zeskanuj kod QR.