MetaMask Agent Wallet negocia futuros perpétuos na Hyperliquid por meio do conjunto de comandos mm perps. Um trader pede ao seu agente uma posição em linguagem natural, e o agente encaminha essa solicitação para os comandos que depositam garantia, buscam uma cotação, abrem a posição, definem níveis de take profit e stop loss, e a fecham ou redimensionam posteriormente. A carteira mantém a custódia; os depósitos passam por verificação de política, e o agente apenas propõe.
Essa transferência de controle é o que diferencia o trading de perps orientado por agente de navegar por uma interface. Uma única frase pode carregar muitas suposições não declaradas sobre tipo de ordem, slippage e tamanho. Este artigo aborda os detalhes que vale a pena tornar explícitos, incluindo quais partes desse fluxo de trabalho os controles em nível de carteira da MetaMask realmente alcançam e quais não.
Este é um guia de mecânica de trading, não uma introdução a perps. Para entender o que são futuros perpétuos e como eles precificam, veja trading de perps para iniciantes e conceitos essenciais de futuros perpétuos. Para a matemática por trás do dimensionamento de posições, veja alavancagem e margem no trading de futuros perpétuos. Para a categoria de carteira em si, veja o que é uma carteira agêntica e como carteiras agênticas funcionam.
A superfície de perps, em uma tabela
Estes são os comandos em que um fluxo de trabalho de perps se apoia. Conhecer a superfície facilita formular uma solicitação que chegue da forma pretendida.
O que você pede ao seu agente | O que é executado | O que faz |
"Quais mercados de perps estão disponíveis" | mm perps markets
| Lista os símbolos negociáveis na plataforma |
"Deposite 500 USDC na minha conta de perps" | mm perps deposit
| Deposita USDC na plataforma |
"Quanto custaria uma long de 5x em BTC" | mm perps quote
| Precifica a posição sem submetê-la |
"Abra uma long de 5x em BTC com $100" | mm perps open
| Submete a ordem |
"Defina um stop em 58.000" | mm perps modify
| Anexa take profit, stop loss ou nova alavancagem |
"Mostre minhas posições abertas" | mm perps positions
| Lê a exposição atual |
"Feche minha posição em BTC" | mm perps close
| Fecha total ou parcialmente |
"Cancele aquela ordem pendente" | mm perps cancel
| Cancela pelo ID da ordem |
"Mova 200 USDC de volta para spot" | mm perps transfer
| Move garantia entre saldos spot e perp |
Fonte: Referência de comandos do MetaMask Agent Wallet.
Com esse entendimento básico, aqui estão 9 dicas essenciais para usar o MetaMask Agent Wallet para negociar perps.
1. Financie a conta de perps antes da primeira solicitação
A subconta da Hyperliquid está vazia no primeiro uso. Pedir a um agente para abrir uma posição antes de qualquer garantia ter chegado pode falhar com HYPERLIQUID_ERROR ou ORDER_REJECTED, e o agente não tem nada útil para tentar novamente.
mm perps deposit usa USDC da Arbitrum por padrão, então o USDC precisa estar na Arbitrum, ou --source-chain-id precisa apontar para onde ele está. Garantia que já está no saldo spot da carteira na plataforma pode ser movida com mm perps transfer --direction spot-to-perp em vez de um novo depósito.
Um número que vale memorizar: ordens abaixo de $10 nocional são rejeitadas com INVALID_AMOUNT, com uma sugestão para aumentar o tamanho da posição ou a alavancagem. Trades de teste pequenos precisam superar esse piso.
2. Solicite uma cotação antes de abrir, ou visualize com um dry run
mm perps quote precifica uma posição sem submetê-la. mm perps open --dry-run vai além e valida a ordem completa sem assinar ou submeter nada.
Ambos importam mais com um agente do que com uma interface manual, porque a etapa de confirmação que um trader normalmente leria na tela é algo que o agente pode ser instruído a pular. Uma cotação ou um dry run coloca os números de volta diante de um humano antes que qualquer coisa seja assinada.
3. Diga "limit" se uma ordem limitada é o que você quer
mm perps open aceita --type market ou --type limit, e uma ordem limitada requer --limit-px. Uma solicitação formulada como "abra uma long de 5x em ETH com $200" não contém instrução de preço, então é resolvida como uma ordem a mercado.
Ordens a mercado cruzam o spread e podem sofrer slippage, que é a diferença entre o preço de execução esperado e o preço efetivamente recebido. Em mercados com pouca liquidez, essa diferença aumenta. Traders que se preocupam com o preço de entrada geralmente o especificam, e traders que se preocupam mais com a certeza de execução geralmente não o fazem.
4. Limite o slippage na entrada e na saída
Tanto mm perps open quanto mm perps close aceitam --max-slippage-bps, um teto expresso em pontos-base. A documentação não publica um valor padrão, então uma ordem submetida sem o parâmetro opera com o que o CLI aplica, em vez de um número declarado.
Definir o teto explicitamente é uma das poucas instruções que restringe uma abertura autônoma de uma forma que o agente não pode reinterpretar. Também é fácil de esquecer na saída, que é a perna onde o slippage tende a doer mais, porque as saídas se concentram nos momentos em que todos os outros também estão saindo.
5. Anexe take profit e stop loss como uma segunda etapa deliberada
mm perps open não aceita níveis de take profit ou stop loss. Eles são adicionados com mm perps modify --tp e --sl , que requer pelo menos um de --leverage, --tp ou --sl.
A consequência prática: uma posição aberta por um agente não tem ordens de saída anexadas até que alguém as solicite. Um prompt que diz "abra uma long de 5x em BTC com $100, depois defina um stop 4% abaixo da entrada e take profit 8% acima" descreve dois comandos e obtém ambos. Um prompt que para após a primeira cláusula resulta em uma posição sem proteção. Definir os níveis de saída no mesmo momento que a entrada é o que evita que a diferença entre esses dois estados seja relevante.
6. Saiba que o depósito, não a ordem, é o que a MetaMask verifica
Apenas uma etapa em um fluxo de trabalho de perps é uma transação EVM que os controles em nível de carteira da MetaMask realmente avaliam: o depósito. Ele passa pela verificação de ameaças em ambos os modos de trading. No Guard Mode especificamente, ele também é medido contra o limite de saída contínuo de 24 horas, que a documentação da MetaMask nomeia depósitos na Hyperliquid como uma categoria incluída ao lado de transferências de tokens e swaps. Se o depósito exceder esse limite, ou se a verificação de ameaças o sinalizar em qualquer modo, o processo pausa em AWAITING_MFA para aprovação de autenticação de 2 fatores, entregue como uma notificação push do MetaMask Mobile para logins por QR ou um link por e-mail para logins pelo navegador, e o agente não pode prosseguir até que alguém responda. Isso se aplica ao modo de carteira de servidor; os modos de trading não se aplicam a configurações com carteira própria (bring-your-own-wallet).
Abrir, modificar e fechar uma posição acontece na própria Hyperliquid, não como transações EVM simuladas pela MetaMask. Essas ações não passam por verificação de ameaças, não consomem o orçamento de saída, não são verificadas contra listas de permissões e não acionam autenticação de 2 fatores, independentemente do tamanho da posição. Um depósito de $2.000 que atinge o limite de saída é examinado na entrada; uma posição de $50.000 aberta com essa mesma garantia com alavancagem de 25x não recebe uma segunda verificação da carteira. O limite de saída é um controle no momento do financiamento, não um controle de tamanho de posição, e a disciplina de dimensionamento da ordem em si depende inteiramente do que o prompt diz e do que o agente faz com isso.
O hábito prático: financie a conta em uma etapa deliberada e separada, dimensionada para o que realmente se pretende arriscar, pois esse é o único momento em que as proteções da MetaMask se aplicam. Tudo que vem depois desse depósito é responsabilidade do trader e do agente.
7. Faça login sempre da mesma forma
Google, e-mail sem senha e QR do MetaMask Mobile resolvem para endereços de carteira de servidor diferentes, mesmo quando o mesmo endereço de e-mail é usado em mais de um deles. Como a conta da Hyperliquid é financiada a partir de uma carteira específica, fazer login de uma forma diferente exibe um endereço diferente sem nenhuma dessas garantias.
O hábito que evita isso: escolha um método de login, use-o sempre, e execute mm wallet address após fazer login para confirmar o endereço esperado antes de solicitar qualquer coisa. Os fundos permanecem onde estavam; eles simplesmente não ficam visíveis na sessão errada.
8. Defina o escopo de DEXs HIP-3 deliberadamente
Saldo, posições e ordens têm como padrão o DEX principal da Hyperliquid. --dex limita uma consulta a um DEX HIP-3 específico, e --all-dexes agrega entre eles para leituras de saldo e posições.
Um agente perguntado "quais são minhas posições" sem qualificação reporta apenas sobre o DEX principal. Para um portfólio distribuído entre múltiplos DEXs, essa resposta é incompleta de uma forma que não é óbvia ao lê-la, o que torna --all-dexes algo que vale mencionar em qualquer prompt que pretenda produzir um panorama completo. mm perps dexs lista os identificadores disponíveis.
Os parâmetros de escopo estão documentados nos comandos de leitura em vez de nos de colocação de ordens, então --dex é melhor entendido aqui como um controle de visibilidade.
9. Use cotações e dry runs para ensaiar, não a testnet
mm perps open --dry-run valida uma ordem totalmente especificada, incluindo símbolo, direção, tamanho e alavancagem, sem assinar ou submeter nada. Combinado com mm perps quote, um prompt de estratégia pode ser executado de ponta a ponta com preços ao vivo para confirmar o que o agente realmente submeteria, antes de qualquer garantia estar em risco.
--network testnet existe nos comandos de leitura e trading, mas ensaiar uma estratégia ao vivo lá atualmente não é prático: a testnet da Hyperliquid usa uma variante de USDC exclusiva de faucet que não está disponível pelo caminho de financiamento do Agent Wallet, então uma conta de perps na testnet não pode ser financiada da mesma forma que uma na mainnet. Dry runs e cotações são as ferramentas de ensaio mais confiáveis até que isso seja resolvido.
Para a versão ao vivo, --yes pula o prompt de confirmação interativa em open, close, modify e cancel, que é o que torna possíveis fluxos agendados ou com script. O que --yes não faz é desativar os próprios controles da carteira na etapa de depósito descrita na dica 6. Pular o prompt de confirmação remove a leitura humana da ordem; não muda o que a MetaMask verifica.
O que o Agent Wallet não faz para perps
Ser claro sobre o limite é mais útil do que sugerir um mais amplo.
Não há mecanismo de estratégia integrado. O Agent Wallet expõe a superfície de trading; a lógica de decisão vive no agente e no que o trader lhe diz. Não há skill dedicada de copy-trading, feed de sinais ou rebalanceamento automatizado disponível para posições de perps. Traders que desejam esse tipo de lógica personalizada podem construí-la como um plugin, um recurso em beta que permite que um pacote npm instalado adicione novos comandos ao CLI com capacidades de leitura ou submissão de transações controladas por consentimento, mas esse é um caminho de construção própria, não algo integrado.
O funding acumula em um cronograma definido pela plataforma, e nada na carteira o monitora em nome do trader. Manter uma posição alavancada ao longo de múltiplos intervalos de funding tem um custo que se acumula, conforme abordado em mecânica e timing de funding em futuros perpétuos. Um agente solicitado a verificar o funding o verificará. Um agente não solicitado não o fará.
O comportamento de margem é definido pela plataforma, não pela carteira. Para a diferença entre os dois modelos e o que cada um implica para liquidação, veja margem cruzada vs isolada no trading de perpétuos.
Hyperliquid. --venue tem como padrão hyperliquid em todo comando mm perps, e mm perps list-venues retorna a lista atual de venues suportadas.
Não diretamente. Ambos são aplicados no depósito na plataforma, pois essa é a etapa que a MetaMask processa como uma transação EVM, no modo server-wallet. Abrir, modificar e fechar uma posição acontece na própria Hyperliquid e não é verificado em relação ao limite de saída, listas de permissões, varredura de ameaças ou autenticação de 2 fatores, independentemente do tamanho da posição. Dimensionar o depósito de forma deliberada é o ponto de controle.
As duas causas mais comuns são uma conta de venue sem fundos e uma ordem abaixo do mínimo nocional de $10. O mm perps deposit preenche a primeira lacuna e o mm perps balance confirma isso. Para uma insuficiência de garantia em uma conta existente, o mm perps transfer --direction spot-to-perp move fundos do saldo spot.
Através de mm perps modify com --tp e --sl, como uma etapa separada de mm perps open. Uma posição aberta sem esse acompanhamento não terá ordens de saída vinculadas a ela.
Sim. --dex limita os mercados de perps mm, saldo, posições e ordens a uma DEX HIP-3 específica, e mm perps dexs lista os identificadores disponíveis. As leituras de saldo e posições também aceitam --all-dexes para agregar dados entre DEXs.
mm perps open --dry-run valida e pré-visualiza uma ordem totalmente especificada sem assiná-la ou enviá-la, e mm perps quote precifica uma posição em relação aos mercados ao vivo primeiro. O trading em testnet está documentado, mas ainda não é um caminho prático de simulação, já que o Agent Wallet atualmente não consegue financiar uma conta testnet da Hyperliquid.
Não como um recurso nativo. O sistema de plugins beta do Agent Wallet permite que um desenvolvedor publique um pacote npm que adiciona novos comandos à CLI, sujeito ao consentimento no momento da instalação sobre o que o plugin pode ler ou enviar — esse é o ponto de extensão para esse tipo de fluxo de trabalho personalizado atualmente.