L’API di Hyperliquid: guida 2026 per bot e trader quantitativi

L’API di Hyperliquid è l’interfaccia pubblica e programmatica dell’exchange di perpetui Hyperliquid. Poiché Hyperliquid è un DEX interamente on-chain, tutto ciò che puoi fare attraverso la schermata di trading — leggere i prezzi, inviare ordini, gestire posizioni — lo puoi fare anche da codice firmando e inviando richieste. Questo rende bot, strategie quantitative e dashboard personalizzate un caso d’uso di prima classe anziché un espediente (Hyperliquid Docs — API (Info, Exchange & WebSocket)).

Per le richieste l’API è semplice JSON su HTTP, con un WebSocket separato per lo streaming, quindi è raggiungibile da qualsiasi linguaggio. Per gli sviluppatori Python esiste un SDK ufficiale che racchiude l’intero sistema. Questa guida illustra le tre superfici, come funziona l’autenticazione tramite agent wallet, l’SDK e i rate limit, e come iniziare.

L’API è organizzata in tre superfici, ciascuna con un compito ben preciso (Hyperliquid Docs — API (Info, Exchange & WebSocket)):

• Endpoint Info (lettura). Restituisce metadati di mercato, order book, candele, funding, le tue posizioni aperte, i saldi e le esecuzioni storiche. La maggior parte delle richieste Info non necessita di firma — sono il modo in cui un bot osserva il mondo prima di decidere qualsiasi cosa.
• Endpoint Exchange (trading). Dove avvengono i cambiamenti di stato: inviare, modificare e annullare ordini, impostare leva e modalità di margine, e spostare fondi all’interno del tuo account. Ogni richiesta Exchange deve essere firmata crittograficamente dal tuo wallet o da un agent wallet autorizzato.
• WebSocket (tempo reale). Sottoscrivi flussi in tempo reale di prezzi, order book, trade e aggiornamenti dell’account così che un bot possa reagire istantaneamente invece di fare polling. Per qualsiasi cosa sensibile alla latenza, il WebSocket è la superficie attorno a cui costruire.

Un ciclo tipico è il seguente: leggere lo stato da Info (o da una sottoscrizione WebSocket), applicare la logica della strategia, poi agire attraverso l’endpoint Exchange. Questo ciclo Info-decidi-Exchange è la spina dorsale di quasi ogni bot di trading Hyperliquid.

L’elemento che rende il trading via API su Hyperliquid davvero sicuro è l’ agent wallet (chiamato anche API wallet). Invece di consegnare al tuo bot la tua chiave privata principale, autorizzi una chiave separata che può inviare e annullare ordini ma non può prelevare o trasferire i tuoi fondi (Hyperliquid Docs — API (Info, Exchange & WebSocket)).

• Resta non custodiale. I tuoi USDC e le tue posizioni rimangono nel tuo account Hyperliquid. La chiave agent firma le azioni di trading su di essi; non li detiene mai.
• La compromissione è contenuta. Una chiave agent trapelata permette a un attaccante di fare trading sul tuo account ma non di svuotarlo — un raggio d’azione molto più ridotto rispetto a una chiave API di exchange centralizzato trapelata con diritti di prelievo.
• Ci sono limiti su quanti puoi averne. Un account può approvare un numero limitato di agent wallet, e le approvazioni possono scadere — verifica i numeri attuali nella documentazione (Hyperliquid Docs — Rate limits and user limits).

Il modo più rapido per iniziare è l’SDK Python ufficiale open-source di Hyperliquid, che racchiude le superfici Info, Exchange e WebSocket, gestisce la firma delle richieste e include script di esempio per attività comuni come inviare un ordine o sottoscrivere un feed (Hyperliquid — official Python SDK (GitHub)). È un livello di comodità — sotto il cofano è la stessa API JSON/HTTP che potresti chiamare da JavaScript, Rust o Go.

I bot in produzione devono rispettare i rate limit. Hyperliquid documenta sia limiti di richieste per IP sia limiti basati sull’indirizzo che scalano con la tua attività di trading, oltre a costi ponderati che fanno “costare” di più le richieste più pesanti (Hyperliquid Docs — Rate limits and user limits). Le implicazioni pratiche:

• Preferisci il WebSocket al polling. Sottoscrivere un flusso è molto più economico che martellare l’endpoint Info in un ciclo.
• Raggruppa e applica il backoff. Riunisci le richieste dove l’API lo consente, e aggiungi un backoff esponenziale così che un picco non ti faccia limitare.
• Verifica i numeri esatti. I limiti cambiano nel tempo, quindi leggili dalla pagina ufficiale sui rate limit al momento della costruzione anziché fidarti di un blog secondario (Hyperliquid Docs — Rate limits and user limits).

Un primo percorso realistico, da zero a un bot live e in auto-custodia:

1. Finanzia un account Hyperliquid. Ti servono USDC on-chain nel tuo wallet sull’exchange — questo è l’account che l’API leggerà e su cui farà trading.
2. Approva un agent wallet. Genera e autorizza una chiave API/agent così che il tuo codice possa firmare richieste Exchange senza mai detenere diritti di prelievo.
3. Leggi con Info / WebSocket. Inizia recuperando dati di mercato e le tue posizioni — senza denaro a rischio — finché il flusso di dati non è solido.
4. Invia ordini di test via Exchange. Usa piccole dimensioni (o ordini limite post-only / lontani dal mid) per confermare che firma, esecuzioni e annullamenti funzionino come previsto.
5. Aggiungi controlli del rischio prima di scalare. Tetti sulle posizioni, leva massima, kill-switch e limiti di drawdown devono essere nel codice fin dal primo giorno, non dopo la prima brutta giornata.

Da lì, la parte difficile è la strategia — non l’infrastruttura. Vedi il trading algoritmico nelle crypto per le famiglie di strategie (market making, arbitraggio, grid, trend, mean reversion) e il quant trading nelle crypto per il flusso di lavoro dalla ricerca al live che trasforma un’idea in qualcosa che valga la pena eseguire. Per il panorama dei bot dall’inizio alla fine, vedi i bot di trading crypto.

L’API di Hyperliquid offre ai costruttori una superficie di trading completa e non custodiale: un endpoint Info per leggere, un endpoint Exchange per fare trading, un WebSocket per i dati in tempo reale, agent wallet che fanno trading ma non prelevano mai, un SDK Python ufficiale e rate limit documentati. È questa combinazione a rendere pratici i bot in auto-custodia e le strategie quantitative su Hyperliquid.

Contenuto solo a scopo educativo — non è consulenza di investimento. Il trading automatizzato comporta rischi e i bot possono perdere denaro; le performance passate o da backtest non predicono i risultati futuri. Endpoint API, rate limit, limiti sugli agent wallet e requisiti dell’SDK cambiano — verifica tutto nella documentazione ufficiale di Hyperliquid prima di costruire o fare trading. Facts verified 2026-06-30.