OKX API časté dotazy

Co znamená pojem Passphrase?

Toto je heslo, které jste zadali při žádosti o klíč API. Musíte si ho zapamatovat sami. Jakmile ho zapomenete, nelze ho obnovit a budete muset vytvořit nový klíč API.

Jak vytvořím klíč API?

V aplikaci:

1. Přihlaste se ke svému Účtu OKX > Vyberte Nabídku (⋮⋮⋮) > Přejděte dolů a vyberte klíč API > Vytvořit klíč API

2. Vyplňte název API > Vyberte účet a účel > Zadejte seznam povolených IP adres > Vyberte oprávnění > Zadejte parafrázi

Na webu:

1. Přihlaste se ke svému Účtu OKX > Přejděte do svého Profilu a vyberte API a připojení > Vytvořit klíč API

2. Vyplňte název klíče API > Vyberte účet a Použito pro

3. Zadejte seznam povolených IP adres > Vyberte Oprávnění > Zadejte Parafrázi

Poznámka:

• IP adresy pomáhají zabezpečit váš klíč API. Ke každému klíči můžete připojit až 20 adres, oddělených čárkou nebo mezerou.

• Pro zobrazení informací o API a přístup k jeho rozhraní je nutné. Prosím, uchovávejte své heslo v bezpečí. Pokud heslo ztratíte, můžete vytvořit nové API, protože nemůžeme obnovit stávající API.

Jak spravovat nebo upravit klíč API?

Chcete-li spravovat nebo upravit svůj klíč API na OKX:

1. Přihlaste se ke svému Účtu OKX a přejděte do Profil > API.

2. Uvidíte seznam svých stávajících API klíčů. Klikněte na ten, který chcete spravovat.

3. Odtud můžete:

   • Zobrazit název klíče API, oprávnění a připojený seznam povolených IP adres.

   • Upravit název klíče, oprávnění (Číst, Obchodovat, Vybrat) nebo vázané IP adresy.

   • Smažte klíč, pokud již není potřeba.

Poznámka: Po počátečním vytvoření nelze zobrazit přístupovou frázi. Pokud ji ztratíte, budete muset smazat stávající klíč a vytvořit nový. Vždy uchovávejte své přihlašovací údaje bezpečně.

Jak rozliším mezi spot a maržovým obchodováním, pokud obchoduji pomocí API?

Způsob, jakým jsou spot a maržové obchodování rozlišovány prostřednictvím API, se může lišit v závislosti na typu vašeho účtu a nastavení. Doporučujeme odkázat se na dokumentaci OKX API pro nejpřesnější a nejaktuálnější parametry platné pro nastavení vašeho účtu.

Pokud potřebujete další objasnění, obraťte se na OKX Assistant pro osobní pomoc.

Jak vytvořím demo klíč API pro disk?

Chcete-li obchodovat na demo disku API, musíte si na demo disku vytvořit klíč API. Postupujte podle níže uvedených kroků:

Přihlaste se do svého Účtu OKX > obchodování > obchodování na demo účtu > Osobní centrum > Vytvořit klíč API demo účtu > Začít obchodovat na demo účtu

Vyprší platnost klíče API?

API klíče, které nejsou vázány na IP a mají oprávnění k transakcím nebo výběrům, budou automaticky smazány po 14 dnech nečinnosti. API klíče nebudou považovány za neaktivní, pokud jsou používány k volání soukromých nebo s účtem souvisejících rozhraní, která vyžadují ověření totožnosti, například pro zobrazení zůstatku na účtu, fakturačních údajů nebo zadávání objednávek.

Pouze API klíče s oprávněním pouze pro čtení, které jsou vázány na IP adresu nebo konkrétní oprávnění, nevyprší.

Co jsou oprávnění Loan, Earn a Transfer?

• Převod: Umožňuje klíči převést (finanční) prostředky mezi vašimi účty. Dostupné pro všechny účty.

• Loan: Umožňuje klíči vypůjčit si, splatit a spravovat Loan. Zobrazí se pouze, pokud má váš účet požadovanou způsobilost funkce.

• Vydělat: Umožňuje klíči přihlásit se k odběru a vybrat produkty Vydělat. Viditelné pouze pokud má váš účet požadovanou způsobilost funkce.

