Annuncio di Aggiornamento dell'API Margine di KuCoin

Cari Utenti KuCoin,

Per fornire agli utenti un ambiente di trading migliore e ottimizzare l'esperienza di trading, l'API Margine di KuCoin è in fase di migrazione e aggiornamento ad alta frequenza.Questa migrazione sarà effettuata in più fasi e si prevede che sarà completata entro la fine del 2025.

1. Ambito della Migrazione:

Per gli utenti che hanno attivato il Margine, se non ci sono posizioni o asset Margine durante la migrazione, non ci sarà alcun impatto.

2. Impatto della Migrazione:

2.1 Utenti Non-API (Utenti finali - C-end)

• L'esperienza utente su Web/App rimarrà invariata prima e dopo la migrazione.

2.2 Utenti API

• Questa migrazione avrà un certo impatto sul metodo di chiamata dell'interfaccia API e sulla visualizzazione dello stato degli asset. La migrazione sarà notificata in più fasi. Si prega di eseguire le operazioni corrispondenti in tempo dopo aver ricevuto la notifica via email. Il sistema effettuerà la migrazione 7 giorni dopo l'invio dell'email. (Per ridurre l'impatto, è possibile passare in anticipo all'API ad alta frequenza).

3. Processo di Migrazione:

Passo 1: Pulizia manuale degli ordini a bassa frequenza

a. Gli utenti devono cancellare autonomamente gli ordini effettuati tramite API a bassa frequenza e C-end (Web/App);

b. Gli ordini ad alta frequenza non necessitano di essere cancellati;

• Se non si procede attivamente alla cancellazione, il sistema forzerà la cancellazione dell'ordine durante il processo di migrazione (inclusi ordini ordinari e avanzati).

• Se non si conferma lo stato dell'ordine, si prega di contattare il servizio clienti per consultazioni.

Passo 2: Trasferimento manuale degli asset a bassa frequenza (utenti API)

a. Gli utenti devono trasferire manualmente gli asset degli account a bassa frequenza agli account ad alta frequenza e passare alla nuova interfaccia API (vedere api-doc per i dettagli).

b.Ottieni Quote di Trasferimento - KUCOIN APIAl momento, gli asset nel C-end (Web e App) vengono visualizzati come "FROZEN" e non è possibile eseguire ordini ad alta frequenza.

Passaggio 3: Avvia la migrazione

*I Passaggi 1 e 2 non sono obbligatori, ma una volta eseguita la migrazione, il sistema annullerà automaticamente gli ordini a bassa frequenza e trasferirà gli asset a bassa frequenza agli account ad alta frequenza.

Note Importanti:

1. Indisponibilità temporanea dell’account (sia per gli utenti C-end che per gli utenti API);

Durante l'esecuzione della migrazione, gli account degli utenti saranno temporaneamente non disponibili per 2-3 minuti, coinvolgendo le funzioni di consultazione degli asset, trading e trasferimento. Si prega di organizzare le operazioni in anticipo per evitare impatti sulle transazioni.

2. Cancellazione forzata degli ordini a bassa frequenza;

Se l'utente non cancella l'ordine a bassa frequenza in anticipo, il sistema annullerà forzatamente gli ordini ordinari non eseguiti a bassa frequenza e gli ordini avanzati durante il processo di migrazione.

3. Gli asset vengono visualizzati come "frozen" per un breve periodo;

Durante la fase di preparazione alla migrazione, gli asset ad alta frequenza potrebbero essere visualizzati come "frozen" nella vecchia interfaccia, ma torneranno alla normalità una volta completata la migrazione.

4. Suggerimenti per la compatibilità dell’interfaccia;

La vecchia interfaccia non supporterà più le query relative agli account ad alta frequenza. Assicurati di completare il passaggio in anticipo, altrimenti potrebbe essere restituita un'eccezione.

5. La migrazione ufficiale avverrà 7 giorni dopo la notifica via email;

La migrazione ufficiale inizierà 7 giorni dopo l'invio della notifica via email. Si consiglia agli utenti di monitorare attentamente la propria casella di posta e di completare tutte le preparazioni necessarie prima della data di migrazione, per assicurare una transizione fluida e prevenire interruzioni del servizio.

Contenuto Dettagliato della Migrazione:

Consultazione degli Asset

