Come diventare broker WEEX: candidatura, configurazione API e lancio

Per diventare broker WEEX, invia il modulo di onboarding disponibile nella pagina broker di WEEX, supera una verifica di due diligence e ricevi un ID broker nel formato WEEX seguito da sei cifre. A quel punto il lavoro diventa tecnico: collega gli utenti tramite OAuth o le loro chiavi API, anteponi l'ID broker a ogni ordine e riconcilia le commissioni tramite gli endpoint di rebate. WEEX indica un giorno lavorativo per l'approvazione e da quattro a cinque giorni lavorativi per il lancio. Le sezioni seguenti seguono questa sequenza, elencano cosa preparare e trattano le misure di sicurezza necessarie quando si custodiscono le chiavi di altre persone. Le informazioni sono aggiornate al 7 ottobre 2026.

Chi può candidarsi e cosa richiede WEEX

Possono candidarsi privati, team e aziende, senza necessità di effettuare un deposito. Le FAQ nella pagina WEEX Broker indicano team quant, istituti finanziari e KOL di community tra i candidati benvenuti e descrivono la verifica come una procedura standard di due diligence.

Il modulo è la parte più semplice. La registrazione OAuth che segue richiede ulteriori informazioni: raccoglierle in anticipo fa risparmiare giorni:

• Nome della piattaforma, in inglese
• Il WEEX UID da collegare all'identità broker
• URL dell'informativa sulla privacy e dei termini di servizio
• Logo della piattaforma
• Una persona di contatto e un indirizzo email
• Uno o più URL di callback
• Gli indirizzi IP pubblici da cui i server inviano le richieste

Ci sono due aspetti che colgono i team alla sprovvista. Prima di candidarti devi avere un account WEEX, perché il UID fa parte della registrazione. Inoltre, l'informativa sulla privacy e i termini devono essere disponibili su pagine attive.

Tempistiche della candidatura a WEEX Broker: dal modulo all'ID broker

1. Invia il modulo. Il pulsante «Candidati ora» nella pagina broker lo apre.
2. Attendi la verifica. La pagina broker promette un contatto entro 24 ore e un'«approvazione in 1 giorno lavorativo». L'introduzione all'API Broker afferma che il team di sviluppo commerciale effettua la verifica entro tre giorni lavorativi. Pianifica considerando la tempistica più lunga.
3. Ricevi l'email di approvazione. Contiene un ID broker come WEEX123456, la configurazione iniziale dell'aliquota commissionale e l'accesso a un gruppo di assistenza tecnica.
4. Ottieni le credenziali OAuth. Dopo che WEEX registra i tuoi URL di callback e indirizzi IP, ricevi un clientId e una chiave segreta.
5. Integra e lancia. L'annuncio di WEEX del 07/2026 pianifica l'integrazione tecnica tra il secondo e il quarto giorno e il lancio al quinto giorno.

In pratica, il calendario dipende meno dalla verifica di WEEX che dalla rapidità con cui il tuo team riesce a fornire URL di callback stabili e IP pubblici fissi.

Collegare gli utenti: il flusso OAuth di WEEX in sette passaggi

OAuth consente all'utente di autorizzare la tua piattaforma su una pagina di WEEX e restituisce al tuo backend una chiave API pronta all'uso. La guida all'integrazione OAuth definisce il flusso come segue.

1. Nel backend, genera un valore state monouso da 22 a 128 caratteri e un code_verifier PKCE di almeno 43. Calcola la challenge come Base64URL(SHA256(code_verifier)). S256 è l'unico metodo accettato.
2. Reindirizza l'utente a https://www.weex.com/it/oauth con il tuo clientId, responseType=code, scope=create:apikey, lo state, il tuo redirectUri e la code challenge.
3. L'utente esamina e approva su WEEX.
4. WEEX reindirizza alla tua callback con code e state. Verifica che lo state corrisponda a quello che hai generato.
5. Dal backend, invia una richiesta POST a https://gateway.weex.com/v1/oauth/token con il code, redirectUri e code verifier. La richiesta include gli header Client-Id, Sign, Timestamp e Nonce; Sign è l'HMAC-SHA256 codificato in Base64 di timestamp, nonce, metodo, path e body, con la chiave client secret.
6. Ricevi un access token valido per 3,600 secondi e un refresh token valido per 36,000 secondi. Il rinnovo invalida l'access token precedente.
7. Invia una richiesta POST a https://gateway.weex.com/v1/oauth/resource/create-api con il bearer token. La risposta contiene apiKey, secret e passphrase dell'utente e li restituisce una sola volta.

