Configurazione della chiave API WEEX: come collegare in sicurezza una piattaforma di terze parti

Per collegare una piattaforma di terze parti a WEEX, crea una chiave API WEEX da Account, quindi Gestione API, concedile solo le autorizzazioni necessarie alla piattaforma e inserisci la chiave API, la chiave segreta e la passphrase nella piattaforma. Se la piattaforma è un broker WEEX registrato, il pulsante "Accedi con WEEX" può svolgere la stessa funzione senza che tu debba gestire una chiave. Questa guida illustra entrambe le procedure, come effettuare un primo ordine in sicurezza, gli errori più comuni e le impostazioni di sicurezza che determinano i danni che può causare una chiave compromessa. Le procedure e i limiti sono aggiornati al 7 ottobre 2026.

Connessione rapida o chiave API WEEX manuale: quale procedura scegliere

Usa Connessione rapida quando la piattaforma la offre e una chiave manuale in tutti gli altri casi.

Connessione rapida è l'autorizzazione OAuth di WEEX, annunciata il 3 agosto 2026. Fai clic su "Accedi con WEEX" nella piattaforma partner, raggiungi la pagina di autorizzazione WEEX, controlli le autorizzazioni (le opzioni trading e sola lettura sono preselezionate) e confermi. WEEX genera quindi una chiave API e la invia al backend della piattaforma. Non la visualizzi né la copi. WEEX afferma che la procedura richiede meno di 10 secondi.

Ci sono due aspetti a cui prestare attenzione. La pagina di autorizzazione si trova su www.weex.com, quindi controlla la barra degli indirizzi prima di approvare qualsiasi operazione. Inoltre, le regole OAuth di WEEX consentono una sola chiave per utente per ciascuna piattaforma di terze parti: per collegare di nuovo la stessa piattaforma, devi prima eliminare la vecchia chiave.

Una chiave manuale funziona con qualsiasi software compatibile con WEEX, inclusi gli strumenti che non sono broker, e ti offre il pieno controllo sulle autorizzazioni e sul vincolo IP.

Come creare una chiave API WEEX: procedura dettagliata

1. Accedi a WEEX dal web. Vai su Account, quindi Gestione API e seleziona Crea chiave API. La pagina API WEEX contiene un pulsante Crea API che apre la stessa schermata.
2. Assegna alla chiave il nome della piattaforma a cui è destinata.
3. Imposta una passphrase composta solo da lettere e numeri. Le FAQ di WEEX indicano che i caratteri speciali non sono accettati. In seguito non sarà possibile recuperare o modificare la passphrase.
4. Scegli le autorizzazioni. Per impostazione predefinita, le nuove chiavi sono di sola lettura. Aggiungi Spot o Futures solo se la piattaforma effettuerà operazioni su quel mercato. Le due autorizzazioni di trading sono indipendenti: un bot Futures non ha bisogno dell'accesso a Spot.
5. Associa gli indirizzi IP se la piattaforma pubblica gli indirizzi da cui si connette.
6. Completa la verifica di sicurezza.
7. Copia la chiave API, la chiave segreta e la passphrase e conservale in un luogo sicuro. Le guide alla configurazione di HaasOnline e KoinX avvertono entrambe che la chiave segreta viene mostrata una sola volta.

È utile conoscere tre limiti. Secondo la guida all'integrazione di WEEX, ogni account può creare fino a 10 gruppi di chiavi API. Una chiave nuova o modificata impiega circa 15 minuti per diventare attiva ovunque. Inoltre, la guida di KoinX afferma che WEEX potrebbe richiedere un questionario di attivazione API e inviare un'email di conferma prima che la chiave funzioni; quindi, se una chiave non funziona nelle prime ore, non significa necessariamente che sia stata configurata in modo errato.

Associare la chiave ed effettuare il primo ordine

Le piattaforme usano etichette diverse per i tre valori. HaasOnline, che ha aggiunto WEEX il 22 agosto 2026, è un esempio tipico: apri Account di exchange, seleziona WEEX Spot o Futures, inserisci la chiave API come chiave pubblica e la chiave segreta come chiave privata, aggiungi la passphrase e premi il pulsante di verifica della chiave. "Chiave di accesso" e "chiave pubblica" indicano entrambe la chiave API.

Prima di avviare una strategia, effettua manualmente un ordine tramite la piattaforma:

1. Scegli una coppia liquida e inserisci la quantità minima consentita dalla piattaforma, come ordine limite a un prezzo ben lontano da quello corrente.
2. Verifica che l'ordine compaia tra gli ordini aperti direttamente su WEEX.
3. Annullalo dalla piattaforma e controlla che scompaia anche da WEEX.

Questo test di andata e ritorno verifica che la chiave, l'autorizzazione e la mappatura della coppia funzionino, senza costi.

Quando qualcosa non funziona, di solito la causa è una di queste:

