Întrebări frecvente despre API OKX

La ce se referă Parola de acces?

Aceasta este parola pe care ai introdus-o când ai solicitat cheia API. Trebuie să ți-o amintești singur. Odată ce o uiți, nu o poți recupera și va trebui să creezi o nouă cheie API.

Cum creez o cheie API?

Pe aplicație:

1. Conectează-te la Cont OKX > Selectează Meniu (⋮⋮⋮) > Derulează în jos și selectează cheie API > Creează cheie API

2. Completează numele API > Selectează Contul și Scopul > Introdu lista de permisiuni pentru adrese IP > Selectează Permisiunile > Introdu Parafraza

Pe web:

1. Conectează-te la Cont OKX > Accesează Profilul tău și selectează API și conexiuni > Creează cheie API

2. Completează numele cheii API > Selectează contul și Utilizat pentru

3. Introdu lista de permisiuni pentru adresele IP > Selectează Permisiuni > Introdu Parola de acces

Notă:

• Adresele IP ajută la securizarea cheii API. Poți conecta până la 20 de adrese pentru fiecare cheie, separându-le prin virgulă sau spațiu.

• Trebuie să vizualizezi informațiile API și să accesezi interfața acestuia. Te rugăm să îți păstrezi parola în siguranță. Poți crea un API nou dacă pierzi parola, deoarece nu putem recupera API-urile.

Cum gestionez sau editez cheia API?

Pentru a gestiona sau edita cheia API pe OKX:

1. Conectează-te la Cont OKX și accesează Profil > API.

2. Vei vedea o listă cu cheile tale API existente. Fă clic pe cea pe care vrei să o gestionezi.

3. De aici poți:

   • Vezi numele cheii API, permisiunile și lista IP-urilor autorizate asociate.

   • Editează numele cheii, permisiunile (Citire, Tranzacționare, Retrage) sau adresele IP asociate.

   • Șterge cheia dacă nu mai este necesară.

Notă: Nu poți vizualiza fraza de acces după crearea inițială. Dacă o pierzi, va trebui să ștergi cheia existentă și să creezi una nouă. Păstrează întotdeauna acreditările în siguranță.

Cum pot diferenția între tranzacționarea Spot și tranzacționarea în marjă dacă folosesc API pentru tranzacționare?

Modul în care tranzacționarea Spot și tranzacționarea în marjă sunt diferențiate prin API poate varia în funcție de tipul și setările contului tău. Recomandăm consultarea documentației API OKX pentru cele mai precise și actualizate parametri aplicabili configurării contului tău.

Dacă ai nevoie de clarificări suplimentare, te rugăm să contactezi OKX Assistant pentru îndrumare personalizată.

Cum creez o cheie API pentru demo disk?

Pentru a face tranzacții pe API-ul demo disk, trebuie să creezi o cheie API pe demo disk. Urmează pașii de mai jos:

Conectează-te la Cont OKX > tranzacționare > tranzacționare în modul demo > Centrul personal > Creează cheie API pentru cont demo > Începe tranzacționarea în modul demo

Cheia API va expira?

Cheile API care nu sunt legate de IP și au permisiuni de tranzacție sau retragere vor fi șterse automat după 14 zile de inactivitate. Cheile API nu vor fi considerate inactive dacă sunt folosite pentru a apela interfețe private sau legate de cont care necesită verificarea identității, cum ar fi vizualizarea soldului contului, a datelor de facturare sau plasarea comenzilor.

Doar cheile API cu acces în modul read-only, legate de o adresă IP sau de permisiuni specifice, nu vor expira.

Ce sunt permisiunile Loan, Earn și Transfer?

• Transfer: Permite cheii să efectueze transfer între conturile tale. Disponibil pentru toate conturile.

• Împrumut: Permite cheii să împrumute, să ramburseze și să gestioneze împrumuturi. Vizibil doar dacă contul tău are eligibilitatea necesară pentru această funcție.

• Câștig: Permite cheii să se aboneze la și să recupereze produsele Câștig. Vizibil doar dacă contul tău are eligibilitatea necesară pentru această funcție.

Dacă cheia ta API avea anterior permisiuni de Tranzacționare activate, toate cele trei permisiuni vor fi activate automat odată cu această actualizare. Nu este necesară nicio configurare manuală.

