OKX API UKK
Mitä Passphrase tarkoittaa?
Tämä on salasana, jonka annoit hakiessasi API-avainta. Sinun täytyy muistaa se itse. Jos unohdat sen, et voi palauttaa sitä, ja sinun täytyy luoda uusi API-avain.
Kuinka luon API-avaimen?
Sovelluksessa:
1. Kirjaudu OKX-tilillesi > Valitse Valikko (⋮⋮⋮) > Selaa alas ja valitse API > Luo API-avain
2. Täytä API-nimi > Valitse Tili ja Tarkoitus > Syötä IP-osoitteiden sallittujen lista > Valitse Oikeudet > Syötä Salalause
Verkossa:
1. Kirjaudu OKX-tilillesi > Siirry profiiliisi ja valitse API ja yhteydet > Luo API-avain
2. Täytä API-avaimen nimi > Valitse tili ja Käytetään
3. Syötä IP-osoitteen sallittujen lista > Valitse Oikeudet > Syötä Salalause
Huomautus:
IP-osoitteet auttavat suojaamaan API-avaintasi. Voit liittää enintään 20 osoitetta avainta kohden, erottaen ne pilkulla tai välilyönnillä.
Sinun on tarkasteltava API-tietoja ja käytettävä sen rajapintaa. Pidä salasanasi turvassa. Voit luoda uuden API-avaimen, jos unohdat salasanan, sillä emme voi palauttaa olemassa olevia API-avaimia.
Kuinka hallinnoin tai muokkaan API-avainta?
API-avaimesi hallintaan tai muokkaamiseen OKX:ssä:
Kirjaudu OKX-tilillesi ja siirry kohtaan Profiili > API.
Näet luettelon olemassa olevista API-avaimista. Napsauta sitä, jota haluat hallita.
Tästä voit:
Katso API-avaimen nimi, käyttöoikeudet ja liitetty IP-valkoinen lista.
Muokkaa avaimen nimeä, käyttöoikeuksia (Lue, Treidaus, Nosta) tai sidottuja IP-osoitteita.
Poista avain, jos sitä ei enää tarvita.
Huomautus: Et voi nähdä salasanaa sen luomisen jälkeen. Jos se katoaa, sinun täytyy poistaa olemassa oleva avain ja luoda uusi. Säilytä aina tunnistetietosi turvallisesti.
Miten erotan spot- ja marginaalitreidauksen, jos käyn kauppaa API:n kautta?
Tapa, jolla spot- ja marginaalitreidaus erotetaan API:n kautta, voi vaihdella tilisi tyypin ja asetusten mukaan. Suosittelemme tutustumaan OKX API -dokumentaatioon saadaksesi tarkimmat ja ajantasaisimmat parametrit, jotka koskevat tilisi asetuksia.
Jos tarvitset lisäselvitystä, ota yhteyttä OKX Assistant -palveluun saadaksesi henkilökohtaista opastusta.
Kuinka luon demo-levyn API-avaimen?
Jotta voit käydä kauppaa demo-levyn API:n kautta, sinun täytyy luoda API-avain demo-levylle. Seuraa alla olevia ohjeita:
Kirjaudu OKX-tilillesi > Treidaus > Demotreidaus > Oma keskus > Luo demotilin API-avain > Aloita demotreidaus
Vanheneeko API-avain?
IP-osoitteeseen sitomattomat API-avaimet, joilla on transaktio- tai nosto-oikeudet, poistetaan automaattisesti 14 päivän käyttämättömyyden jälkeen. API-avaimia ei katsota käyttämättömiksi, jos niitä käytetään kutsumaan yksityisiä tai tiliin liittyviä rajapintoja, jotka vaativat henkilöllisyyden todennuksen, kuten tilin saldon tarkastelu, laskutustietojen katselu tai tilausten tekeminen.
Vain IP-osoitteeseen tai tiettyihin oikeuksiin sidotut vain luku -käyttöoikeudet eivät vanhene.
Mitä Loan-, Earn- ja Transfer-oikeudet tarkoittavat?
Siirto: Mahdollistaa avaimen siirtää varoja tiliesi välillä. Käytettävissä kaikille tileille.
Loan: Mahdollistaa lainojen lainaamisen, takaisinmaksun ja hallinnan. Näkyy vain, jos tililläsi on tarvittavat ominaisuusoikeudet.
Ansaitse: Mahdollistaa avaimen tilaamisen ja lunastamisen Earn-tuotteisiin. Näkyy vain, jos tililläsi on vaadittu ominaisuuksien kelpoisuus.
Jos API-avaimellasi oli aiemmin treidausoikeudet käytössä, kaikki kolme oikeutta aktivoidaan automaattisesti tämän päivityksen yhteydessä. Manuaalista asetusta ei tarvita.
Voidaanko tilauksia tehdä valuuttayksiköissä käyttöliittymän kautta tilattaessa?
Ei; sopimustoimeksiannoissa käyttöliittymä käyttää oletuksena sopimusten lukumäärää. Jos sinun täytyy laskea muunnos sopimusten lukumäärän ja kolikoiden välillä, voit katsoa sopimusten ja kolikoiden muunnosliittymää täältä.
Miten saada käyttöliittymän vaihteluprosentti?
Käyttöliittymä ei voi suoraan saada tietoa hinnan noususta tai laskusta, mutta se voidaan laskea laskentakaavan avulla.
Viimeisimmän transaktion hinnan nousu- ja laskuarvo verrattuna K-linjan 24 tuntia sitten tapahtuneeseen avaushintaan / 100 % K-linjan 24 tuntia sitten tapahtuneesta avaushinnasta.
Yllä olevat kaavan tiedot voi saada markkinarajapinnan kautta täältä.
Mikä on syy virheilmoitukseen "51000 Parameter posSide error" toimeksiantoa tehdessä?
Sinun täytyy ensin tarkistaa tilitila; osto- ja myyntitila/avaus- ja sulkemistila, jotka voi nähdä tästä saadaksesi posMode-arvon.
Huomautus:
Sopimusta käytettäessä positioiden avaamiseen ja sulkemiseen sekä toimeksiantojen tekemiseen posSide-parametri on pakollinen, ja siihen täytetään pitkä positio tai myy lyhyeksi.
Jos kyseessä on osto- ja myyntitila, tai kryptovaluutta- tai vivutettu transaktio suoritetaan avaamis- ja sulkemistilassa, posSide tukee vain nettotilaa tai ei lähetystä.
Mitä käyttöliittymää voidaan käyttää sopimuksen nimellisarvon ja vähimmäistilauksen määrän saamiseksi?
Voit käyttää käyttöliittymää saadaksesi perustietoja treidaustuotteista tästä.
sopimuksen nimellisarvo: ctVal, minimitoimeksiannon määrä: minSz.
Mikä on instId:n muoto?
Voit käyttää käyttöliittymää suoraan saadaksesi perustiedot treidaustuotteista tästä.
Kuinka asetan stop lossin ja take profitin?
Jos toimeksianto on liitetty take profit stop loss -toimeksiantoon, voit tutustua toimeksiantojen käyttöliittymään tästä: attachAlgoOrds-taulukon parametreihin.
Jos kyseessä on kuitenkin erillinen stop loss -toimeksianto, voit tutustua strategian komissiorajapintaan tästä.
Miksi take profit- ja stop loss -kynnyshintaa asetettaessa ilmoitetaan virhe: 51046, 51047, 51048, 51049?
Säännöt stop-loss-kynnyshintojen ja take-profit-kynnyshintojen asettamiselle – myynnin aikana take-profit-kynnyshinta on suurempi kuin viimeisin transaktiohinta, ja stop-loss-kynnyshinta on pienempi kuin viimeisin transaktiohinta; oston aikana take-profit-kynnyshinta on pienempi kuin viimeisin transaktiohinta, ja stop-loss-kynnyshinta on suurempi kuin viimeisin transaktiohinta.
Mitä tarkoittaa "Interface error: 50102 Timestamp request expired"?
Tämä virhe ilmenee, kun aikaleima on erääntynyt. Tässä sinun tulee kutsua järjestelmän aika -rajapinta synkronoimaan paikallinen aikasi palvelimemme ajan kanssa. Aikojen eron pitäminen alle 30 sekunnissa voi auttaa välttämään tämän ongelman.
Huomautus: pyynnön otsikon aika on UTC0-ajassa. Kun kutsutaan palvelimen aika -rajapintaa, aika annetaan UTC + 8 -ajassa.
Mitä tarkoittaa "Interface error: 50101 APIKey does not match the current environment"?
Tämä johtuu API-avaimen ja nykyisen ympäristön välisestä ristiriidasta. Oikean tilin kutsuissa on käytettävä oikean tilin API-avainta, ja pyynnön otsikossa olevan x-simulated-trading-parametrin arvon on oltava 0. Simuloidun tilin kutsuissa on käytettävä simuloidun tilin API-avainta, ja pyynnön otsikossa olevan x-simulated-trading-parametrin arvon on oltava 1.
Mitä tarkoittaa "Rajapinta virhe: 51010 Pyyntö ei tuettu nykyisessä tilitilassa"?
Tämä liittyy tilitilaasi. Jos haluat asettaa vipua tai sopimuksen yhdelle valuutalle, sinun täytyy vaihtaa muihin kolmeen tilitilaan paitsi spot-tilaan! Voit tehdä tämän käyttöliittymän asetuksista täältä, tai voit asettaa sen verkkosivulla tai sovelluksessa.
Huomautus: ensimmäinen asetus on tehtävä sivulla tai sovelluksessa; asetukset-valinta päävalikossa treidaussivulla - tilitila.
Mitä tarkoittaa "Interface error: 51121 Order quantity must be a multiple of the lot size"?
API:ssa sopimustoimeksiannot ovat arkkien yksiköissä ja niiden on oltava valuuttaparin vähimmäistilausmäärän monikertoja. Vähimmäistilausmäärän voi saada tuotteen rajapinnan minSz-kentästä täältä.
"Nosto-virhe: 58207 Nosto-osoitetta ei ole sallittujen listalla todennuspoikkeusta varten"; miksi sallittujen listan todennus silti ilmoittaa virheen, vaikka se on suljettu nostosivulla?
Kolikoiden nostamiseksi API-rajapinnan kautta on tarpeen lisätä nosto-osoite sivulle ja valita Visa-todentamaton -painike. Se, onko sallittujen lista -todennus pois päältä sivulla, ei vaikuta rajapinnan toimintaan.
Mitä tarkoittaa "Interface error: 50004 API endpoint request timeout" (ei tarkoita, että pyyntö onnistui tai epäonnistui, tarkista pyyntösi tulos)?
Virhe 50004 johtuu yleensä liiallisesta palvelinpaineesta. Pääomamaksujen keräysaikapisteet ovat päivittäin klo 8, 16 ja 24. Tällöin palvelimella on suuri kuormitus. Suositellaan hajauttamaan kaupankäyntiä näihin aikoihin. Jos virhe 50004 ilmenee muina aikoina, sitä voi yrittää uudelleen myöhemmin. Jos toimeksianto tehdään virheellä 50004, se ei edusta rajapintapyynnön todellista tulosta. Pyyntö voi onnistua tai epäonnistua. Katso todellinen tulos.
Mikä on "50119 API key doesn’t exist" -virhe?
Tämä virhe ilmenee yleensä, kun tilisi verkkotunnus ei vastaa aluettasi.
EEA-käyttäjien tulee vaihtaa API-pyyntönsä verkkotunnuksen nimeksi www.okx.comin sijaan eea.okx.com.
Yhdysvaltojen käyttäjien tulee vaihtaa API-pyyntönsä verkkotunnuksen nimeksi us.okx.com www.okx.com sijaan.
Jos käytät kolmannen osapuolen ohjelmistoa yhdistääksesi OKX:ään ja näet tämän virheen, tarkista ohjelmiston tarjoajalta, tukeeko se alueellisia verkkotunnuksia. Esimerkiksi ETA-alueen käyttäjien on yhdistettävä osoitteeseen eea.okx.com, muuten pyyntö epäonnistuu.
Miksi kolmannen osapuolen ohjelmistoon yhdistettäessä näkyy virhe "50110"?
Tämä virhe voi ilmetä, jos nykyinen API-avaintyyppi ei ole yhteensopiva kolmannen osapuolen ohjelmiston kanssa. Yritä hakea API-avaimen transaktiotyyppi ilman IP-listan sitomista ja yhdistä sitten kolmannen osapuolen ohjelmisto uudelleen.
Miten saan viimeisimmän transaktion hinnan tietylle valuuttaparille?
Käytä tietoja tästä treidaustunnuksista ja yksittäisestä treidaustunnuksesta tästä. Treidaustunnukset -rajapintaa käytetään saamaan viimeisimmät transaktiohinnat valuuttapareille erissä, ja treidaustunnusta käytetään saamaan viimeisin transaktiohinta yksittäiselle valuuttaparille.
Esimerkki viimeksi treidatun hinnan vastausparametrista treidaustunnusten osiossa
Mitkä ovat vaatimukset API-avaimen luomiseksi?
API-avaimen luomiseksi vaaditaan vähintään 100 USD:n hallinnoitavien varojen (AUM) saldo.
API-avaimen luomiseksi vaaditaan yli 100 USD:n hallinnoitavat varat (AUM > 100U)
Päätilien tai alatilien osalta API-avainten luomiseen sallitaan vain tilit, joiden hallinnoitavat varat (AUM) ovat yli 100U.
Huomautus: Tämä vaatimus koskee vain käyttäjiä tietyillä alueilla
Mitä minun pitäisi tehdä, jos WebSocket ei voi muodostaa yhteyttä tai yhteys katkeilee jatkuvasti?
Varmista, että käytät oikeaa WebSocket-URL-osoitetta sivustollesi ja API-palvelullesi. Tarkista verkko-, välityspalvelin-, TLS-asetukset, tilausparametrit, Ping/Pong-sydämenlyönti ja uudelleenyhdistämislogiikka. Jos ongelma jatkuu, toimita kanava, esiintymisaika, täydellinen virheilmoitus ja sensuroidut lokitiedot.
Miten minun tulisi ratkaista API-virhekoodi tai virheellinen pyyntöparametri?
Etsi virhekoodi virallisesta API-dokumentaatiosta sivustollesi, ja todenna sitten päätepiste, HTTP-menetelmä, pyyntöparametrit, tilitila ja tuotteen rajoitukset. Jos syy on edelleen epäselvä, anna täydellinen virhekoodi, sCode/sMsg, esiintymisaika sekä sensuroitu pyyntö ja vastaus.
Miksi API-toimeksiantoni tekeminen, muokkaaminen tai peruuttaminen epäonnistui?
Käytä API:n palauttamaa virheilmoitusta ja virhekoodia määrittääksesi tarkemman syyn. Jos et ole varma, mitä virhe tarkoittaa, toimita täydelliset pyyntöparametrit ja virhetiedot, jotta voimme tutkia asiaa tarkemmin.
Mitä minun pitäisi tehdä, jos markkinadata, kynttiläkaaviot tai toimeksiantokirjan tiedot näyttävät virheellisiltä?
Vahvista kanavan nimi, instId, tilausparametrit ja pyyntöjen tiheys sekä erottele tilannekuvatiedot inkrementaalisista päivityksistä. Toimeksiantokirjojen osalta tarkista myös sekvenssi-ID:t ja aikaleimat. Jos tietoja näyttää puuttuvan, kirjaa kanava, aikaväli ja sensuroitu raakavastaus.
Miksi API:n saldojen, positioiden tai marginaaliarvojen luvut poikkeavat verkkosivuston tai sovelluksen tiedoista?
Erottele ensin treidaustili ja rahoitustili, sitten todenna tilitila, valuuttadimensio, päätepiste ja tietojen päivitysaika. Saldo-, positio- ja marginaalilaskelmissa käytä soveltuvan sivuston uusinta tuotteen ja API:n dokumentaatiota.
Mitä minun pitäisi tehdä, jos API-talletus, -nosto tai -siirto epäonnistuu?
Tarkista API-oikeudet, valuutta, verkko, kohdetili sekä mahdolliset osoitekirja- tai valkoinen lista -vaatimukset, ja ratkaise ongelma palautetun virhekoodin avulla. Tilin turvallisuus-, vaatimustenmukaisuus- tai riskirajoitukset saattavat vaatia lisätarkastelua tukitiimiltä kyseisellä sivustolla.
Kuinka luon ja käytän API-avainta alatilille?
Luo API-avain tarkoitetulle alatilille ja käytä kyseisen alatilin oikeuksia, salasanaa ja sivuston verkkotunnusta. Älä sekoita päätilin ja alatilin API-avaimia, salaisuuksia tai salasanoja.
Mitä minun pitäisi tehdä, kun API:n nopeusrajoitus aktivoituu?
Vähennä pyyntöjen määrää kyseisen päätepisteen rajoituksen mukaisesti ja käytä tarvittaessa pyyntöjonoja, eksponentiaalista takaisinkytkentää tai eräpäätteitä. Nopeusrajoituksen laajuus ja kiintiö voivat vaihdella päätepisteittäin, joten älä oleta, että kaikilla päätepisteillä on sama sallittu määrä.
Mistä löydän API-dokumentaation, SDK:t ja koodiesimerkit?
Voit viitata API-dokumentaatioon (V5). REST + WebSocket -viite, muutosloki, virhekoodit, pyyntö-/vastausesimerkit per-päätepiste. Viralliset SDK:t (GitHub) — github.com/okxapi Koodiesimerkki löytyy SDK:sta.
Mitä tietoja minun tulisi antaa, jos voin vain sanoa "API ei toimi"?
Anna päätepiste, HTTP-menetelmä, tarkoitettu toiminto, täydellinen virhekoodi tai -viesti, esiintymisaika, tilisivusto, verkkoympäristö sekä sensuroitu pyyntö ja vastaus. Älä koskaan lähetä API-salaisuutta, salasanaa, todennuskoodia tai sensuroimatonta allekirjoitusta.
Mitä minun pitäisi tehdä, jos minulla on edelleen API-kysely? Vai voinko keskustella API-asiakaspalvelun kanssa?
Jos sinulla on lisäkysymyksiä, olet tervetullut liittymään API-tukiryhmäämme:
Huomautus:
Jos sinulla on kysymyksiä WebSocketista tai muista API:hin liittyvistä aiheista, klikkaa artikkelin linkkiä ja skannaa artikkelin alareunassa oleva QR-koodi OKX:n sovelluksella liittyäksesi ryhmään ja ottaaksesi yhteyttä API-tukiasiantuntijaamme.
Kuinka skannata: sovelluksessa napauta Valikko > Skannaa-kuvaketta ja skannaa QR-koodi.