• Errore -1052, autorizzazioni insufficienti. Alla chiave manca l'autorizzazione Futures oppure la coppia non è supportata.
• Errori di autorizzazione con una chiave appena creata. Attendi 15 minuti.
• HTTP 429. La piattaforma sta inviando troppe richieste. Il limite REST di WEEX è di 500 unità di peso ogni 10 secondi per IP.
• Errori di firma o passphrase. Uno dei tre valori è stato incollato con un carattere mancante o uno spazio di troppo.
• Richieste rifiutate con il vincolo IP attivo. La piattaforma si connette da un indirizzo che non compare nel tuo elenco.

Le FAQ sull'API Futures di WEEX riportano tutti i codici.

Sicurezza della chiave API WEEX: sei impostazioni per limitare i danni

Una chiave di trading non può prelevare fondi, ma può comunque causare perdite. Su qualsiasi exchange, il tipo di abuso noto consiste nell'usare una chiave rubata con sole autorizzazioni di trading per acquistare un token illiquido a prezzi gonfiati da un account controllato dall'aggressore. Queste sei abitudini riducono il rischio.

1. Concedi solo le autorizzazioni strettamente necessarie. Gli strumenti per le tasse e la gestione del portafoglio hanno bisogno della sola lettura. KoinX richiede esattamente questa autorizzazione. Una chiave di sola lettura non può effettuare ordini.
2. Associa gli IP ogni volta che la piattaforma lo consente. La documentazione di WEEX afferma che le chiavi senza vincolo IP "comportano rischi per la sicurezza". Alcuni servizi non possono funzionare con un elenco fisso. KoinX consiglia agli utenti di lasciare disattivata la restrizione IP. Se una piattaforma richiede una chiave senza restrizioni, mantienila di sola lettura.
3. Usa una chiave per ogni piattaforma. Con un massimo di 10 gruppi di chiavi, non c'è motivo di condividerle. Una chiave separata ti permette di disattivare un servizio senza interrompere gli altri e di capire quale chiave è stata compromessa.
4. Considera la passphrase un terzo segreto. Non includerla in screenshot, messaggi di chat o ticket di assistenza. Le indicazioni di WEEX sono chiare: "Non condividere mai la tua passphrase".
5. Rifiuta richieste di autorizzazioni oltre a quelle di trading. Le guide all'integrazione indicano Sola lettura, Spot e Futures come autorizzazioni disponibili per le chiavi che crei. Una piattaforma che ti chiede la password di accesso a WEEX o l'accesso ai prelievi richiede qualcosa che non serve per fare trading.
6. In caso di dubbio, elimina la chiave. WEEX raccomanda di eliminare immediatamente una chiave compromessa. Fai lo stesso con qualsiasi piattaforma che hai smesso di usare.

Come scollegare una piattaforma da WEEX

Rimuovi la chiave dalla piattaforma, quindi eliminala nella Gestione API di WEEX. È il secondo passaggio a fare la differenza: una chiave rimossa solo dalle impostazioni della piattaforma continua a funzionare per chiunque ne abbia una copia.

La stessa regola si applica alle chiavi create tramite Connessione rapida. La guida OAuth di WEEX afferma che la chiave esistente deve essere eliminata prima di poter collegare di nuovo l'account a quella piattaforma.

Collegare una piattaforma a WEEX richiede pochi minuti e le decisioni prese in quel momento determinano il livello di rischio per tutto il tempo in cui la chiave rimane attiva: quali autorizzazioni concedere, quali IP associare e se la chiave verrà eliminata quando non serve più. Le chiavi si creano e si gestiscono dalla pagina API WEEX.

FAQ

1. Quante chiavi API posso creare su WEEX?

Fino a 10 gruppi di chiavi API per account, secondo la guida all'integrazione di WEEX. Sono sufficienti per assegnare una chiave distinta a ogni piattaforma collegata e revocare l'accesso a un servizio senza influire sugli altri.

2. Posso reimpostare una passphrase API WEEX smarrita?

No. La documentazione di WEEX indica che una passphrase smarrita non può essere recuperata né modificata. Elimina la chiave, creane una nuova con una nuova passphrase e aggiorna la piattaforma che la utilizzava.

3. Perché la mia nuova chiave API WEEX restituisce un errore di autorizzazione?

Le tre cause più comuni sono un'autorizzazione di trading mancante, una coppia non coperta dal mercato della chiave e i tempi di attivazione. WEEX afferma che le chiavi nuove o modificate impiegano circa 15 minuti per diventare attive: prima di cambiare le impostazioni, riprova dopo aver atteso.

4. WEEX supporta connessioni TradingView o FIX?

Le FAQ sull'API Futures di WEEX indicano che l'integrazione di TradingView e l'API FIX non sono supportate. Le connessioni utilizzano le interfacce REST e WebSocket, direttamente oppure tramite una piattaforma che le ha integrate.