Pot fi plasate ordine în unități de monedă atunci când plasezi ordine prin interfață?

Nu; pentru ordinele pe contracte, interfața folosește implicit ordinele exprimate în număr de contracte. Dacă trebuie să calculezi conversia între numărul de contracte și monede, poți consulta interfața de conversie număr contracte-monede aici.

Cum se obține rata de fluctuație a interfeței?

Interfața nu poate obține direct creșterea sau scăderea prețului, dar aceasta poate fi calculată printr-o formulă de calcul.

Creșterea și scăderea valorii celui mai recent preț al tranzacției comparativ cu prețul de deschidere al K-line cu 24 de ore în urmă/100% din prețul de deschidere al K-line cu 24 de ore în urmă.

Datele formulei de mai sus pot fi obținute prin interfața pieței aici.

Care este motivul mesajului de eroare „51000 Parameter posSide error” atunci când plasezi un ordin?

Trebuie să verifici mai întâi mod (de) cont; mod de cumpărare și vânzare/mod de deschidere și închidere, care poate fi vizualizat aici pentru a obține posMode.

Notă:

• În cazul deschiderii și închiderii pozițiilor și plasării ordinelor folosind un contract, parametrul posSide este obligatoriu, iar long sau short trebuie completat.

• Dacă este un mod de cumpărare și vânzare sau o tranzacție cu criptomonedă ori cu efect de levier realizată în modul de deschidere și închidere, posSide acceptă doar net sau fără transmitere.

Care interfață poate fi folosită pentru a obține valoarea nominală a contractului și cantitatea minimă a ordinului?

Poți folosi interfața pentru a obține informații de bază despre produsele de tranzacționare aici.

valoarea nominală a contractului: ctVal, cantitatea minimă a ordinului: minSz.

Care este formatul pentru instId?

Poți folosi direct interfața pentru a obține informațiile de bază despre produsele de tranzacționare aici.

Cum să setezi stop loss și take profit?

Dacă ordinul este atașat la take profit stop loss, poți consulta interfața ordinului aici: parametrii array attachAlgoOrds.

Totuși, dacă este un stop loss separat pentru ordin, poți consulta interfața de comision pentru strategie aici.

De ce apare o eroare la setarea prețului de declanșare pentru take profit și stop loss: 51046, 51047, 51048, 51049?

Reguli pentru setarea prețului de declanșare stop-loss/prețului de declanșare take-profit – în timpul vânzării, prețul de declanșare take-profit este mai mare decât prețul ultimei tranzacții, iar prețul de declanșare stop-loss este mai mic decât prețul ultimei tranzacții; în timpul cumpărării, prețul de declanșare take-profit este mai mic decât prețul ultimei tranzacții, iar prețul de declanșare stop-loss este mai mare decât prețul ultimei tranzacții.

Ce înseamnă „Eroare interfață: 50102 Cererea de timestamp a expirat”?

Această eroare apare când marca temporală a expirat. Trebuie să apelezi interfața de timp a sistemului pentru a sincroniza timpul local cu timpul serverului nostru. Menținerea diferenței de timp în limite de 30 de secunde poate ajuta la evitarea acestei probleme.

Notă: ora din antetul cererii este în UTC0. Când se apelează interfața de timp a serverului, ora este furnizată în UTC + 8.

Ce înseamnă „Eroare de interfață: 50101 APIKey nu corespunde mediului curent”?

Aceasta se datorează nepotrivirii dintre cheia API și mediul curent. Apelurile pentru contul real necesită utilizarea cheii API a contului real, iar valoarea parametrului x-simulated-trading din antetul cererii trebuie să fie 0. Apelurile pentru contul simulat necesită utilizarea cheii API a contului simulat, iar valoarea parametrului x-simulated-trading din antetul cererii trebuie să fie 1.

Ce înseamnă „Eroare de interfață: 51010 Cerere neacceptată în mod (de) cont curent”?

Acest lucru este legat de mod (de) cont. Dacă dorești să plasezi un levier sau un contract pentru o singură monedă, trebuie să te ajustezi la celelalte trei moduri, cu excepția mod spot! Poți seta acest lucru prin setările interfeței aici, sau îl poți seta pe web sau în aplicație.

