Collegare Hyperliquid

Hyperliquid è un exchange on-chain: accedi con un wallet crypto o con un’email, e il tuo account è legato a un indirizzo di wallet. Bybot fa trading sul tuo account Hyperliquid tramite un API Wallet, una chiave separata che può piazzare e annullare ordini per il tuo wallet. Il tuo denaro resta sul tuo account Hyperliquid e l’API Wallet non può prelevare né trasferire fondi. La configurazione richiede circa 10 minuti.

In Bybot aggiungi due cose: l’indirizzo del tuo wallet principale e la chiave privata dell’API Wallet. Non incollare mai la chiave privata o la seed phrase del tuo wallet principale: a Bybot non serve e la rifiuta.

1. Accedi a Hyperliquid

Apri app.hyperliquid.xyz e fai clic su “Connect”. Accedi con un wallet crypto o con un’email. Se usi un wallet, fai poi clic su “Enable Trading” e firma la richiesta nel wallet: non costa gas.

2. Deposita USDC

Fai clic su “Deposit”, scegli USDC on Arbitrum e segui le istruzioni sullo schermo.

3. Rendi gli USDC disponibili per lo spot

Bybot fa trading sul mercato spot di Hyperliquid. Fai una delle due cose:

• passa il tuo account a “Unified account”: così un unico saldo USDC serve sia per lo spot sia per i perpetual e non serve nessun trasferimento;
• oppure, nella modalità standard, trasferisci USDC da “Perps” a “Spot”: in questa modalità i depositi arrivano sul saldo Perps.

La modalità “Portfolio margin” non è supportata: in questa modalità Hyperliquid prende in prestito automaticamente quando il saldo non basta, quindi il bot potrebbe comprare a credito. Bybot non lavora con un account di questo tipo.

4. Apri la pagina API

Nel menu in alto apri “More” e scegli “API”.

5. Crea un API Wallet con un nome

1. Inserisci un nome per l’API Wallet, ad esempio bybot, e fai clic su “Generate”.
2. Fai clic su “Authorize API Wallet”.

3. Nella finestra “Authorize API Wallet” fai clic su “MAX” nel campo “Days Valid”: l’API Wallet funzionerà per il periodo massimo, fino a 180 giorni.
4. Copia la Private Key con il pulsante di copia e conservala in un posto sicuro.
5. Fai clic su “Authorize”. Se hai effettuato l’accesso con un wallet, conferma nel wallet.

6. Copia l’indirizzo del tuo wallet

Fai clic sul pulsante del tuo account in alto a destra e copia l’indirizzo con il pulsante di copia. È l’indirizzo del tuo wallet principale, quello che serve a Bybot. Non usare l’indirizzo dell’API Wallet del passaggio 5.

7. Aggiungi la chiave in Bybot

In Bybot apri Impostazioni (“Settings”) → Chiavi API (“API Keys”) e fai clic su Aggiungi chiave (“Add key”). Scegli HYPERLIQUID e compila due campi:

Fai clic su Salva (“Save”). Bybot verifica la chiave tramite i dati pubblici di Hyperliquid: l’API Wallet deve appartenere a questo wallet e avere un nome, e la modalità dell’account deve essere supportata.

8. Verifica la chiave

Nell’elenco delle chiavi fai clic su ”⋯” sulla scheda di Hyperliquid e scegli Verifica chiave (“Check key”). Bybot conferma che l’API Wallet è ancora collegato al tuo wallet. La colonna Scadenza dell’API Wallet (“API Wallet expiry”) mostra quando scade.

9. Prima di creare un bot

• Bybot fa trading su 6 coppie contro USDC: BTC, ETH, SOL, ZEC, HYPE e NEAR. Su Hyperliquid BTC, ETH, SOL e ZEC sono crypto wrapped da Unit (UBTC, UETH, USOL, UZEC); NEAR si scambia come token ONEAR.
• Su Hyperliquid puoi far funzionare un bot DCA per coppia.
• L’ordine minimo è di 10 USDC.

Poi segui la guida Creare un bot.

Durata dell’API Wallet

