OKX API vanliga frågor
Vad avser lösenfras?
Det här är lösenordet du angav när du ansökte om API-nyckeln. Du måste komma ihåg det själv. Om du glömmer det kan du inte återställa det och du måste skapa en ny API-nyckel.
Hur skapar jag en API-nyckel?
I appen:
1. Logga in på ditt OKX-konto > Välj Meny (⋮⋮⋮) > Scrolla ned och välj API > Skapa API-nyckel
2. Fyll i API-namn > Välj konto och ändamål > Ange tillståndslista för IP-adresser > Välj behörigheter > Ange lösenfras
På webben:
1. Logga in på ditt OKX-konto > Gå till din Profil och välj API och anslutningar > Skapa API-nyckel
2. Fyll i API-nyckelns namn > Välj konto och Används för
3. Ange tillståndslista för IP-adresser > Välj Behörigheter > Ange Parafras
Notera:
IP-adresser hjälper till att säkra din API-nyckel. Du kan koppla upp till 20 adresser per nyckel, separerade med kommatecken eller mellanslag.
Du måste visa API-information och få tillgång till dess gränssnitt. Vänligen håll ditt lösenord säkert. Du kan skapa en ny API om du förlorar lösenordet, eftersom vi inte kan återställa API:er.
Hur hanterar eller redigerar jag API-nyckeln?
För att hantera eller redigera din API-nyckel på OKX:
Logga in på ditt OKX-konto och gå till Profil > API.
Du kommer att se en lista över dina befintliga API-nycklar. Klicka på den du vill hantera.
Härifrån kan du:
Visa API-nyckelns namn, behörigheter och kopplade IP-vitlista.
Redigera nyckelns namn, behörigheter (Läs, Handel, ta ut) eller bundna IP-adresser.
Ta bort nyckeln om den inte längre behövs.
Observera: Du kan inte se lösenfrasen efter den första skapelsen. Om den förloras måste du ta bort den befintliga nyckeln och skapa en ny. Spara alltid dina uppgifter på ett säkert sätt.
Hur skiljer jag mellan spot- och marginalhandel om jag handlar via API?
Sättet som spot och marginalhandel skiljs åt via API:et kan variera beroende på din kontotyp och inställningar. Vi rekommenderar att du hänvisar till OKX API-dokumentationen för de mest exakta och uppdaterade parametrarna som gäller för din kontokonfiguration.
Om du behöver ytterligare förtydliganden, vänligen kontakta OKX Assistant för personlig vägledning.
Hur skapar jag en demo disk API-nyckel?
För att handla på demo-diskens API behöver du skapa en API-nyckel på demo-disken. Följ stegen nedan:
Logga in på ditt OKX-konto > Handel > Demohandel > Personligt center > Skapa API-nyckel för demokonto > Starta demohandel
Kommer API-nyckeln att gå ut?
API-nycklar som inte är bundna till IP och har transaktions- eller uttagsbehörigheter kommer automatiskt att raderas efter 14 dagars inaktivitet. API-nycklar betraktas inte som inaktiva om de används för att anropa privata eller kontorelaterade gränssnitt som kräver identitetsverifiering, såsom att visa kontosaldo, faktureringsdata eller lägga order.
Endast skrivskyddade API-nycklar som är bundna till en IP-adress eller specifika behörigheter kommer inte att upphöra att gälla.
Vad är behörigheterna Loan, tjäna och överför?
Överför: Tillåter nyckeln att överföra medel mellan dina konton. Tillgänglig för alla konton.
Loan: Ger nyckeln möjlighet att låna, återbetala och hantera lån. Syns endast om ditt konto har rätt funktionsbehörighet.
Tjäna: Gör det möjligt för nyckeln att prenumerera på och lösa in Tjäna-produkter. Endast synligt om ditt konto har nödvändig funktionsbehörighet.
Om din API-nyckel tidigare hade Handel-behörigheter aktiverade kommer alla tre behörigheter automatiskt att aktiveras vid denna uppdatering. Ingen manuell inställning krävs.
Kan beställningar göras i valutaanheter när man lägger beställningar via gränssnittet?
Nej; för kontraktsorder är gränssnittet som standard inställt på order i antal kontrakt. Om du behöver räkna om mellan antal kontrakt och mynt kan du hänvisa till gränssnittet för omvandling från kontrakt till mynt här.
Hur får man fram gränssnittets fluktuationsfrekvens?
Gränssnittet kan inte direkt hämta prisökningen eller prisminskningen, men det kan beräknas med en beräkningsformel.
Uppgångs- och nedgångsvärdet för det senaste transaktionspriset jämfört med öppningspriset för K-linjen för 24 timmar sedan / 100 % av öppningspriset för K-linjen för 24 timmar sedan.
Ovanstående formeldata kan erhållas via marknadsgränssnittet här.
Vad är orsaken till felmeddelandet "51000 Parameter posSide error" när man lägger en order?
Du måste först kontrollera kontoläget; köp- och säljläge/öppnings- och stängningsläge, vilket kan ses här för att få posMode.
Notera:
Vid öppning och stängning av positioner samt vid orderläggning med ett kontrakt krävs parametern posSide, och lång eller kort fylls i.
Om det är ett köp- och säljläge, eller en kryptovaluta- eller hävstångstransaktion som genomförs under öppnings- och stängningsläget, stöder posSide endast netto eller ingen överföring.
Vilket gränssnitt kan användas för att få kontraktets nominella värde och minsta orderkvantitet?
Du kan använda gränssnittet för att få grundläggande information om handelsprodukter här.
kontraktets nominella värde: ctVal, minsta orderkvantitet: minSz.
Vad är formatet för instId?
Du kan direkt använda gränssnittet för att få grundläggande information om handelsprodukter här.
Hur ställer man in stop loss och take profit?
Om ordern är kopplad till take profit stop loss kan du hänvisa till ordergränssnittet här: attachAlgoOrds array-parametrar.
Men om det är en separat order stop loss kan du hänvisa till gränssnittet för strategiprovision här.
Varför rapporteras ett fel när utlösningspriset för take profit och stop loss anges: 51046, 51047, 51048, 51049?
Regler för att ställa in utlösningspris för stop-loss/take-profit – vid försäljning är take-profit-utlösningspriset högre än det senaste transaktionspriset, och stop-loss-utlösningspriset är lägre än det senaste transaktionspriset; medan vid köp är take-profit-utlösningspriset lägre än det senaste transaktionspriset, och stop-loss-utlösningspriset är högre än det senaste transaktionspriset.
Vad betyder "Interface error: 50102 Timestamp request expired"?
Detta fel uppstår när tidsstämpeln har förfallit. Du behöver anropa systemets tidsgränssnitt här för att synkronisera din lokala tid med vår servers tid. Att hålla tidsdifferensen inom 30 sekunder kan hjälpa till att undvika detta problem.
Observera: tiden i förfrågningshuvudets tid är i UTC0. När serverns tidsgränssnitt anropas, anges tiden i UTC + 8.
Vad betyder "Gränssnittsfel: 50101 APIKey matchar inte den aktuella miljön"?
Detta beror på en mismatch mellan API-nyckeln och den aktuella miljön. Anrop från riktiga konton kräver användning av den riktiga konto-API-nyckeln, och värdet på parametern x-simulated-trading i förfrågningshuvudet måste vara 0. Anrop från simulerade konton kräver användning av den simulerade konto-API-nyckeln, och värdet på parametern x-simulated-trading i förfrågningshuvudet måste vara 1.
Vad betyder "Gränssnitts fel: 51010 Begäran stöds inte under nuvarande kontoläge"?
Detta är relaterat till ditt kontoläge. Om du vill placera en hävstång eller ett kontrakt i en enskild valuta måste du byta till något av de andra tre lägena, förutom spotläge! Du kan ställa in det via gränssnittets inställningar här, eller så kan du ställa in det på webben eller i appen.
Obs: den första inställningen måste göras på sidan eller i appen; inställningsalternativet i huvudmenyn på handels-sidan - kontoläge.
Vad betyder "Gränssnitts fel: 51121 Orderkvantitet måste vara en multipel av lotsstorleken"?
I API:et anges kontraktsorder i enheter av sheets och måste vara en multipel av den minsta orderkvantiteten för valutaparet. Den minsta orderkvantiteten kan erhållas via fältet minSz i produktgränssnittet här.
"Uttagsfel: 58207 Uttagsadressen finns inte på tillståndslistan för verifieringsundantag"; varför rapporterar verifieringen av tillståndslistan fortfarande ett fel när den är stängd på uttagssidan?
För att ta ut mynt via API-gränssnittet måste du lägga till en uttagsadress på sidan och markera knappen för icke verifierad via Visa. Om tillståndslistans verifiering är avstängd på sidan påverkar det inte gränssnittets funktion.
Vad betyder "Interface error: 50004 API endpoint request timeout" (det betyder inte att förfrågan lyckades eller misslyckades, vänligen kontrollera förfrågans resultat)?
50004 orsakas vanligtvis av överbelastning på servern. Klockan 8, 16 och 24 är tidpunkterna för insamling av kapitalavgifter varje dag. Vid dessa tider är serverbelastningen hög. Det rekommenderas att sprida ut transaktionerna under dessa tider. Om ett fel 50004 rapporteras vid andra tider kan det försöka igen senare. Om en order läggs med ett fel 50004 representerar det inte det faktiska resultatet av gränssnittsfrågan. Förfrågan kan lyckas eller misslyckas. Vänligen hänvisa till det faktiska resultatet.
Vad betyder felet "50119 API-nyckel finns inte"?
Det här felet uppstår vanligtvis när ditt kontos domän inte matchar din region.
För EEA-användare, ändra din API-förfrågnings domännamn till eea.okx.com istället för www.okx.com.
För US-användare, vänligen ändra ditt API-förfrågningsdomännamn till us.okx.com istället för www.okx.com.
Om du använder en tredjepartsprogramvara för att ansluta till OKX och ser detta fel, vänligen kontrollera med programvaruleverantören om den stöder regionala domäner. Till exempel måste användare i EES ansluta via eea.okx.com, annars kommer förfrågan att misslyckas.
Varför visas felet "50110" när jag kopplar till en tredjepartsprogramvara?
Detta fel kan uppstå om den aktuella API-nyckeltypen inte är kompatibel med tredjepartsprogramvarans bindning. Försök att ansöka om API-nyckelns transaktionstyp utan att binda en IP-lista och anslut sedan om tredjepartsprogramvaran.
Hur får jag den senaste transaktionspriset för ett visst valutapar?
Använd detaljer här för tickers och för ticker, över här. Tickers-gränssnittet används för att hämta den senaste transaktionspriset för valutapar i batchar, och ticker används för att hämta den senaste transaktionspriset för individuella valutapar.
Exempel på svarparameter för senast handlade pris i avsnittet Ticker
Vilka krav finns för att skapa en API-nyckel?
Ett minimisaldo för Assets Under Management (AUM) på 100 USD krävs för att skapa en API-nyckel.
Ett AUM större än 100 USD (AUM > 100U) krävs för att skapa en API-nyckel
För huvudkonton eller underkonton är det endast konton med AUM > 100U som tillåts skapa API-nycklar
Observera: Detta krav gäller endast användare i vissa områden
Vad ska jag göra om WebSocket inte kan ansluta eller fortsätter att kopplas från?
Bekräfta att du använder rätt WebSocket-URL för din webbplats och API-tjänst. Kontrollera ditt nätverk, proxy, TLS-inställningar, prenumerationsparametrar, Ping/Pong-hjärtslag och återanslutningslogik. Om problemet kvarstår, ange kanalen, tidpunkten för händelsen, fullständigt felmeddelande och redigerade loggar.
Hur ska jag felsöka en API-felkod eller ogiltig begäransparameter?
Slå upp felkoden i den officiella API-dokumentationen för din webbplats och verifiera sedan slutpunkt, HTTP-metod, begäransparametrar, kontoläge och produktbegränsningar. Om orsaken fortfarande är oklar, ange den fullständiga felkoden, sCode/sMsg, tidpunkt för förekomsten samt maskerade begäran och svar.
Varför misslyckades min API-orderläggning, ändring eller annullering?
Använd felmeddelandet och felkoden som API:et returnerar för att fastställa den specifika orsaken. Om du är osäker på vad felet betyder, vänligen ange de fullständiga förfrågningsparametrarna och feluppgifterna så att vi kan undersöka vidare.
Vad ska jag göra om marknadsdata, candlestick eller orderbokdata ser felaktigt ut?
Bekräfta kanalnamnet, instId, prenumerationsparametrar och förfrågningsfrekvens, och skilj på snapshot-data och inkrementella uppdateringar. För orderböcker, verifiera även sekvens-ID:n och tidsstämplar. Om data verkar saknas, registrera kanalen, tidsintervallet och den redigerade råa responsen.
Varför skiljer sig API-saldon, positioner eller marginalvärden från webbplatsen eller appen?
Först skilj på handelskonto och finansieringskonto, verifiera sedan kontoläge, valutadimension, slutpunkt och datauppdateringstid. För beräkningar av saldo, position och marginal, använd den senaste produkt- och API-dokumentationen för den aktuella sajten.
Vad ska jag göra om en API-sättning in, uttag eller överföring misslyckas?
Kontrollera API-behörigheter, valuta, nätverk, mottagarkonto samt eventuella krav på adressbok eller vitlista, och felsök sedan med hjälp av den returnerade felkoden. Kontosäkerhets-, efterlevnads- eller riskbegränsningar kan kräva ytterligare granskning av supporten för den aktuella webbplatsen.
Hur skapar och använder jag en API-nyckel för ett underkonto?
Skapa API-nyckeln under det avsedda underkontot och använd det underkontots behörigheter, lösenfras och webbplatsdomän. Blanda inte föräldrakontots och underkontots API-nyckel, hemlighet eller lösenfras.
Vad ska jag göra efter att ha utlösts en API-hastighetsbegränsning?
Minska förfrågningsfrekvensen enligt gränsen för den specifika slutpunkten och använd förfrågningsköer, exponentiell backoff eller batchslutpunkter där det är lämpligt. Begränsningens omfattning och kvot kan skilja sig mellan slutpunkter, så anta inte att alla slutpunkter har samma tilldelning.
Var kan jag hitta API-dokumentation, SDK:er och kodexempel?
Du kan hänvisa till API-dokumentationen (V5). REST + WebSocket-referens, ändringslogg, felkoder, exempel på förfrågningar/svar per slutpunkt. Officiella SDK:er (GitHub) — github.com/okxapi Kodexempel finns i SDK:n.
Vilken information bör jag lämna om jag bara kan säga "API:et fungerar inte"?
Ange slutpunkt, HTTP-metod, avsedd operation, komplett felkod eller meddelande, tidpunkt för förekomst, kontoplats, nätverksmiljö samt maskerad begäran och svar. Skicka aldrig en API Secret, lösenfras, verifieringskod eller omaskerad signatur.
Vad ska jag göra om jag fortfarande har frågor om API? Eller kan jag chatta med API:s kundtjänst?
Om du har några ytterligare frågor är du välkommen att gå med i vår API-supportgrupp:
Notera:
Om du har frågor om WebSocket eller andra API-relaterade ämnen, klicka på artikelns länk och skanna QR-koden längst ner i artikeln med OKX-appen för att gå med i gruppen och kontakta vår API-supportspecialist.
Hur man skannar: i appen, tryck på Meny > skanningsikonen och skanna QR-koden.