Pokud měl váš API klíč dříve povolení k Obchodování, budou po této aktualizaci automaticky aktivována všechna tři povolení. Ruční nastavení není potřeba.

Lze při zadávání objednávek přes rozhraní zadávat objednávky v jednotkách měny?

Ne; u objednávek na kontrakty je rozhraní ve výchozím nastavení nastaveno na počet kontraktů. Pokud potřebujete vypočítat převod mezi počtem kontraktů a coiny, můžete se podívat na rozhraní pro převod počtu kontraktů na coiny zde.

Jak získat míru kolísání rozhraní?

Rozhraní nemůže přímo získat zvýšení nebo snížení ceny, ale lze je vypočítat pomocí výpočtového vzorce.

Nárůst a pokles hodnoty poslední ceny transakce ve srovnání s otevírací cenou K-linie před 24 hodinami / 100 % otevírací ceny K-linie před 24 hodinami.

Výše uvedená data vzorce lze získat prostřednictvím tržního rozhraní zde.

Jaký je důvod chybové zprávy „51000 Parameter posSide error“ při zadávání objednávky?

Nejprve je třeba zkontrolovat režim účtu; režim nákupu a prodeje/režim otevírání a zavírání, který lze zobrazit zde pro získání posMode.

Poznámka:

• V případě otevírání a uzavírání pozic a zadávání objednávek pomocí kontraktu je vyžadován parametr posSide, do kterého se vyplní long nebo short.

• Pokud se jedná o režim nákupu a prodeje, nebo je kryptoměna či páková transakce prováděna v režimu otevírání a zavírání, posSide podporuje pouze čistý stav nebo žádný přenos.

Které rozhraní lze použít k získání nominální hodnoty kontraktu a minimálního množství objednávky?

Můžete použít rozhraní k získání základních informací o obchodních produktech zde.

nominální hodnota kontraktu: ctVal, minimální množství objednávky: minSz.

Jaký je formát instId?

Můžete přímo použít rozhraní k získání základních informací o obchodních produktech zde.

Jak nastavit stop loss a take profit?

Pokud je objednávka připojena k take profit stop loss, můžete se odkázat na rozhraní objednávek zde: parametry pole attachAlgoOrds.

Pokud se však jedná o samostatný stop loss, můžete se podívat na rozhraní provize strategie zde.

Proč se při nastavování spouštěcí ceny pro take profit a stop loss zobrazují chyby: 51046, 51047, 51048, 51049?

Pravidla pro nastavení spouštěcí ceny stop-loss/spouštěcí ceny take-profit – při prodeji je spouštěcí cena take-profit vyšší než poslední cena transakce a spouštěcí cena stop-loss je nižší než poslední cena transakce; při nákupu je spouštěcí cena take-profit nižší než poslední cena transakce a spouštěcí cena stop-loss je vyšší než poslední cena transakce.

Co znamená „Chyba rozhraní: 50102 Žádost o časové razítko vypršela“?

Tato chyba nastane, když časová značka vypršela. Zde je potřeba zavolat rozhraní systémového času, aby se váš místní čas synchronizoval s časem našeho serveru. Udržení časového rozdílu do 30 sekund může pomoci předejít tomuto problému.

Poznámka: čas v hlavičce požadavku je v UTC0. Při volání rozhraní serverového času je čas poskytován v UTC + 8.

Co znamená „Chyba rozhraní: 50101 APIKey neodpovídá aktuálnímu prostředí“?

Toto je způsobeno nesouladem mezi klíčem API a aktuálním prostředím. Volání reálného účtu vyžaduje použití klíče API reálného účtu a hodnota parametru x-simulated-trading v hlavičce požadavku musí být 0. Volání simulovaného účtu vyžaduje použití klíče API simulovaného účtu a hodnota parametru x-simulated-trading v hlavičce požadavku musí být 1.

Co znamená „Chyba rozhraní: 51010 Požadavek není podporován v aktuálním režimu účtu“?

