Conectar a exchange HYPERLIQUID
A Hyperliquid é uma exchange on-chain: você entra com uma carteira cripto ou com um e-mail, e a sua conta fica ligada a um endereço de carteira. O Bybot opera na sua conta da Hyperliquid por meio de um API Wallet, uma chave separada que pode colocar e cancelar ordens em nome da sua carteira. Seu dinheiro fica na sua conta da Hyperliquid, e o API Wallet não pode sacar nem transferir fundos. A configuração leva cerca de 10 minutos.
No Bybot você adiciona duas coisas: o endereço da sua carteira principal e a chave privada do API Wallet. Nunca cole a chave privada nem a frase-semente da sua carteira principal: o Bybot não precisa delas e recusa essa chave.
O que você precisa
- Uma carteira cripto (por exemplo, MetaMask ou Rabby) ou um e-mail para entrar na Hyperliquid, de preferência uma conta separada para o bot
- USDC e um pouco de ETH para o gas na rede Arbitrum
- A partir de uns $100 por par de negociação: a ordem mínima na Hyperliquid é de 10 USDC
O API Wallet opera a sua conta inteira da Hyperliquid, incluindo perpétuos, e as permissões dele não podem ser limitadas. Por isso recomendamos uma carteira separada para o bot.
1. Entre na Hyperliquid
Abra app.hyperliquid.xyz e clique em “Connect”. Entre com uma carteira cripto ou com um e-mail. Se usar uma carteira, depois clique em “Enable Trading” e assine a solicitação nela: não custa gas.
2. Deposite USDC
Clique em “Deposit”, escolha USDC na Arbitrum e siga as instruções na tela.
Deposite pelo menos 5 USDC. A Hyperliquid não credita depósitos menores, e os fundos podem ser perdidos. Por esse caminho só é aceito USDC da rede Arbitrum.
3. Deixe o USDC disponível para o spot
O Bybot opera no mercado spot da Hyperliquid. Faça uma das opções:
- mude a conta para o modo Unified account: assim um único saldo de USDC serve para spot e perpétuos, e não é preciso transferir nada;
- ou, no modo padrão, transfira USDC de Perps para Spot: nesse modo os depósitos caem no saldo de Perps.
O modo Portfolio margin não é suportado: nele a Hyperliquid pega um empréstimo automaticamente quando falta saldo, e o bot poderia comprar a crédito. O Bybot se recusa a operar com uma conta assim.
4. Abra a página API
No menu superior, abra “More” e escolha “API”.
5. Crie um API Wallet com nome
- Digite um nome para o API Wallet, por exemplo
bybot, e clique em “Generate”. - Clique em “Authorize API Wallet”.
- Na janela “Authorize API Wallet”, clique em “MAX” no campo “Days Valid”: o API Wallet vai funcionar pelo prazo máximo, até 180 dias.
- Copie a Private Key com o botão de copiar e guarde em um lugar seguro.
- Clique em “Authorize”. Se você entrou com uma carteira, confirme nela.
A chave privada aparece uma única vez. Se você perdê-la, crie um novo API Wallet.
O API Wallet precisa ter nome. A Hyperliquid substitui um API Wallet sem nome quando você ativa o trading em outro dispositivo, e o bot perderia o acesso.
6. Copie o endereço da sua carteira
Clique no botão da sua conta no canto superior direito e copie o endereço com o botão de copiar. Esse é o endereço da sua carteira principal, o que o Bybot precisa. Não use o endereço do API Wallet do passo 5.
7. Adicione a chave no Bybot
No Bybot, abra Configurações (“Settings”) → Chaves de API (“API Keys”) e clique em Adicionar chave (“Add key”). Escolha HYPERLIQUID e preencha dois campos:
| Campo | O que colar |
|---|---|
| Endereço da carteira (“Wallet address”) | O endereço da sua carteira principal do passo 6, 0x… (42 caracteres) |
| Chave privada do API Wallet (“API Wallet private key”) | A chave privada do passo 5, 0x… (66 caracteres) |
Clique em Salvar (“Save”). O Bybot confere a chave pelos dados públicos da Hyperliquid: o API Wallet precisa pertencer a esta carteira e ter nome, e o modo da conta precisa ser suportado.
8. Verifique a chave
Na lista de chaves, clique em ”⋯” no cartão da Hyperliquid e escolha Verificar chave (“Check key”). O Bybot confirma que o API Wallet continua conectado à sua carteira. A coluna Validade do API Wallet (“API Wallet expiry”) mostra quando ele vence.
9. Antes de criar um bot
- O Bybot opera 5 pares contra USDC: BTC, ETH, SOL, ZEC e HYPE. Na Hyperliquid, BTC, ETH, SOL e ZEC são moedas embrulhadas da Unit (UBTC, UETH, USOL, UZEC).
- Na Hyperliquid você pode rodar um bot DCA por par.
- A ordem mínima é de 10 USDC.
Depois siga o guia Criar um bot.
Validade do API Wallet
Você escolhe por quanto tempo o API Wallet funciona ao criá-lo, até 180 dias. O Bybot avisa antes do vencimento. Quando ele vence, o bot para de operar. Para continuar, crie um novo API Wallet com nome na Hyperliquid, exclua a chave antiga no Bybot e adicione a nova.
Limite de ações da Hyperliquid
A Hyperliquid limita o número de ações (colocar e cancelar ordens) por carteira: 10 000 no início, mais 1 ação para cada $1 de volume negociado pela carteira. Quando o limite acaba, o trading não para, mas fica mais lento.
O Bybot não pode comprar ações extras: a Hyperliquid só aceita essa compra com a assinatura da sua carteira principal e cobra dessa carteira. Se o limite acabar, espere o volume crescer ou compre ações extras você mesmo pela carteira principal.
Taxas e sobras
- A taxa spot da Hyperliquid é de 0.07% para ordens taker e 0.04% para ordens maker no nível base.
- Na compra, a taxa é cobrada na moeda comprada (para BTC, em UBTC); na venda, em USDC. Por isso você recebe um pouco menos de moedas do que comprou.
- Uma sobra que vale menos que a ordem mínima de 10 USDC não pode ser vendida e fica na conta como poeira.
Trading manual na mesma carteira
Não opere manualmente no par em que o bot trabalha. A Hyperliquid não deixa uma carteira negociar consigo mesma: quando a sua ordem manual encontra uma ordem do bot, a Hyperliquid cancela a ordem que já estava no livro, muitas vezes a do bot. O bot vê isso como um cancelamento.
Segurança da chave
- Saques são impossíveis. Um API Wallet pode colocar e cancelar ordens, mas não pode sacar nem transferir fundos: a Hyperliquid recusa esses pedidos mesmo que a chave vaze.
- Nunca cole a chave privada nem a frase-semente da carteira principal. O Bybot só precisa da chave do API Wallet e nunca vai pedir a frase-semente.
- Use uma carteira separada para o bot. O API Wallet pode operar a sua conta inteira da Hyperliquid, incluindo perpétuos.
- Uma carteira, uma conta do Bybot. Um endereço de carteira só pode ser conectado a uma conta do Bybot.
- Se você parar de usar o bot, pare os bots da Hyperliquid, exclua a chave no Bybot e depois revogue o API Wallet em app.hyperliquid.xyz → API. Até revogar, o API Wallet ainda pode operar a sua conta.
Problemas comuns
“A Hyperliquid não confirmou a chave”. Confira o endereço da carteira, a chave privada do API Wallet e se o API Wallet não venceu.
“Esta é a chave privada da sua carteira principal”. Você colou a chave da carteira principal. Crie um API Wallet com nome (passo 5) e cole a chave privada dele.
“O API Wallet precisa ter nome”. Crie um API Wallet com nome na página API e cole a chave dele.
“Este modo de conta da Hyperliquid não é suportado”. A conta está em Portfolio margin. Mude para Unified account ou para o modo padrão.
“Esta carteira da Hyperliquid já está conectada a outra conta”. Uma carteira só pode ser conectada a uma conta do Bybot.
Não consigo excluir a chave. Primeiro pare os bots da Hyperliquid e depois exclua a chave.
O bot não compra, mesmo com USDC depositado. No modo padrão o depósito cai no saldo de Perps. Transfira USDC para Spot ou mude para Unified account.
O bot ficou lento. A carteira pode ter esgotado o limite de ações da Hyperliquid. Veja “Limite de ações da Hyperliquid” acima.
Documentação oficial da exchange: Hyperliquid Docs.