Hyper Agentic Trader
Scarica

Si può automatizzare Hyperliquid?

Sì, con l'interfaccia documentata della piattaforma stessa, non girandoci attorno. Le letture non chiedono chiavi, le scritture chiedono una firma, e un conto può approvare un wallet di API perché produca quelle firme al posto della propria chiave.

Ultimo aggiornamento: 16 ott 2026

Sì, con l'API pubblica

Sì: Hyperliquid pubblica tutta la sua interfaccia di trading come un'API HTTP pubblica, la stessa che usa l'interfaccia web. Le letture non chiedono chiavi, le scritture chiedono un'azione firmata, e un conto può approvare un wallet di API perché le firmi al posto della propria chiave.

A che serveDove
Letture: prezzi medi, book L2, candele, storico del funding, stato di un conto. Nessuna chiave, nessuna firma.POST https://api.hyperliquid.xyz/info
Scritture: order, cancel, modify, updateLeverage, approveAgent, withdraw3 e le altre, ognuna firmata.POST https://api.hyperliquid.xyz/exchange
Flussi in diretta (allMids, l2Book, trades, candle, userFills), e un'alternativa all'invio via HTTP.wss://api.hyperliquid.xyz/ws
Gli stessi tre percorsi sulla piattaforma di prova.api.hyperliquid-testnet.xyz

Contano tre indirizzi, qui sotto, e ogni cifra di questa pagina è quella della documentazione al 5 ottobre 2026.

Gli SDK che la documentazione elenca

Non devi montare azioni firmate a mano. La documentazione nomina un SDK Python ufficiale, hyperliquid-dex/hyperliquid-python-sdk, un SDK Rust della comunità, due SDK TypeScript della comunità (nktkas/hyperliquid e nomeida/hyperliquid) e CCXT.

La firma è la parte che vale la pena prendere in prestito invece che riscrivere. Un'azione viene serializzata e firmata in una forma esatta, e una forma sbagliata di un solo campo viene rifiutata: l'ordine non arriva mai al book.

Wallet di API e nonce

Un conto principale può approvare wallet di API perché firmino a nome del conto principale o di uno qualsiasi dei suoi sottoconti. Firmano soltanto: per interrogare i dati di un conto devi passare l'indirizzo vero di quel conto, e usare il wallet di agente dà un risultato vuoto.

I nonce sono più severi di quanto sembrino. Hyperliquid tiene i 100 nonce più alti per indirizzo, e una nuova azione ha bisogno di un nonce maggiore del più piccolo di quell'insieme, mai usato prima, e dentro una finestra da T meno 2 giorni a T più 1 giorno, dove T è l'ora del blocco in millisecondi unix.

A un agente cancellato si possono rigiocare i nonce

Un wallet di API viene potato quando si registra un nuovo wallet senza nome, quando un nuovo wallet con nome prende un nome esistente, quando scade, o quando il conto che lo ha registrato non ha più fondi. La documentazione avverte che a un agente cancellato si può potare lo stato dei nonce, così le azioni firmate prima possono essere rigiocate: genera un nuovo wallet di agente invece di far rivivere uno vecchio.

I limiti di richieste, come sono documentati

  • Per IP. Le richieste REST condividono un limite di peso aggregato di 1.200 al minuto. Un'azione di scambio pesa 1 + floor(batch_length / 40), così un lotto è quasi gratis; la maggior parte delle richieste di informazione pesa 20, una manciata pesa 2, e userRole pesa 60.
  • Per indirizzo. 1 richiesta per ogni 1 USDC scambiato in modo cumulativo, dopo una riserva iniziale di 10.000 richieste, poi una richiesta ogni 10 secondi. Gli annullamenti hanno una dotazione più larga.
  • Websocket. Al massimo 10 connessioni, 30 nuove connessioni al minuto, 1.000 sottoscrizioni, 2.000 messaggi inviati al minuto e 100 messaggi post simultanei in volo.
  • Ordini aperti. Un limite di default di 1.000, più uno in più per ogni 5 M di USDC di volume, con un tetto totale di 5.000.

Il limite per indirizzo sorprende un programma nuovo: la sua dotazione si guadagna operando, e un ciclo che riprova alla cieca la spende per niente.

Uno script, un bot, un assistente

Che cos'èChi decideChe cosa ti chiede
Uno scriptTu, quando l'hai scritto. Percorre una sequenza e non sceglie nulla.Di rileggerlo prima di lanciarlo. I suoi limiti sono le righe che hai scritto.
Un botUna regola che hai scritto, ogni volta che le sue condizioni sono soddisfatte, non guardato.Limiti fuori dalla regola, e un modo di fermarlo con un solo comando.
Un assistente (un agente di IA)Un modello propone; il codice verifica la proposta contro delle cifre.Limiti che non può allargare, e una chiave che non può prelevare.

L'API non può sapere quale dei tre la sta chiamando, e applica le stesse regole a tutti e tre. Si distinguono per dove viene presa la decisione e per quello che succede quando è sbagliata: uno script che sbaglia sbaglia una volta, un bot tutta la notte.

Locker Protocol Agentic è del terzo tipo: lpa per una persona o un agente di IA, un server MCP con gli stessi comandi come strumenti, una policy locale verificata due volte prima di qualunque ordine, e un mandato firmato dal tuo stesso wallet. Non promette alcun risultato.

Da leggere dopo