Notă: prima setare trebuie configurată pe pagină sau în aplicație; opțiunea de setări din meniul principal al paginii de tranzacționare - mod (de) cont.

Ce înseamnă „Eroare de interfață: 51121 Cantitatea ordinului trebuie să fie un multiplu al dimensiunii lotului”?

În API, contractele ordinelor sunt în unități de contract și trebuie să fie un multiplu al cantității minime de ordin a perechii de monedă. Cantitatea minimă de ordin poate fi obținută prin câmpul minSz al interfeței produsului aici.

„Eroare de retragere: 58207 Adresa de retragere nu este pe lista de permisiuni pentru scutirea de verificare”; de ce raportarea listei de permisiuni pentru verificare încă afișează o eroare când este închisă pe pagina de retragere?

Pentru a retrage monede folosind interfața API, este necesar să adaugi o adresă de retragere pe pagină și să bifezi butonul „non verified by visa”. Dacă verificarea listei de permisiuni este dezactivată pe pagină, acest lucru nu va afecta funcția interfeței.

Ce înseamnă „Eroare interfață: 50004 timeout la cererea endpoint API” (nu înseamnă că cererea a fost reușită sau eșuată, te rugăm să verifici rezultatul cererii)?

Codul 50004 este de obicei cauzat de o presiune excesivă asupra serverului. Orele 8, 16 și 24 sunt momentele în care se colectează taxele de capital în fiecare zi. În aceste intervale, presiunea asupra serverului este ridicată. Se recomandă să distribui tranzacțiile în afara acestor intervale. Dacă eroarea 50004 apare în alte momente, se poate încerca din nou mai târziu. Dacă un ordin este plasat și apare eroarea 50004, aceasta nu reflectă rezultatul real al cererii către interfață. Cererea poate avea succes sau poate eșua. Te rugăm să te bazezi pe rezultatul efectiv.

Ce înseamnă eroarea „50119 API key doesn’t exist”?

Această eroare apare de obicei când domeniul contului tău nu corespunde regiunii tale.

• Pentru utilizatorii EEA, te rugăm să schimbi numele de domeniu al cererii API în eea.okx.com în loc de www.okx.com.

• Pentru utilizatorii din SUA, te rugăm să schimbi numele de domeniu al cererii API în us.okx.com în loc de www.okx.com.

• Dacă folosești un software terț pentru a te conecta la OKX și vezi această eroare, te rugăm să verifici cu furnizorul software-ului dacă acesta suportă domenii regionale. De exemplu, utilizatorii din SEE trebuie să se conecteze prin eea.okx.com, altfel cererea va eșua.

De ce apare eroarea „50110” când mă conectez la un software terț?

Această eroare poate apărea dacă tipul curent de cheie API nu este compatibil cu legarea software-ului terț. Încearcă să aplici pentru tipul de tranzacție cheie API, fără a lega o listă de IP-uri, apoi reconectează software-ul terț.

Cum pot obține cel mai recent preț al unei anumite perechi de monede?

Folosește detalii aici pentru simboluri bursiere și pentru simbol bursier, peste aici. Interfața simbolurilor bursiere este folosită pentru a obține în loturi cel mai recent preț de tranzacționare al perechilor de monede, iar simbolul bursier este folosit pentru a obține cel mai recent preț de tranzacționare al perechilor individuale de monede.

Exemplu de parametru de răspuns pentru cel mai recent preț tranzacționat în secțiunea Tickers

Care sunt cerințele pentru a crea o cheie API?

Este necesar un sold minim de Active Gestionate (AUM) de 100 USD pentru a crea o cheie API.

• Este necesar un AUM mai mare de 100 USD (AUM > 100U) pentru a crea o cheie API

• Pentru conturile master sau subconturi, doar conturile cu AUM > 100U au permisiunea de a crea chei API

Notă: Această cerință se aplică doar utilizatorilor din anumite zone

Notă:

Dacă ai întrebări despre WebSocket sau alte subiecte legate de API, dă click pe linkul articolului și scanează Codul QR de la finalul articolului folosind aplicația OKX pentru a te alătura grupului și a lua legătura cu specialistul nostru în suport API.

Cum să scanezi: în aplicație, apasă pe Meniu > pictograma Scanare și scanează Codul QR.