Tre vincoli influenzano la progettazione. Un utente può avere una sola chiave API collegata a una determinata piattaforma di terze parti; un secondo tentativo restituisce l'errore 81001, «api key already bound». Le richieste provenienti da indirizzi IP non registrati vengono bloccate. Inoltre, se lo stato API dell'utente non è normale, la nuova chiave potrebbe non funzionare immediatamente, quindi la tua interfaccia deve prevedere uno stato di attesa.

OAuth è facoltativo. Una piattaforma può accettare chiavi create dagli utenti e inserite manualmente. L'etichettatura degli ordini descritta di seguito è obbligatoria in entrambi i casi.

Etichettare gli ordini e verificare l'idoneità alle commissioni

Ogni ordine deve includere all'inizio del proprio client order ID il tuo ID broker: newClientOrderId deve iniziare con b-{brokerId}, come in b-WEEX123456-20260319001. La regola si applica a spot e futures.

È facile non notare due dettagli. Nell'endpoint per gli ordini spot il client order ID è facoltativo e, se lo ometti, WEEX ne assegna uno. Un ordine inviato in questo modo non ha il prefisso broker, quindi inserisci il campo in ogni richiesta. Inoltre, i limiti di lunghezza sono in conflitto: l'introduzione Broker consente 64 caratteri, mentre l'endpoint per gli ordini futures indica da 1 a 36. Il prefisso b-WEEX123456- occupa 13 caratteri. Progettare il resto dell'ID per rientrare nei 23 rimanenti è compatibile con entrambe le indicazioni.

Usa quindi i tre endpoint della API di rebate Broker:

• Idoneità. GET /api/v3/apiReferral/checkUserEligibility accetta un WEEX UID e restituisce se l'utente è idoneo, una motivazione e l'indicazione se l'account è già collegato a un altro codice referral. Chiamalo quando un utente effettua il collegamento, salva il risultato ed escludi gli utenti non idonei dalle previsioni delle commissioni.
• Aliquote. GET /api/v3/apiReferral/rebateRatio restituisce il tuo livello (BRONZE, SILVER o GOLD) e sei rapporti: spot e futures per gli invitati diretti, per gli utenti senza codice referral e per i referral «Invita amici».
• Registrazioni. GET /api/v3/apiReferral/rebate/recentRecord restituisce le registrazioni delle commissioni per simbolo e valuta della commissione, per SPOT come impostazione predefinita o per FUTURES. L'intervallo massimo di ricerca è 90 giorni e la dimensione massima della pagina è 100.

Le registrazioni sono restituite per simbolo e periodo di regolamento, con campi relativi a importo scambiato, commissione, detrazione della commissione, aliquota di rebate e commissione. Non includono un ID utente né un ID ordine. Per suddividere le commissioni per utente, ad esempio per condividere i ricavi con gli autori di strategie, conserva un tuo registro degli ordini indicizzato per client order ID. La pagina broker afferma che le commissioni vengono regolate ogni giorno.

Sicurezza delle chiavi API per i broker: custodire le chiavi di altre persone

Quando il primo utente collega un account, il tuo database contiene credenziali che permettono di effettuare operazioni con denaro reale. La documentazione di WEEX stabilisce i requisiti minimi, ma un broker scrupoloso va oltre.

