Documentazione dell'endpoint RPC di Hyperliquid | ERPC
Documentazione dell'endpoint RPC di Hyperliquid
Usa ERPC come tuo endpoint RPC di Hyperliquid per richieste HTTP JSON-RPC. Hyperliquid RPC fa parte delle RPC APIs di ERPC all'interno della nostra Global Edge Blockchain Infrastructure, e la chiave API può essere gestita dalla ERPC Web Dashboard.
Puoi usare la stessa chiave RPC di Solana, Ethereum e Avalanche.
Passa la tua chiave API nel parametro di query
api-key, oppure inviala come Authorization: Bearer <YOUR_API_KEY>. Se sono presenti entrambi, viene usato il parametro di query.Endpoint
Invia richieste JSON-RPC 2.0 come HTTP POST a:
text
https://edge.erpc.global/hyperliquid?api-key=<YOUR_API_KEY>https://edge.erpc.global/hyperliquid?api-key=<YOUR_API_KEY>oppure all'host dedicato:
text
https://hyperliquid.erpc.global?api-key=<YOUR_API_KEY>https://hyperliquid.erpc.global?api-key=<YOUR_API_KEY>Sull'host dedicato,
/ e /evm raggiungono lo stesso endpoint, e anche /nanoreth è accettato. Su edge.erpc.global, gli stessi percorsi seguono il prefisso /hyperliquid: /hyperliquid, /hyperliquid/evm e /hyperliquid/nanoreth. Gli altri percorsi ricevono una risposta HTTP 400.Esempi
Ecco un esempio di richiesta HTTP con la chiave API nel parametro di query.
bash
curl 'https://edge.erpc.global/hyperliquid?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'curl 'https://edge.erpc.global/hyperliquid?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'Ecco la stessa richiesta con la chiave API nell'header
Authorization.bash
curl 'https://edge.erpc.global/hyperliquid' --header 'Content-Type: application/json' --header 'Authorization: Bearer <YOUR_API_KEY>' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'curl 'https://edge.erpc.global/hyperliquid' --header 'Content-Type: application/json' --header 'Authorization: Bearer <YOUR_API_KEY>' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'Puoi ottenere e verificare la tua chiave API sulla ERPC Web Dashboard: ERPC Web Dashboard
Richieste in batch
Sono supportati batch JSON-RPC da 1 a 100 chiamate per 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. Il corpo della richiesta può arrivare a 1 MiB.Utilizzo dei token
L'utilizzo viene misurato in token, e la tariffa in token può variare in base al metodo. Ogni chiamata in un batch HTTP viene misurata separatamente.
Limiti del piano Free
Con il piano Free, il tuo account può inviare una richiesta ogni 10 secondi. Il limite viene conteggiato per account, non per endpoint, quindi anche una richiesta a un'altra chain può rientrare nel conteggio. Una richiesta inviata prima riceve una risposta HTTP
429, e l'header retry-after indica l'attesa in secondi.Con il piano Free, una richiesta che contiene due o più chiamate JSON-RPC riceve una risposta HTTP
429, e nessuna delle sue chiamate viene inviata: ogni chiamata riceve un errore JSON-RPC con codice -32041. Invia invece queste chiamate una alla volta.Metodi supportati
L'endpoint serve questi 38 metodi, raggruppati per namespace.
net_*(3):net_listening,net_peerCount,net_versionweb3_*(2):web3_clientVersion,web3_sha3eth_*(24):eth_blockNumber,eth_call,eth_chainId,eth_estimateGas,eth_feeHistory,eth_gasPrice,eth_getBalance,eth_getBlockByHash,eth_getBlockByNumber,eth_getBlockReceipts,eth_getBlockTransactionCountByHash,eth_getBlockTransactionCountByNumber,eth_getCode,eth_getLogs,eth_getProof,eth_getStorageAt,eth_getTransactionByBlockHashAndIndex,eth_getTransactionByBlockNumberAndIndex,eth_getTransactionByHash,eth_getTransactionCount,eth_getTransactionReceipt,eth_maxPriorityFeePerGas,eth_sendRawTransaction,eth_syncingdebug_*(4):debug_traceBlockByHash,debug_traceBlockByNumber,debug_traceCall,debug_traceTransactiontrace_*(2):trace_block,trace_transactionhl_*(3):hl_getBlock,hl_getLatestBlockNumber,hl_portfolioState
Un metodo o un percorso non elencato riceve una risposta HTTP
400.Codici di stato della risposta
| Stato HTTP | Significato |
|---|---|
| 200 | Risposta JSON-RPC upstream. Anche un errore JSON-RPC viene restituito con HTTP 200: mantiene l'id della richiesta e l'error.code, il suo error.message è ERPC upstream error, e error.data non viene restituito. |
| 400 | Un metodo o un percorso al di fuori dell'elenco dei metodi supportati, una richiesta JSON-RPC non valida, un batch vuoto o con più di 100 chiamate, un id duplicato in un batch, o un corpo superiore a 1 MiB. |
| 401 | Chiave API mancante o non valida, oppure non è soddisfatta una restrizione di IP o di Origin impostata sulla chiave. |
| 405 | Un metodo di richiesta diverso da POST. |
| 426 | È stato richiesto un WebSocket Upgrade. L'endpoint supporta solo HTTP. |
| 429 | Rate limitato, compresi i limiti del piano Free indicati sopra: più di una richiesta ogni 10 secondi, oppure due o più chiamate in una richiesta. Se è presente un header retry-after, attendi il numero di secondi indicato. |
| 502 | La richiesta upstream non è stata completata: una risposta upstream non riuscita, una risposta superiore a 8 MiB, o nessuna risposta entro 30 secondi. |
| 503 | Il servizio è temporaneamente non disponibile. |
Metodi RPC di Hyperliquid e documentazione
Per l'elenco completo dei metodi standard, dei parametri e delle specifiche, consulta la documentazione ufficiale.