Scegli per quanto tempo funziona l’API Wallet quando lo crei, fino a 180 giorni. Bybot te lo ricorda prima della scadenza. Quando scade, il bot smette di fare trading. Per continuare, crea su Hyperliquid un nuovo API Wallet con un nome, poi elimina la vecchia chiave in Bybot e aggiungi quella nuova.

Limite di azioni di Hyperliquid

Hyperliquid limita il numero di azioni (piazzare e annullare ordini) per wallet: 10,000 all’inizio, più 1 azione per ogni $1 di volume di trading sul wallet. Quando il limite si esaurisce, il trading non si ferma ma rallenta.

Bybot non può acquistare azioni extra: Hyperliquid accetta questo acquisto solo con la firma del tuo wallet principale e lo addebita al wallet principale. Se il limite si esaurisce, aspetta che il tuo volume di trading cresca oppure acquista tu stesso azioni extra dal tuo wallet principale.

Commissioni e residui

• La commissione spot di Hyperliquid è dello 0.07% per gli ordini taker e dello 0.04% per gli ordini maker al livello base.
• In un acquisto la commissione viene trattenuta nella crypto che compri (per BTC in UBTC), in una vendita in USDC. Per questo ricevi un po’ meno crypto di quante ne hai comprate.
• Un residuo di valore inferiore all’ordine minimo di 10 USDC non può essere venduto e resta sull’account come dust.

Trading manuale sullo stesso wallet

Non fare trading manuale su una coppia su cui lavora il bot. Hyperliquid non permette a un wallet di fare trading con se stesso: quando il tuo ordine manuale incontra l’ordine del bot, Hyperliquid annulla l’ordine che era già nel book, spesso quello del bot. Il bot lo vede come un annullamento.

Sicurezza della chiave

• I prelievi sono impossibili. Un API Wallet può piazzare e annullare ordini, ma non può prelevare né trasferire fondi: Hyperliquid rifiuta queste richieste anche se la chiave viene esposta.
• Non incollare mai la chiave privata o la seed phrase del tuo wallet principale. A Bybot serve solo la chiave dell’API Wallet e non ti chiederà mai la tua seed phrase.
• Usa un wallet separato per il bot. L’API Wallet può fare trading su tutto il tuo account Hyperliquid, perpetual compresi.
• Un wallet, un account Bybot. Un indirizzo di wallet può essere collegato a un solo account Bybot.
• Se smetti di usare il bot, ferma i tuoi bot Hyperliquid, elimina la chiave in Bybot e poi revoca l’API Wallet su app.hyperliquid.xyz → “API”. Finché non lo revochi, l’API Wallet può ancora fare trading sul tuo account.

Problemi comuni

“Hyperliquid did not confirm the key” (Hyperliquid non ha confermato la chiave). Controlla l’indirizzo del wallet e la chiave privata dell’API Wallet, e che l’API Wallet non sia scaduto.

“This is your main wallet private key” (questa è la chiave privata del tuo wallet principale). Hai incollato la chiave del wallet principale. Crea un API Wallet con un nome (passaggio 5) e incolla la sua chiave privata.

“The API Wallet must be a named one” (l’API Wallet deve avere un nome). Crea un API Wallet con un nome nella pagina API e incolla la sua chiave.

“This Hyperliquid account mode is not supported” (questa modalità dell’account Hyperliquid non è supportata). L’account è in Portfolio margin. Passa a Unified account o alla modalità standard.

“This Hyperliquid wallet is already connected to another account” (questo wallet Hyperliquid è già collegato a un altro account). Un wallet può essere collegato a un solo account Bybot.

Non riesco a eliminare la chiave. Prima ferma i tuoi bot Hyperliquid, poi elimina la chiave.

Il bot non compra anche se hai depositato USDC. Nella modalità standard il deposito arriva sul saldo Perps. Trasferisci gli USDC su Spot o passa a Unified account.

Il bot è diventato lento. Il wallet potrebbe aver esaurito il limite di azioni di Hyperliquid; vedi «Limite di azioni di Hyperliquid» più sopra.

Documentazione ufficiale dell’exchange: Hyperliquid Docs.