Documentação do Hyperliquid RPC endpoint | ERPC
Documentação do Hyperliquid RPC endpoint
Use a ERPC como seu Hyperliquid RPC endpoint para requisições HTTP JSON-RPC. O Hyperliquid RPC faz parte das RPC APIs da ERPC dentro da nossa Global Edge Blockchain Infrastructure, e a API key pode ser gerenciada no ERPC Web Dashboard.
Você pode usar a mesma RPC key da Solana, do Ethereum e da Avalanche.
Passe sua API key no parâmetro de query
api-key ou envie-a como Authorization: Bearer <YOUR_API_KEY>. Quando os dois estão presentes, o parâmetro de query é usado.Endpoints
Envie requisições JSON-RPC 2.0 como HTTP POST para:
text
https://edge.erpc.global/hyperliquid?api-key=<YOUR_API_KEY>https://edge.erpc.global/hyperliquid?api-key=<YOUR_API_KEY>ou para o host dedicado:
text
https://hyperliquid.erpc.global?api-key=<YOUR_API_KEY>https://hyperliquid.erpc.global?api-key=<YOUR_API_KEY>No host dedicado,
/ e /evm levam ao mesmo endpoint, e /nanoreth também é aceito. Em edge.erpc.global, os mesmos caminhos seguem o prefixo /hyperliquid: /hyperliquid, /hyperliquid/evm e /hyperliquid/nanoreth. Outros caminhos são respondidos com HTTP 400.Exemplos
Aqui está um exemplo de requisição HTTP com a API key no parâmetro de 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"
}'Aqui está a mesma requisição com a API key no cabeçalho
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"
}'Você pode obter e verificar sua API key no ERPC Web Dashboard: ERPC Web Dashboard
Requisições em lote
Lotes de JSON-RPC com 1 a 100 chamadas por requisição HTTP são suportados. Cada chamada precisa do seu próprio
id, e os valores de id não podem se repetir dentro de um lote. Cada chamada em um lote é medida como uma chamada individual. O corpo da requisição pode ter até 1 MiB.Medição de uso
O uso é medido em tokens, e a taxa de tokens pode variar conforme o método. Cada chamada em um lote HTTP é medida separadamente.
Limites do Plano Free
No Plano Free, sua conta pode enviar uma requisição a cada 10 segundos. O limite é contado por conta, e não por endpoint, então uma requisição a outra chain também pode contar para ele. Uma requisição enviada antes disso é respondida com HTTP
429, e o cabeçalho retry-after informa a espera em segundos.No Plano Free, uma requisição que contém duas ou mais chamadas JSON-RPC é respondida com HTTP
429, e nenhuma de suas chamadas é enviada: cada chamada recebe um erro JSON-RPC com o código -32041. Envie essas chamadas uma de cada vez.Métodos suportados
O endpoint atende estes 38 métodos, agrupados por 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
Um método ou caminho que não esteja listado é respondido com HTTP
400.Códigos de status de resposta
| HTTP status | Significado |
|---|---|
| 200 | Resposta JSON-RPC do upstream. Um erro JSON-RPC também é retornado com HTTP 200: ele mantém o id da requisição e o error.code, seu error.message é ERPC upstream error, e error.data não é retornado. |
| 400 | Um método ou caminho fora da lista de métodos suportados, uma requisição JSON-RPC inválida, um lote vazio ou com mais de 100 chamadas, um id duplicado em um lote, ou um corpo acima de 1 MiB. |
| 401 | API key ausente ou inválida, ou uma restrição de IP ou de Origin definida na key não foi atendida. |
| 405 | Um método de requisição diferente de POST. |
| 426 | Foi solicitado um WebSocket Upgrade. O endpoint atende apenas HTTP. |
| 429 | Limitado por taxa, incluindo os limites do Plano Free acima: mais de uma requisição a cada 10 segundos, ou duas ou mais chamadas em uma requisição. Se houver um cabeçalho retry-after, aguarde o número de segundos indicado. |
| 502 | A requisição upstream não pôde ser concluída: uma resposta upstream com falha, uma resposta acima de 8 MiB, ou nenhuma resposta em até 30 segundos. |
| 503 | O serviço está temporariamente indisponível. |
Métodos e Documentação Hyperliquid RPC
Para a lista completa de métodos padrão, parâmetros e especificações, consulte a documentação oficial.