Sim, pela API pública
Sim: a Hyperliquid publica toda a interface de trading dela como uma API HTTP pública, a mesma que a interface web usa. As leituras não pedem chave, as escritas pedem uma ação assinada, e uma conta pode aprovar uma carteira de API para assiná-las em vez da chave dela.
| Para que serve | Onde |
|---|---|
| Leituras: preços médios, livro L2, candles, histórico do funding, estado de uma conta. Sem chave, sem assinatura. | POST https://api.hyperliquid.xyz/info |
Escritas: order, cancel, modify, updateLeverage, approveAgent, withdraw3 e as demais, cada uma assinada. | POST https://api.hyperliquid.xyz/exchange |
Fluxos ao vivo (allMids, l2Book, trades, candle, userFills), e uma alternativa ao envio por HTTP. | wss://api.hyperliquid.xyz/ws |
| Os mesmos três caminhos na plataforma de teste. | api.hyperliquid-testnet.xyz |
Três endereços importam, abaixo, e cada número desta página é o da documentação em 5 de outubro de 2026.
Os SDK que a documentação lista
Você não precisa montar ações assinadas à mão. A documentação nomeia um SDK Python oficial, hyperliquid-dex/hyperliquid-python-sdk, um SDK Rust da comunidade, dois SDK TypeScript da comunidade (nktkas/hyperliquid e nomeida/hyperliquid) e o CCXT.
A assinatura é a parte que vale emprestar em vez de reescrever. Uma ação é serializada e assinada em uma forma exata, e uma forma errada em um único campo é recusada: a ordem nunca chega ao livro.
Carteiras de API e nonces
Uma conta principal pode aprovar carteiras de API para assinar em nome da conta principal ou de qualquer uma das subcontas dela. Elas só assinam: para consultar os dados de uma conta você precisa passar o endereço real dessa conta, e usar a carteira de agente dá um resultado vazio.
Os nonces são mais rígidos do que parecem. A Hyperliquid guarda os 100 nonces mais altos por endereço, e uma ação nova precisa de um nonce maior que o menor desse conjunto, nunca usado antes, e dentro de uma janela de (T menos 2 dias, T mais 1 dia), em que T é o horário do bloco em milissegundos unix.
Uma carteira de API é podada quando uma carteira nova sem nome é cadastrada, quando uma carteira nova com nome assume um nome existente, quando ela vence, ou quando a conta que a cadastrou fica sem fundos. A documentação avisa que um agente descadastrado pode ter o estado dos nonces podado, então ações assinadas antes podem ser repetidas: gere uma carteira de agente nova em vez de ressuscitar uma antiga.
Os limites de pedidos, como estão documentados
- Por IP. Os pedidos REST dividem um limite de peso agregado de 1.200 por minuto. Uma ação de troca pesa
1 + floor(batch_length / 40), então um lote é quase de graça; a maioria dos pedidos de informação pesa 20, um punhado pesa 2, euserRolepesa 60. - Por endereço. 1 pedido por cada 1 USDC negociado de forma acumulada, depois de uma folga inicial de 10.000 pedidos, e então um pedido a cada 10 segundos. Os cancelamentos têm uma cota mais larga.
- Websocket. No máximo 10 conexões, 30 conexões novas por minuto, 1.000 assinaturas, 2.000 mensagens enviadas por minuto e 100 mensagens post simultâneas em voo.
- Ordens abertas. Um limite padrão de 1.000, mais uma a cada 5 M de USDC de volume, com teto total de 5.000.
O limite por endereço surpreende um programa novo: a cota dele se ganha negociando, e um laço que tenta de novo no escuro gasta essa cota em nada.
Um script, um bot, um assistente
| O que é | Quem decide | O que ele pede de você |
|---|---|---|
| Um script | Você, na hora em que escreveu. Ele percorre uma sequência e não escolhe nada. | Que você o leia antes de rodar. Os limites dele são as linhas que você digitou. |
| Um bot | Uma regra que você escreveu, sempre que as condições dela se cumprem, sem ninguém olhando. | Limites fora da regra, e um jeito de pará-lo com um comando só. |
| Um assistente (um agente de IA) | Um modelo propõe; o código confere a proposta contra números. | Limites que ele não consegue ampliar, e uma chave que não consegue sacar. |
A API não consegue dizer qual dos três está chamando, e aplica as mesmas regras aos três. Eles diferem em onde a decisão é tomada e no que acontece quando ela está errada: um script que erra erra uma vez, um bot a noite toda.
O Locker Protocol Agentic é do terceiro tipo: lpa para uma pessoa ou um agente de IA, um servidor MCP com os mesmos comandos como ferramentas, uma política local conferida duas vezes antes de qualquer ordem, e um mandato assinado pela sua própria carteira. Ele não promete nenhum resultado.