Toto souvisí s vaším režimem účtu. Pokud chcete zadat finanční páku nebo kontrakt v jedné měně, musíte přepnout do jednoho ze tří režimů kromě režimu spotu! Nastavit to můžete v nastavení rozhraní zde, nebo to můžete nastavit na webu či v aplikaci.

Poznámka: první nastavení musí být provedeno na stránce nebo v aplikaci; možnost nastavení v hlavním menu obchodní stránky - režim účtu.

Co znamená „Chyba rozhraní: 51121 Množství objednávky musí být násobkem velikosti lotu“?

V API jsou objednávky na kontrakty v jednotkách listů a musí být násobkem minimálního množství objednávky daného páru měn. Minimální množství objednávky lze získat prostřednictvím pole minSz v rozhraní produktu zde.

„Chyba výběru: 58207 Adresa pro výběr není na seznamu povolených pro výjimku z ověření“; proč se stále zobrazuje chyba ověření seznamu povolených, když je na stránce výběru vypnutý?

Pro vybrání coinů pomocí API rozhraní je nutné na stránce přidat adresu pro výběr a zaškrtnout tlačítko „neověřeno Visa“. To, zda je na stránce vypnuto ověření seznamu povolených, nebude mít vliv na funkci rozhraní.

Co znamená „Chyba rozhraní: 50004 Časový limit požadavku na API koncový bod“ (neznamená to, že požadavek byl úspěšný nebo neúspěšný, zkontrolujte prosím výsledek požadavku)?

Chyba 50004 je obvykle způsobena nadměrným zatížením serveru. Časy 8, 16 a 24 hodin jsou body pro denní vybírání poplatků za kapitál. V těchto časech je zatížení serveru vysoké. Doporučuje se rozložit transakce mimo tyto časy. Pokud se chyba 50004 objeví v jiných časech, lze ji zkusit později znovu. Pokud je objednávka zadána s chybou 50004, neznamená to skutečný výsledek požadavku rozhraní. Požadavek může být úspěšný nebo neúspěšný. Prosím, řiďte se skutečným výsledkem.

Co znamená chyba „50119 API key doesn’t exist“?

Tato chyba obvykle nastává, když doména vašeho účtu neodpovídá vaší oblasti.

• Pro uživatele z EHP změňte prosím název domény ve vašem API požadavku na eea.okx.com místo www.okx.com.

• Pro uživatele z USA změňte prosím název domény ve vaší API žádosti na us.okx.com místo www.okx.com.

• Pokud používáte software třetí strany pro připojení k OKX a zobrazí se vám tato chyba, zkontrolujte u poskytovatele softwaru, zda podporuje regionální domény. Například uživatelé z EHP se musí připojovat přes eea.okx.com, jinak požadavek selže.

Proč se při propojení s softwarem třetí strany zobrazuje chyba „50110“?

Tato chyba může nastat, pokud aktuální typ klíče API není kompatibilní s propojením třetí strany. Zkuste požádat o typ transakce klíče API bez vázání na seznam IP adres a poté znovu připojit software třetí strany.

Jak získám nejnovější cenu transakce určitého měnového páru?

Použijte podrobnosti zde pro tickery a pro ticker zde. Rozhraní tickery slouží k získání nejnovější ceny transakce měnových párů hromadně, zatímco ticker slouží k získání nejnovější ceny transakce jednotlivých měnových párů.

Příklad parametru odpovědi poslední obchodované ceny v sekci Ticker

Jaké jsou požadavky pro vytvoření klíče API?

Pro vytvoření klíče API je vyžadován minimální zůstatek aktiv pod správou (AUM) ve výši 100 USD.

• Pro vytvoření klíče API je vyžadována správa aktiv (AUM) větší než 100 USD (AUM > 100U)

• Pro hlavní účty nebo podúčty je povoleno vytvářet API klíče pouze u účtů s AUM > 100U

Poznámka: Tato požadavek platí pouze pro uživatele v určitých oblastech

Co mám dělat, když se WebSocket nemůže připojit nebo se neustále odpojuje?

Potvrďte, že používáte správnou URL adresu WebSocket pro váš web a API službu. Zkontrolujte svou síť, proxy, nastavení TLS, parametry odběru, Ping/Pong heartbeat a logiku opětovného připojení. Pokud problém přetrvává, uveďte kanál, čas výskytu, úplnou chybovou zprávu a upravené logy.