• Raccomandiamo di utilizzare la nuova interfaccia API per la consultazione degli asset:

  • Consultazione degli asset dell’account cross margin: /api/v3/margin/accounts

  • Consultazione degli asset dell’account isolated margin: /api/v3/isolated/accounts

• Dopo la migrazione, i dati degli asset prima e dopo la migrazione rimarranno coerenti. Una volta completata la migrazione, sia margin, margin_v2, che TUTTE le query restituiranno risultati coerenti (analogamente per gli account isolati).

Nota: Le vecchie interfacce di interrogazione degli asset (/api/v1/margin/account per il cross-margin e /v1/isolated/accounts per il margine isolato) rimarranno disponibili dopo la migrazione, ma gli asset ad alta frequenza verranno mostrati come "Congelati" per gli utenti che non hanno ancora effettuato la migrazione.

Interrogazioni del Registro Transazioni

1. Interfaccia V1: /api/v1/accounts/ledgers

• È possibile interrogare il registro per gli account ad alta e bassa frequenza sia prima che dopo la migrazione, con lo stesso intervallo di tempo precedente.

2. Interfaccia V3: /api/v3/hf/margin/account/ledgers

• Supporta solo l'interrogazione delle transazioni degli account ad alta frequenza, con un intervallo di tempo limitato agli ultimi tre giorni.

Gli utenti possono scegliere l'interfaccia in base alle proprie esigenze.

Trasferimenti

• L'interfaccia di trasferimento rimane invariata. La precedente interfaccia può ancora essere utilizzata per i trasferimenti tra account ad alta e bassa frequenza.

  • Prima della Migrazione: Sono supportati i trasferimenti tra account ad alta e bassa frequenza appartenenti allo stesso utente.

  • Dopo la Migrazione: margin e margin_v2 saranno trattati come lo stesso account, e i trasferimenti tra questi due account non saranno più supportati (allo stesso modo per il margine isolato).

Interrogazioni sugli Ordini Storici

1. Interfaccia V1: /api/v1/orders?status=done

• È possibile interrogare gli ordini storici per ordini ad alta e bassa frequenza, con lo stesso intervallo di tempo.

2. Interfaccia V3: /api/v3/hf/margin/orders/done

• Supporta solo l'interrogazione degli ordini ad alta frequenza e può restituire dati solo per gli ultimi tre giorni. Gli utenti possono scegliere in base alle loro esigenze.

Posizionamento di Ordini/Annullamento di Ordini/Interrogazione di Ordini Attivi

1. Interfaccia V1: Supporta il posizionamento, l'annullamento e l'interrogazione di ordini attivi a bassa frequenza.

2. Interfaccia V3: Supporta il posizionamento, l'annullamento e l'interrogazione di ordini attivi ad alta frequenza.

Gli ordini ad alta e bassa frequenza non sono compatibili tra loro, incluse le funzioni di take-profit e stop-loss. Gli utenti devono utilizzare l'interfaccia corrispondente in base al tipo di ordine.

Modifiche alle Interfacce per la Migrazione:

• Nota: Si consiglia di chiarire in anticipo le modifiche alle interfacce coinvolte prima e dopo la migrazione per evitare problemi nell'utilizzo.

Avviso sul rischio

Il trading con margine si riferisce alla pratica di prendere in prestito fondi con un capitale relativamente basso per negoziare asset finanziari e ottenere maggiori profitti. Tuttavia, a causa dei rischi di mercato, delle fluttuazioni di prezzo e di altri fattori, si raccomanda fortemente di essere prudenti nelle proprie azioni d'investimento, adottare un livello di leva adeguato per il trading con margine e bloccare opportunamente le perdite in modo tempestivo.  KuCoin  non si assume alcuna responsabilità per eventuali perdite derivanti dal trading.

Grazie per il vostro supporto!

Il Team KuCoin

Trova la prossima Crypto Gem su KuCoin!

Registrati su KuCoin adesso! >>>

Scarica l'App KuCoin >>>

Seguici su X (Twitter ) >>>

Unisciti a noi su Telegram >>>

Unisciti alle Community Globali di KuCoin >>>

Dichiarazione di non responsabilità: Per comodità, questa pagina è stata tradotta utilizzando la tecnologia AI (alimentata da GPT). Fare riferimento alla versione originale in inglese per informazioni più accurate.