Hyperliquid RPC - Guida rapida

Hyperliquid RPC - Guida rapida

Questa guida ti accompagna da zero alla tua prima risposta Hyperliquid JSON-RPC con ERPC.

1. Ottieni la tua chiave API

Puoi ottenere e verificare la tua chiave API sulla ERPC Web Dashboard: ERPC Web Dashboard
Usi già ERPC per Solana, Ethereum o Avalanche? Puoi usare la stessa chiave RPC.

2. Effettua la tua prima richiesta

Invia una richiesta JSON-RPC 2.0 come HTTP POST, con la tua chiave API nel parametro api-key:
bash
curl 'https://edge.erpc.global/hyperliquid/evm?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_blockNumber"
}'
La risposta restituisce l'ultimo numero di blocco in esadecimale:
json
{ "jsonrpc": "2.0", "id": 1, "result": "0x..." }
Questa richiesta va a /hyperliquid/evm. Il percorso /hyperliquid da solo equivale a /hyperliquid/evm, e anche /hyperliquid/nanoreth è accettato.
Con il piano Free, il tuo account può inviare una richiesta ogni 10 secondi, e anche una richiesta a un'altra chain può rientrare in questo limite. Attendi 10 secondi prima di inviare la richiesta successiva.
Puoi verificare quale chain serve l'endpoint con eth_chainId:
bash
curl 'https://edge.erpc.global/hyperliquid/evm?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_chainId"
}'
Puoi anche inviare la tua chiave API come Authorization: Bearer <YOUR_API_KEY>. Se sono presenti entrambi, viene usato il parametro di query.

3. Richieste in batch

Puoi inviare da 1 a 100 chiamate JSON-RPC in un'unica richiesta HTTP. Ogni chiamata deve avere un proprio id, e i valori di id non devono ripetersi all'interno di un batch. Ogni chiamata in un batch viene misurata come chiamata a sé stante. Con il piano Free, invia una chiamata per richiesta: una richiesta con due o più chiamate riceve una risposta HTTP 429.

Prossimi passi