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 creo 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 parafrasi
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 Autorizzazioni > 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 e 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 l'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.
Quali 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 di idoneità per questa funzione.
Guadagna: Consente alla chiave di sottoscrivere e riscattare i prodotti guadagna. Visibile solo se il tuo conto ha i requisiti necessari per questa funzione.
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 puoi visualizzare 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 viene 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'ultima transazione, mentre il prezzo di attivazione dello stop-loss è inferiore all'ultima transazione; durante l'acquisto, il prezzo di attivazione del take-profit è inferiore all'ultima transazione, mentre il prezzo di attivazione dello stop-loss è superiore all'ultima transazione.
Cosa significa "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.
Che 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 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. Il fatto che la verifica della lista bianca sia disattivata nella pagina non influenzerà la funzione dell'interfaccia.
Cosa significa "Errore interfaccia: timeout della richiesta all'endpoint API 50004" (non indica se la richiesta è andata a buon fine 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 di solito 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 è utilizzata per ottenere in batch il prezzo dell'ultima transazione delle coppie di valute, mentre il ticker è usato per ottenere il prezzo dell'ultima transazione di singole coppie di valute.
Esempio del parametro di risposta dell'ultimo prezzo contrattato nella sezione Tickers
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
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.