• Conserva i segreti nel backend. La guida OAuth specifica che il client secret, il code verifier e la secret key e passphrase di ogni utente non devono mai comparire nel codice frontend. Le FAQ broker aggiungono che chiavi, secret e passphrase non devono mai essere trasmessi nei parametri URL. Dopo la callback, reindirizza a una pagina pulita e fai in modo che il frontend recuperi uno stato.
• Cripta le chiavi archiviate e mascherale nei log. Un log di debug che contiene un secret completo è il modo più comune in cui le chiavi vengono sottratte anche da sistemi altrimenti sicuri.
• Imposta IP pubblici fissi. WEEX blocca le richieste provenienti da indirizzi non registrati. Cambiare regione cloud o aggiungere un proxy senza aggiornare la registrazione disconnette tutti gli utenti contemporaneamente.
• Prevedi la restituzione una tantum. Se la scrittura nello storage non riesce dopo il buon esito di create-api, il secret è perso e l'utente deve eliminare la chiave e collegarsi di nuovo. Rendi transazionale questo passaggio.
• Richiedi solo le autorizzazioni strettamente necessarie. Nel percorso tramite sottoconto, qualsiasi chiave con autorizzazioni oltre la sola lettura richiede una allowlist IP con un massimo di 10 voci. Richiedi TRANSFER o WITHDRAW solo se il prodotto sposta fondi.
• Rispetta i limiti. Le chiamate REST condividono un limite di 500 unità di peso ogni 10 secondi. Rallenta le richieste in caso di HTTP 429 e invia un avviso in caso di picchi di errori di autorizzazione, che potrebbero indicare che qualcuno sta testando una credenziale trapelata.

Checklist pre-lancio prima del primo utente reale

• Esegui il flusso completo su un account di test: collegamento, idoneità con esito positivo, esecuzione di un ordine etichettato e comparsa dell'operazione nella registrazione delle commissioni dopo il regolamento successivo.
• Verifica il tuo livello e i rapporti tramite l'endpoint delle aliquote, invece di dare per scontato il valore pubblicizzato.
• Testa il formato del client order ID sia per spot sia per futures.
• Ripeti l'invio di un vecchio valore state e di un codice di autorizzazione già utilizzato. Entrambi dovrebbero essere rifiutati.
• Prova a inviare una richiesta da un IP non registrato. Dovrebbe essere bloccata.
• Usa gli endpoint demo nel percorso /sim/, descritti nelle FAQ dell'API futures di WEEX, per testare la logica degli ordini senza fondi reali.
• Prepara il manuale operativo per l'assistenza. La documentazione di WEEX indica support@weex.com e una community Telegram; inoltre, l'approvazione dà accesso a un gruppo di assistenza tecnica.

Per diventare broker WEEX bastano un modulo e una breve verifica. Per diventare un broker che riceve correttamente i pagamenti servono un'etichettatura rigorosa degli ordini, una verifica dell'idoneità per ogni utente e un processo di riconciliazione giornaliero. La candidatura inizia dalla pagina WEEX Broker.

FAQ

1. Quanto tempo richiede l'approvazione come broker WEEX?

La pagina broker di WEEX promette un contatto entro 24 ore e l'approvazione in un giorno lavorativo. La documentazione API afferma che il team di sviluppo commerciale esamina le candidature entro tre giorni lavorativi. L'integrazione tecnica richiede poi circa quattro o cinque giorni lavorativi, secondo l'annuncio di WEEX del 07/2026.

2. Diventare broker WEEX ha un costo?

No. La pagina broker specifica che non è richiesto alcun deposito e che l'iscrizione non comporta costi. I candidati vengono sottoposti a una procedura standard di due diligence e i broker approvati ottengono gratuitamente l'accesso al backend broker e alla dashboard dei dati.

3. Come si presenta un ID broker WEEX?

È la parola WEEX seguita da sei cifre, ad esempio WEEX123456, e arriva nell'email di approvazione. Il client order ID di ogni ordine inviato dalla piattaforma deve iniziare con b- seguito da tale ID.

4. È possibile integrare una piattaforma con WEEX Broker senza OAuth?

Sì. Gli utenti possono creare chiavi API su WEEX e inserirle manualmente nella piattaforma. OAuth elimina questo passaggio manuale; l'etichettatura degli ordini e gli endpoint delle commissioni funzionano allo stesso modo in entrambi i casi.