Jak mám řešit chybu API nebo neplatný parametr požadavku?

Vyhledejte chybový kód v oficiální dokumentaci API pro váš web, poté ověřte koncový bod, HTTP metodu, parametry požadavku, režim účtu a omezení produktu. Pokud příčina stále není jasná, uveďte kompletní chybový kód, sCode/sMsg, čas výskytu a upravený požadavek a odpověď.

Proč selhala moje API objednávka, změna nebo zrušení objednávky?

Použijte prosím chybovou zprávu a chybový kód vrácený API k určení konkrétní příčiny. Pokud si nejste jisti, co chyba znamená, poskytněte prosím kompletní parametry požadavku a podrobnosti o chybě, abychom mohli dále vyšetřovat.

Co mám dělat, pokud vypadají tržní data, svíčky nebo data z objednávkové knihy nesprávně?

Potvrďte název kanálu, instId, parametry odběru a frekvenci požadavků a rozlište snímková data od inkrementálních aktualizací. U objednávkové knihy také ověřte ID sekvence a časová razítka. Pokud se zdá, že data chybí, zaznamenejte kanál, časové rozmezí a redigovanou surovou odpověď.

Proč se zůstatky, pozice nebo hodnoty marže v API liší od těch na webu nebo v aplikaci?

Nejprve rozlište obchodní účet a účet pro financování, poté ověřte režim účtu, měnový rozměr, koncový bod a čas aktualizace dat. Pro výpočty zůstatku, pozice a marže použijte nejnovější dokumentaci produktu a API pro příslušný web.

Co mám dělat, pokud selže API vložení, výběr nebo převod?

Zkontrolujte oprávnění API, měnu, síť, cílový účet a případné požadavky na adresář nebo bílý seznam, poté řešte problémy pomocí vráceného chybového kódu. Omezení týkající se bezpečnosti účtu, dodržování předpisů nebo rizik mohou vyžadovat další přezkoumání podpory pro příslušný web.

Jak vytvořím a použiji klíč API pro podúčet?

Vytvořte klíč API pod zamýšleným podúčtem a použijte oprávnění, heslo a doménu webu tohoto podúčtu. Nemíchejte klíč API, tajný klíč ani heslo rodičovského účtu s těmi podúčtu.

Co mám dělat po vyčerpání limitu rychlosti API?

Snižte rychlost požadavků podle limitu pro konkrétní koncový bod a tam, kde je to vhodné, používejte fronty požadavků, exponenciální zpětné odklady nebo dávkové koncové body. Rozsah a kvóta omezení rychlosti se mohou lišit podle koncového bodu, proto nepředpokládejte, že všechny koncové body mají stejný limit.

Kde mohu najít dokumentaci API, SDK a ukázky kódu?

Odkazovat se můžete na API dokumentaci (V5). Reference REST + WebSocket, seznam změn, chybové kódy, ukázky požadavků/odpovědí pro jednotlivé koncové body. Oficiální SDK (GitHub) — github.com/okxapi Příklad kódu naleznete v SDK.

Jaké informace bych měl poskytnout, pokud mohu říci pouze „API nefunguje“?

Uveďte koncový bod, HTTP metodu, zamýšlenou operaci, úplný chybový kód nebo zprávu, čas výskytu, lokalitu účtu, síťové prostředí a redigovaný požadavek a odpověď. Nikdy neposílejte API Secret, Passphrase, ověřovací kód ani neredigovaný podpis.

Co mám dělat, pokud mám stále dotazy ohledně API? Nebo mohu chatovat s API zákaznickou podporou?

Pokud máte další otázky, můžete se připojit k naší skupině podpory API:

• Čínská skupina podpory API

• English API Support Group

Poznámka:

Pokud máte otázky ohledně WebSocket nebo jiných témat souvisejících s API, klikněte na odkaz na článek a pomocí aplikace OKX naskenujte QR kód ve spodní části článku, abyste se připojili ke skupině a kontaktovali našeho specialistu na podporu API.

Jak skenovat: v aplikaci klepněte na Nabídka > ikonu Skenovat a naskenujte QR kód.