Domande frequenti sull'API di OKX
A cosa si riferisce la Passphrase?
Questa è la password che hai inserito quando hai richiesto la Chiave API. Devi ricordarla personalmente. Una volta dimenticata, non potrai recuperarla e dovrai creare una nuova Chiave API.
Come posso creare una Chiave API?
Sull'app:
1. Accedi al tuo Conto OKX > Seleziona Menu (⋮⋮⋮) > Scorri verso il basso e seleziona API > Crea Chiave API
2. Compila il nome API > Seleziona il conto e lo scopo > Inserisci la lista bianca degli indirizzi IP > Seleziona i permessi > Inserisci la parola chiave
Sul Web:
1. Accedi al tuo Conto OKX > Vai al tuo Profilo e seleziona API e connessioni > Crea Chiave API
2. Compila il nome della Chiave API > Seleziona il conto e Utilizzato per
3. Inserisci la lista bianca degli indirizzi IP > Seleziona Permessi > Inserisci la Parafrasi
Nota:
Gli indirizzi IP aiutano a proteggere la tua Chiave API. Puoi collegare fino a 20 indirizzi per chiave, separandoli con una virgola o uno spazio.
È necessario visualizzare le informazioni API e accedere alla sua interfaccia. Ti preghiamo di mantenere la password al sicuro. Puoi creare una nuova API se perdi la password, poiché non possiamo recuperare le API.
Come gestisco o modifico la Chiave API?
Per gestire o modificare la tua Chiave API su OKX:
Accedi al tuo Conto OKX e vai su Profilo > API.
Vedrai un elenco delle tue chiavi API esistenti. Clicca su quella che vuoi gestire.
Da qui puoi:
Visualizza il nome della Chiave API, le autorizzazioni e la whitelist IP collegata.
Modifica il nome della chiave, le autorizzazioni (Lettura, Operazione, preleva) o gli indirizzi IP associati.
Elimina la chiave se non è più necessaria.
Nota: Non puoi visualizzare la Passphrase dopo la creazione iniziale. Se la perdi, dovrai eliminare la chiave esistente e crearne una nuova. Conserva sempre le tue credenziali in modo sicuro.
Come faccio a distinguere tra spot o margin trading se opero tramite API?
Il modo in cui spot e margin trading sono differenziati tramite l'API può variare a seconda del tipo di conto e delle impostazioni. Si consiglia di fare riferimento alla documentazione API di OKX per i parametri più accurati e aggiornati applicabili alla configurazione del proprio conto.
Se hai bisogno di ulteriori chiarimenti, contatta Assistente OKX per una guida personalizzata.
Come posso creare una chiave API demo disk?
Per operare sull'API del demo disk, devi creare una Chiave API sul demo disk. Segui i passaggi seguenti:
Accedi al tuo Conto OKX > Trading > trading demo > Centro personale > Crea Chiave API conto demo > Inizia il trading demo
La Chiave API scadrà?
Le chiavi API non vincolate a un IP e con permessi di transazione o prelievo saranno automaticamente eliminate dopo 14 giorni di inattività. Le chiavi API non saranno considerate inattive se vengono utilizzate per chiamare interfacce private o relative al conto che richiedono la verifica dell'identità, come la visualizzazione del saldo del conto, i dati di fatturazione o l'inserimento di ordini.
Solo le chiavi API in sola lettura vincolate a un IP o a permessi specifici non scadranno.
Cosa sono le autorizzazioni per prestito, guadagna e trasferimento?
Trasferimento: Consente alla chiave di effettuare trasferimenti di fondi tra i tuoi account. Disponibile per tutti gli account.
Prestito: Consente alla chiave di prendere in prestito, rimborsare e gestire i prestiti. Visibile solo se il tuo conto ha i requisiti necessari per questa funzione.
Guadagna: Consente alla chiave di sottoscrivere e riscattare i prodotti guadagna. Visibile solo se il tuo conto ha i requisiti di idoneità necessari.
Se la tua API Key aveva precedentemente abilitato i permessi di Operazione, tutti e tre i permessi saranno attivati automaticamente con questo aggiornamento. Non è necessaria alcuna configurazione manuale.
È possibile effettuare ordini in unità di valuta quando si piazzano ordini tramite l'interfaccia?
No; per gli ordini di contratti, l'interfaccia predefinisce gli ordini in numero di contratti. Se hai bisogno di calcolare la conversione tra il numero di contratti e le criptovalute, puoi fare riferimento all'interfaccia di conversione da contratti a criptovalute qui.
Come ottenere il tasso di fluttuazione dell'interfaccia?
L'interfaccia non può ottenere direttamente l'aumento o la diminuzione del prezzo, ma può essere calcolata tramite una formula di calcolo.
L'aumento e la diminuzione del valore dell'ultimo prezzo di transazione rispetto al prezzo di apertura della candela K di 24 ore fa / 100% del prezzo di apertura della candela K di 24 ore fa.
I dati della formula sopra possono essere ottenuti tramite l'interfaccia di mercato qui.
Qual è la causa del messaggio di errore "51000 Parameter posSide error" durante l'inserimento di un ordine?
Devi prima controllare la modalità conto; modalità acquisto e vendita/modalità apertura e chiusura, che può essere visualizzata qui per ottenere posMode.
Nota:
Nel caso di apertura e chiusura di posizioni e di inserimento di ordini utilizzando un contratto, il parametro posSide è obbligatorio e deve essere compilato con long o posizione in short.
Se si tratta di una modalità di acquisto e vendita, o di una transazione di criptovaluta o con leva effettuata in modalità apertura e chiusura, posSide supporta solo net o nessuna trasmissione.
Quale interfaccia può essere utilizzata per ottenere il valore nominale del contratto e la quantità minima dell'Ordine?
Puoi utilizzare l'interfaccia per ottenere informazioni di base sui prodotti di trading qui.
valore nominale del contratto: ctVal, quantità minima dell'Ordine: minSz.
Qual è il formato di instId?
Puoi utilizzare direttamente l'interfaccia per ottenere le informazioni di base sui prodotti di trading qui.
Come impostare stop loss e take-profit?
Se l'ordine è collegato a take-profit stop loss, puoi fare riferimento all'interfaccia dell'ordine qui: parametri dell'array attachAlgoOrds.
Tuttavia, se si tratta di uno stop loss ordine separato, puoi fare riferimento all'interfaccia della commissione strategia qui.
Perché viene segnalato un errore quando si imposta il prezzo di attivazione per take-profit e stop loss: 51046, 51047, 51048, 51049?
Regole per impostare il prezzo di attivazione dello stop-loss/prezzo di attivazione del take-profit: durante la vendita, il prezzo di attivazione del take-profit è superiore all'ultimo prezzo di transazione, mentre il prezzo di attivazione dello stop-loss è inferiore all'ultimo prezzo di transazione; durante l'acquisto, il prezzo di attivazione del take-profit è inferiore all'ultimo prezzo di transazione, mentre il prezzo di attivazione dello stop-loss è superiore all'ultimo prezzo di transazione.
Che cos'è l'"Errore interfaccia: 50102 Richiesta timestamp scaduta"?
Questo errore si verifica quando il timestamp è scaduto. È necessario chiamare l'interfaccia dell'ora di sistema qui per sincronizzare l'ora locale con quella del nostro server. Mantenere la differenza di orario entro 30 secondi può aiutare a evitare questo problema.
Nota: l'orario nell'intestazione della richiesta è in UTC0. Quando si chiama l'interfaccia dell'orario del server, l'orario è fornito in UTC + 8.
Cosa significa "Errore interfaccia: 50101 APIKey non corrisponde all'ambiente attuale"?
Ciò è dovuto alla discrepanza tra la chiave API e l'ambiente attuale. Le chiamate da conto reale richiedono l'uso della chiave API del conto reale, e il valore del parametro x-simulated-trading nell'intestazione della richiesta deve essere 0. Le chiamate da conto simulato richiedono l'uso della chiave API del conto simulato, e il valore del parametro x-simulated-trading nell'intestazione della richiesta deve essere 1.
Cosa significa "Errore interfaccia: 51010 Richiesta non supportata nella modalità conto attuale"?
Questo è relativo alla tua modalità conto. Se vuoi impostare una leva o un contratto su una singola valuta, devi passare a una delle altre tre modalità, esclusa la modalità spot! Puoi configurarlo tramite le impostazioni dell'interfaccia qui, oppure puoi impostarlo sul web o sull'app.
Nota: la prima impostazione deve essere configurata nella pagina o nell'app; opzione impostazioni nel menu principale della pagina di trading - modalità conto.
Cosa significa "Errore interfaccia: 51121 La quantità dell'ordine deve essere un multiplo della dimensione del lotto"?
Nell'API, gli ordini di contratto sono espressi in unità di contratti e devono essere un multiplo della quantità minima d'ordine della coppia di valute. La quantità minima d'ordine può essere ottenuta tramite il campo minSz dell'interfaccia prodotto qui.
"Errore di prelievo: 58207 L'indirizzo di prelievo non è presente nella lista bianca per l'esenzione dalla verifica"; perché la verifica della lista bianca continua a segnalare un errore anche quando è disattivata nella pagina di prelievo?
Per prelevare monete utilizzando l'interfaccia API, è necessario aggiungere un indirizzo di prelievo nella pagina e selezionare il pulsante non verificato da Visa. Se la verifica della lista bianca è disattivata nella pagina, ciò non influirà sulla funzione dell'interfaccia.
Cosa significa "Interface error: 50004 API endpoint request timeout" (non indica che la richiesta sia stata completata con successo o fallita, controlla il risultato della richiesta)?
Il codice 50004 è solitamente causato da un eccessivo carico sul server. Le 8, 16 e 24 sono i momenti della giornata in cui vengono raccolte le commissioni sul capitale. In questi orari, la pressione sul server è elevata. Si consiglia di distribuire le transazioni in modo da evitare questi orari. Se un errore 50004 si verifica in altri momenti, è possibile riprovare più tardi. Se un ordine viene effettuato con un errore 50004, ciò non rappresenta il risultato effettivo della richiesta all'interfaccia. La richiesta potrebbe aver avuto successo o essere fallita. Si prega di fare riferimento al risultato effettivo.
Che cos'è l'errore "50119 API key doesn't exist"?
Questo errore si verifica solitamente quando il dominio del tuo conto non corrisponde alla tua regione.
Per gli utenti EEA, modifica il nome di dominio della tua richiesta API in eea.okx.com invece di www.okx.com.
Per gli utenti statunitensi, modifica il nome di dominio della tua richiesta API in us.okx.com invece di www.okx.com.
Se stai utilizzando un software di terze parti per connetterti a OKX e visualizzi questo errore, verifica con il fornitore del software se supporta i domini regionali. Ad esempio, gli utenti dell'EEA devono connettersi tramite eea.okx.com, altrimenti la richiesta fallirà.
Perché viene mostrato l'errore "50110" durante il collegamento a un software di terze parti?
Questo errore può verificarsi se il tipo di API key attuale non è compatibile con il collegamento del software di terze parti. Prova a richiedere il tipo di transazione API key, senza associare una lista IP, e poi riconnetti il software di terze parti.
Come posso ottenere l'ultimo prezzo di transazione di una certa coppia di valute?
Usa i dettagli qui per i Ticker e per il Ticker, qui. L'interfaccia Ticker viene utilizzata per ottenere in batch l'ultimo prezzo di transazione delle coppie di valute, mentre il Ticker serve per ottenere l'ultimo prezzo di transazione delle singole coppie di valute.
Esempio del parametro di risposta dell'ultimo prezzo contrattato nella sezione Ticker
Quali sono i requisiti per creare una Chiave API?
Per creare una Chiave API è richiesto un saldo minimo di Assets Under Management (AUM) di 100 USD.
È richiesto un AUM superiore a 100 USD (AUM > 100U) per creare una Chiave API
Per account master o sub-account, solo gli account con AUM > 100U possono creare chiavi API
Nota: Questo requisito si applica solo agli utenti in alcune aree
Cosa devo fare se WebSocket non riesce a connettersi o si disconnette continuamente?
Conferma di utilizzare l'URL WebSocket corretto per il tuo sito e il servizio API. Controlla la tua rete, il proxy, le impostazioni TLS, i parametri di sottoscrizione, il battito Ping/Pong e la logica di riconnessione. Se il problema persiste, fornisci il canale, l'orario dell'occorrenza, il messaggio di errore completo e i log oscurati.
Come devo risolvere un codice di errore API o un parametro di richiesta non valido?
Cerca il codice di errore nella documentazione ufficiale API del tuo sito, quindi verifica l'endpoint, il metodo HTTP, i parametri della richiesta, la modalità conto e le restrizioni del prodotto. Se la causa non è ancora chiara, fornisci il codice di errore completo, sCode/sMsg, l'orario di occorrenza e la richiesta e risposta oscurate.
Perché il mio ordine API di inserimento, modifica o cancellazione è fallito?
Utilizza il messaggio di errore e il codice di errore restituiti dall'API per determinare la causa specifica. Se non sei sicuro del significato dell'errore, fornisci i parametri completi della richiesta e i dettagli dell'errore in modo che possiamo indagare ulteriormente.
Cosa devo fare se i dati di mercato, i grafici a candela o i dati dell'order book sembrano errati?
Conferma il nome del canale, instId, i parametri di sottoscrizione e la frequenza delle richieste, e distingui i dati snapshot dagli aggiornamenti incrementali. Per gli order book, verifica anche gli ID di sequenza e i timestamp. Se i dati sembrano mancanti, registra il canale, l'intervallo di tempo e la risposta raw oscurata.
Perché i saldi API, le posizioni o i valori del margine differiscono da quelli del sito web o dell'app?
Prima distingui tra conto di trading e conto di finanziamento, quindi verifica la modalità conto, la dimensione della valuta, l'endpoint e l'orario di aggiornamento dei dati. Per i calcoli di saldo, posizione e margine, utilizza la documentazione più recente del prodotto e dell'API per il sito applicabile.
Cosa devo fare se un deposito, prelievo o trasferimento tramite API fallisce?
Controlla le autorizzazioni API, la valuta, la rete, il conto di destinazione e eventuali requisiti di rubrica o whitelist, quindi risolvi i problemi utilizzando il codice di errore restituito. Restrizioni relative alla sicurezza del conto, conformità o rischio potrebbero richiedere una revisione ulteriore da parte del supporto per il sito applicabile.
Come posso creare e utilizzare una Chiave API per un conto secondario?
Crea la Chiave API sotto il conto secondario previsto e utilizza le autorizzazioni, la Passphrase e il dominio del sito di quel conto secondario. Non mescolare la Chiave API, il Segreto o la Passphrase del conto principale con quelli del conto secondario.
Cosa devo fare dopo aver raggiunto il limite di velocità API?
Riduci la frequenza delle richieste in base al limite per il specifico endpoint e utilizza code di richieste, backoff esponenziale o endpoint batch quando appropriato. L'ambito e la quota del rate-limit possono variare a seconda dell'endpoint, quindi non presumere che tutti gli endpoint condividano la stessa disponibilità.
Dove posso trovare la documentazione API, gli SDK e gli esempi di codice?
Puoi fare riferimento a API Docs (V5). Riferimento REST + WebSocket, changelog, codici di errore, esempi di richiesta/risposta per endpoint. SDK ufficiali (GitHub) — github.com/okxapi Esempi di codice sono disponibili nell'SDK.
Quali informazioni dovrei fornire se posso solo dire "l'API non funziona"?
Fornisci l'endpoint, il metodo HTTP, l'operazione prevista, il codice di errore completo o il messaggio, il momento dell'occorrenza, il sito del conto, l'ambiente di rete e la richiesta e risposta oscurate. Non inviare mai un API Secret, Passphrase, codice di verifica o firma non oscurata.
Cosa devo fare se ho ancora domande sull'API? Posso parlare con l'assistenza API?
Se hai ulteriori domande, sei il benvenuto a unirti al nostro gruppo di supporto API:
Nota:
Se hai domande su WebSocket o altri argomenti relativi all'API, clicca sul link dell'articolo e scansiona il Codice QR in fondo all'articolo usando l'app OKX per unirti al gruppo e contattare il nostro specialista di supporto API.
Come scansionare: nell'app, tocca Menu > l'icona Scansiona e scansiona il Codice QR.