Um bot de negociação de perpétuos Hyperliquid gere exposição a derivados através de ordens, execuções e garantias. Comprar um perpétuo não significa adquirir o token à vista correspondente para levantamento. O valor da posição muda com o contrato, e os seus requisitos operacionais incluem margem, financiamento e a possibilidade de liquidação forçada. Essas características tornam insuficiente, por si só, um fluxo de inventário à vista.
A automação fiável começa com uma descrição duradoura da alteração pretendida da posição. Verifica depois o instrumento e a conta, verifica os recursos aplicáveis, envia uma ação com limites e concilia o que realmente aconteceu. A estratégia deve continuar a compreender as suas obrigações quando uma ordem executa apenas parcialmente, um cancelamento concorre com uma negociação ou o processo reinicia.
Esta é formação geral sobre mecanismos de perpétuos, não uma afirmação de que algum software específico os suporta. Todos os exemplos numéricos são hipotéticos e só omitem complexidade quando isso é declarado explicitamente. Não é recomendado nenhum nível de alavancagem, taxa de financiamento ou rendimento esperado.
Defina o ciclo de vida das ordens do bot de perpétuos Hyperliquid
O ciclo de vida começa com uma alteração pretendida da exposição com sinal: aumentar uma posição longa, reduzir uma curta ou encerrar um montante especificado, por exemplo. A intenção deve identificar instrumento, conta, tamanho máximo, restrição de preço e versão da política. Um rótulo genérico de compra não descreve completamente o objetivo económico.
Mantenha distinguíveis os resultados enviado, aceite, em espera, parcialmente executado, concluído e cancelado. A evidência exata da API determina que rótulos se aplicam. Uma resposta de transporte bem-sucedida não prova, por si só, que toda a quantidade pretendida se tornou uma posição.
A visão geral de execução na Hyperliquid explica a importância de selecionar a superfície e conta corretas. Para perpétuos, ligue esse quadro a um registo de posições, em vez de o substituir por um saldo à vista. O registo tem de preservar tanto a exposição atual como a exposição adicional que as ordens ativas restantes poderiam criar.
Determine o contrato e a plataforma exatos de negociação
Um símbolo de ativo pode aparecer em mais do que um contexto de produto ou mercado. O bot deve determinar o identificador real do perpétuo, a plataforma ou implementação relevante, o ativo de cotação ou garantia e a precisão suportada de tamanho e preço. Um símbolo familiar não basta para construir corretamente uma ordem.
A documentação atual da Hyperliquid distingue perpétuos operados por validadores e mercados HIP-3, entre outras superfícies do ecossistema. Os parâmetros dos contratos e as relações disponíveis de garantias devem vir dos metadados reais do mercado. Não aplique universalmente um parâmetro memorizado de um instrumento a todos os contratos com nome semelhante.
Preserve os metadados usados para autorizar cada ação. Se uma configuração de mercado mudar, o registo antigo deve permanecer interpretável. Uma consulta posterior pode explicar o comportamento atual sem reproduzir as condições em que foi preparada uma ordem anterior. Essa diferença importa ao investigar uma rejeição ou quantidade inesperada.
Leia o modo ativo da conta
A documentação atual acessível através do site oficial da Hyperliquid descreve modalidades de conta padrão, unificada e de margem de carteira. As suas relações de saldos e garantias diferem. Um bot deve ler o modo ativo, em vez de pressupor que recursos à vista e de perpétuos estão sempre isolados ou sempre partilhados.
Nas modalidades unificada e de margem de carteira, a vista documentada de saldos e os montantes retidos podem abranger atividades que um relatório apenas à vista ou por DEX não captaria corretamente. Por isso, uma estratégia pode ver uma oportunidade local atrativa enquanto a conta mais ampla já comprometeu os recursos necessários para a sustentar.
Trate o modo da conta como parte do contrato operacional. Uma mudança de modo pode alterar a interpretação de saldos e limites mesmo quando a mesma estratégia permanece ativa. Concilie a conta após essa mudança antes de autorizar nova exposição com pressupostos que pertenciam à modalidade anterior.
Separe limites da estratégia da margem da plataforma
Uma plataforma aceitar uma ordem não estabelece que esta se enquadra na política de risco do utilizador. O requisito de margem da plataforma e a exposição máxima permitida da estratégia respondem a perguntas diferentes. Um limite interno conservador pode rejeitar uma ordem que a conta tem tecnicamente garantias suficientes para colocar.
Num exemplo fictício simplificado, três unidades de um perpétuo linear a 200 criam 600 de exposição nocional. Se o exemplo afetar 120 de margem, isso corresponde, na entrada, a uma alavancagem de cinco vezes na relação entre nocional e margem. Um movimento adverso de dez por cento no preço cria uma perda de preço de sessenta unidades antes de comissões e financiamento, consumindo metade dessa margem ilustrativa.
Este cálculo não é uma fórmula de preço de liquidação forçada. A liquidação real depende do instrumento, modo de margem, estado da conta e requisitos de manutenção. O exemplo mostra por que uma pequena afetação de garantias não torna pequena a posição económica. O tamanho da posição e a perda permitida precisam dos seus próprios limites explícitos.
Escolha o comportamento da ordem de acordo com a intenção
Um limite especifica uma fronteira de preço, enquanto a validade da ordem determina o que acontece a quantidades que não executam imediatamente. A documentação atual de ordens da Hyperliquid distingue comportamento em espera, execução imediata ou cancelamento e apenas colocação passiva. O adaptador deve preservar a combinação pretendida pelo utilizador, em vez de traduzir todos os pedidos para uma predefinição.
Uma ordem de execução imediata ou cancelamento pode executar parcialmente e deixar o restante cancelado. Uma instrução apenas de colocação passiva procura evitar execução imediata como tomador de liquidez; não garante que uma ordem em espera execute depois ou seja lucrativa. A distinção importa ao estimar tanto exposição como custos de execução.
O guia de tratamento da API da Hyperliquid explica por que os resultados precisam de interpretação por ação. A estratégia deve responder ao resultado aceite da ordem real. Não deve inferir uma posição completa do facto de um pedido conter a quantidade desejada.
Preserve a intenção decimal durante a construção
As restrições de preço e tamanho devem reter a precisão pretendida desde a decisão da estratégia até à ação assinada. Um arredondamento descuidado pode aumentar exposição, mover um limite através do spread ou produzir um pedido inválido. A direção correta do arredondamento depende da fronteira que o valor representa.
Por exemplo, um montante máximo permitido de compra não deve ser arredondado para cima apenas para corresponder a uma preferência de apresentação. Uma instrução de encerramento deve ser verificada face à posição atual e ao incremento suportado de quantidade. A interface pode apresentar um número mais curto enquanto o registo duradouro preserva o valor exato autorizado.
A validação deve ocorrer antes da assinatura. Se uma quantidade não puder ser representada dentro das regras atuais do mercado, o sistema deve produzir uma rejeição explícita ou um montante reduzido justificado separadamente. Ajustar silenciosamente valores depois da autorização dificulta estabelecer se a ação executada continua a corresponder à política do utilizador.
Mantenha o componente de assinatura separado da conta de negociação
Um agente delegado pode assinar ações de uma conta sem ser a conta cujas posições e saldos devem ser consultados. A documentação oficial de carteiras de API salienta essa distinção. Ler o endereço do agente como se detivesse a conta de negociação pode produzir um resultado vazio e uma impressão falsa de que não existe exposição.
Guarde a identidade de quem assina e a identidade da conta económica em campos diferentes. O registo da ordem também deve identificar qualquer subconta aplicável ou outro âmbito suportado. Isso impede que uma verificação bem-sucedida de autenticação seja confundida com confirmação de que a estratégia opera na carteira pretendida.
Coordene os requisitos de nonce do protocolo por autoridade de assinatura. O modelo de nonce de ações assinadas de HyperCore não deve ser substituído por uma sequência pressuposta de transações EVM. Vários processos que partilham uma autoridade de assinatura precisam de uma conceção coordenada, enquanto uma autoridade de assinatura separada exige a sua própria gestão de permissões e ciclo de vida.
Trate um envio sem resposta como por resolver
Uma resposta perdida deixa uma pergunta sobre a ação original. Não estabelece que a ação falhou ou que uma nova ordem é segura. Preserve a intenção duradoura e os identificadores disponíveis da ordem antes do envio externo para que a recuperação possa investigar o mesmo pedido económico.
Use evidência atual da conta e da ordem para determinar se a ação criou uma ordem em espera, executou, foi rejeitada ou permanece desconhecida. Um identificador de ordem do cliente pode ajudar a correlacionar registos, mas não deve ser descrito como garantia universal de que qualquer conteúdo repetido não tem efeito adicional. Siga o comportamento documentado do ponto de acesso real.
Enquanto o resultado estiver por resolver, retenha a dotação adequada de recursos e exposição. Libertá-la imediatamente pode permitir que outro processo autorize uma segunda posição. O objetivo da recuperação é estabelecer o que a conta pode já deter, não simplesmente obter uma resposta bem-sucedida de um novo pedido.
Construa a exposição a partir de execuções e ordens restantes
Uma quantidade pedida, uma quantidade executada e um remanescente aberto são valores separados. Se uma ordem hipotética pedir cinco unidades e executar duas seguidas de meia unidade, a alteração da posição é de 2,5 e a quantidade pedida restante é de 2,5 até o seu estado final de ordem estar estabelecido.
A análise de risco da conta deve incluir tanto a exposição atual de 2,5 unidades como o efeito possível desse remanescente. Um pedido de cancelamento pode procurar remover o segundo, mas o registo não deve apagá-lo antes de o estado aceite da ordem confirmar o que aconteceu.
Elimine duplicados da evidência de execuções quando fluxos são reproduzidos ou consultas históricas se sobrepõem. Contar duas vezes a mesma execução de meia unidade sobrestimaria a posição e pode levar a uma ação de encerramento excessiva. Preserve uma identidade estável de execução e concilie totais com a vista de referência da conta, em vez de pressupor que cada mensagem recebida descreve uma nova operação.
Conceba saídas apenas de redução no bot de perpétuos Hyperliquid
As saídas apenas de redução de um bot de perpétuos Hyperliquid devem expressar a intenção de reduzir uma posição existente sem abrir exposição na direção oposta. As opções atuais de ordens incluem esse controlo. É útil quando outra ação pode ter alterado a posição antes de a saída chegar à execução.
Suponha que uma conta fictícia tinha uma posição longa de três unidades quando foi preparada uma saída, mas outra venda autorizada a reduziu para uma. Uma venda sem restrições de três poderia encerrar a posição longa restante e criar uma posição curta de duas unidades. Uma restrição apenas de redução aplicada corretamente trata essa inversão indesejada, sujeita às regras reais de aceitação e execução da plataforma.
Apenas de redução não garante que uma saída seja concluída ou obtenha um preço específico. A ordem pode ainda encontrar liquidez correspondente insuficiente, parâmetros inválidos ou outras condições de rejeição. O bot tem de conciliar a posição restante depois da tentativa, em vez de tratar a presença da opção como prova de que o risco desapareceu.
Distinga um acionamento de saída de uma execução de saída
Uma condição de paragem ou realização de lucro pode ativar uma ordem sem concluir uma alienação. A referência de acionamento, condição de preço, tipo de ordem resultante e tamanho devem ser explícitos. Escolhas diferentes criam contrapartidas diferentes entre controlo de preço e probabilidade de execução sob condições em mudança.
Uma ordem limitada acionada pode permanecer sem execução se o mercado ultrapassar o seu intervalo aceitável. Uma saída orientada ao mercado pode enfrentar execução pior do que o nível observado de acionamento. Nenhuma deve ser apresentada como perda máxima garantida ou lucro realizado garantido.
Acompanhe a posição através da ativação e execuções subsequentes. Se apenas parte encerrar, a quantidade restante continua a exigir gestão. O controlador de saídas também deve contabilizar atividade manual ou uma ação de outra estratégia para que tamanhos antigos de acionamento não se tornem silenciosamente inconsistentes com a conta atual.
Trate o cancelamento como uma corrida com o mercado
Uma ordem pode executar enquanto um pedido de cancelamento está em trânsito. Por isso, o registo final correto pode conter uma execução parcial e um remanescente cancelado. Esses resultados são compatíveis; o cancelamento não remove retroativamente a operação já ocorrida.
Ao substituir uma ordem, determine o que resta da instrução antiga antes de decidir o tamanho da substituição. Uma quantidade desejada local e o remanescente atual da plataforma podem divergir nesse intervalo. Tratar a substituição como uma ordem não relacionada de tamanho completo pode criar exposição excessiva.
O guia de recuperação operacional da Hyperliquid explica por que as obrigações precisam de responsabilidade clara. Um componente deve decidir como se articulam a ordem antiga, as execuções intermédias e a revisão proposta. Vários processos a reparar independentemente o mesmo cancelamento podem produzir mais incerteza do que o atraso original.
Mantenha separada a contabilidade de financiamento dos perpétuos Hyperliquid
O financiamento é uma componente de fluxo de caixa da exposição a perpétuos, distinta do ganho ou perda causado pelos preços de entrada e saída. A documentação atual de financiamento descreve pagamentos entre detentores de posições longas e curtas e usa nocional baseado no oráculo no cálculo do pagamento. Não substitua por um preço de referência apresentado sem verificar a convenção real.
Num intervalo fictício, duas unidades a um preço de oráculo de 500 representam 1 000 de nocional de financiamento. Uma taxa pressuposta de pagamento de 0,01% produz um pagamento de 0,1. Seis intervalos idênticos totalizariam 0,6, mas taxas, preços e tamanhos reais de posições podem mudar entre observações.
A taxa do exemplo é inventada e não prevê uma direção de pagamento. Registe créditos e débitos reais a partir da evidência da conta, ligados ao período e posição relevantes. Uma previsão de financiamento pode informar uma decisão, mas não equivale a financiamento já ganho ou pago.
Concilie resultados de preço, comissões e financiamento
Mantenha as componentes separadas antes de calcular o resultado líquido. Numa posição longa hipotética simplificada, duas unidades com entrada a 500 e saída a 520 produzem quarenta de ganho bruto de preço. Se os custos de negociação registados totalizarem três e o financiamento líquido for um débito de 1,2, o resultado é 35,8 antes de quaisquer outros custos aplicáveis.
Assim, um movimento lucrativo de preço pode coexistir com um ganho menor na conta, e um resultado de preço inalterado pode ainda perder dinheiro após custos. O registo deve tornar visíveis essas diferenças, em vez de forçar todas as alterações de saldo a caber num único número de operação realizada.
Use os ativos reais de garantia e comissões comunicados para o mercado e conta relevantes. Se for necessária conversão para uma moeda de apresentação, preserve o seu momento de avaliação e quantidades originais. Alterações no valor do ativo de apresentação não devem ser confundidas com melhor execução da própria estratégia de perpétuos.
Mantenha um registo de encerramentos parciais
Uma saída parcial deve afetar consistentemente os valores económicos da posição e preservar a exposição restante. Considere uma posição longa inventada de duas unidades com entrada a 500. Encerrar 0,75 a 510 cria 7,5 de ganho de preço. As 1,25 restantes, encerradas mais tarde a 498, perdem 2,5, deixando cinco de ganho bruto de preço em toda a posição.
Se as comissões combinadas forem 1,8 e o financiamento for um débito de 0,4, o resultado líquido completo é 2,8. Comunicar apenas a primeira alienação lucrativa sobrestimaria materialmente o resultado. Comunicar toda a posição de duas unidades como encerrada após essa primeira execução também apagaria o risco restante.
Os métodos de conta podem diferir na apresentação da entrada média e componentes realizadas, pelo que a reconstrução local deve seguir a convenção documentada e conciliar com a conta. Preserve as execuções e fluxos de caixa subjacentes mesmo quando o relatório apresentado ao utilizador fornece um resumo mais simples.
Monitorize a margem sem inventar uma reserva fixa contra liquidação
O risco de liquidação forçada depende da exposição atual, relações de garantias e regras de manutenção. Uma distância percentual face a um preço antigo de entrada não é uma medida completa. Outras posições, financiamento e alterações no valor da conta podem afetar os recursos disponíveis sob a modalidade ativa de margem.
Use a evidência atual relevante da conta e os parâmetros do instrumento. Uma estimativa calculada deve indicar os seus pressupostos e não deve ser apresentada como garantia de que a liquidação forçada não pode ocorrer antes de um certo preço. Alterações rápidas e preços de referência diferentes podem tornar enganadora uma fronteira simplista.
A estratégia deve definir o que faz quando a evidência exigida de margem está indisponível. Continuar a acrescentar exposição porque a última margem de segurança registada parecia confortável pode agravar a incerteza. Suspender novo risco mantendo observação e gestão autorizada das posições é uma ação diferente de pressupor que uma posição aberta se tornou segura apenas porque o bot está suspenso.
Reconstrua a conta antes de retomar após um reinício
O arranque deve recuperar intenções duradouras, identificadores de ordens aceites, remanescentes abertos, execuções, eventos de financiamento e transferências relevantes. Deve depois comparar essa reconstrução com o estado atual da conta. Uma ligação saudável, por si só, não estabelece que a estratégia conhece as suas obrigações existentes.
A atividade manual tem de ser incluída. Se o utilizador reduziu uma posição enquanto o processo estava desligado, o bot não deve restaurar automaticamente o tamanho antigo para corresponder à sua memória local desatualizada. A alteração externa da conta é evidência de que o estado operacional mudou e pode exigir uma nova decisão da política.
Retome novas entradas apenas quando os registos exigidos as sustentarem. Diferenças inexplicadas devem permanecer visíveis com um âmbito definido de investigação. Sobrepor silenciosamente ao registo local um único total atual pode ocultar execuções duplicadas, custos em falta ou uma ordem cancelada que executou parcialmente antes de desaparecer da lista de ordens abertas.
Ensaie uma saída interrompida
Um exercício fictício útil começa com uma posição longa de três unidades e um pedido apenas de redução para encerrar duas. A ligação cai depois do envio. Durante a lacuna, executam 1,5 unidades e a ordem restante de meia unidade é cancelada mais tarde. A posição resultante correta é uma posição longa de 1,5 unidades, pressupondo ausência de outra atividade.
O processo de recuperação deve encontrar tanto a execução como o remanescente cancelado. Não deve pressupor que as duas unidades pretendidas encerraram, nem reenviar uma nova saída de duas unidades apenas porque faltou a resposta original. Qualquer redução adicional deve basear-se na posição atual de 1,5 unidades e na política ativa.
Estenda o exercício reproduzindo a mesma mensagem de execução. A exposição deve permanecer inalterada depois de eliminar duplicados. Este cenário testa várias fronteiras importantes em simultâneo: identidade duradoura, execução parcial, cancelamento, reinício e proteção contra inversão indesejada. O teste tem sucesso quando a conta final é explicada, não quando todos os pedidos respondem depressa.
Avalie a automação pela posição que deixa
Um bot de perpétuos deve ser julgado por os seus registos de posições e recursos permanecerem corretos durante funcionamento comum e interrompido. Pedidos rápidos só são úteis quando a aplicação consegue identificar a conta, interpretar cada resultado e explicar a exposição restante.
Analise tentativas concluídas e por resolver em conjunto. Registe com que frequência a estratégia exigiu recuperação, que pressupostos mudaram e se os limites internos se mantiveram durante concorrência. Mantenha o desempenho de negociação separado da correção operacional, para que um movimento favorável de mercado não oculte um ciclo de vida defeituoso das ordens.
Um bot compreensível de perpétuos Hyperliquid liga uma intenção com limites a execuções reais, reconhece o financiamento como fluxo de caixa próprio e gere saídas face às posições atuais. Essas disciplinas não removem o risco de derivados, mas dão ao utilizador uma base coerente para decidir o que a conta está autorizada a fazer a seguir.