Como negociar mercados de previsão com o MetaMask Agent Wallet: 9 dicas essenciais

MetaMask Agent Wallet negocia mercados de previsão da Polymarket por meio do conjunto de comandos mm predict. Um trader pede ao seu agente para verificar as odds, dimensionar uma aposta ou resgatar e sacar os ganhos em linguagem natural, e o agente direciona essa solicitação para os comandos que financiam uma carteira de depósito dedicada, cotam uma ordem, a executam, a resgatam após a resolução e retiram os recursos.

Assim como nas negociações de futuros perpétuos no Agent Wallet, e ao contrário dos swaps, a etapa intermediária é a que acontece fora dos registros: a colocação e o cancelamento de uma ordem ocorrem off-chain no livro de ordens de limite central da Polymarket, enquanto o financiamento da carteira de depósito e o resgate dos ganhos resolvidos são as duas etapas que se comportam como transações reais avaliadas pela MetaMask.

Essa divisão é fácil de ignorar em um único prompt. "Aposte $20 no Fed cortando as taxas" carrega premissas não declaradas sobre preço, tipo de ordem e o quão firme esse preço precisa se manter — premissas que uma interface navegada manualmente exibiria como telas separadas, mas que uma frase condensa em uma única solicitação. Este artigo aborda os detalhes que vale a pena tornar explícitos antes que um agente aja com base nessa frase.

Este é um guia de mecânica de negociação, não uma introdução aos mercados de previsão. Para entender o que são mercados de previsão e como os preços refletem probabilidades, veja o que é a Polymarket. Para livros de ordens, spreads, liquidez e mecânicas de resolução, veja conceitos essenciais de mercados de previsão e como funciona a precificação em mercados de previsão. Para a categoria de carteira em si, veja o que é uma carteira agêntica e como carteiras agênticas funcionam. Para a mesma distinção entre depósito e ordem em uma classe de ativos diferente, veja como negociar perps e como fazer swap e bridge de tokens com o MetaMask Agent Wallet.

Uma distinção importante desde o início: mm predict é a integração própria da CLI do Agent Wallet com a Polymarket, desenvolvida para desenvolvedores e agentes. É um produto separado do MetaMask Predictions, o recurso voltado ao consumidor integrado ao MetaMask Mobile. Ambos negociam na Polymarket, mas são interfaces diferentes com comandos diferentes, e este artigo cobre apenas a CLI.

A interface de mercados de previsão, detalhada

Estes são os comandos em que um fluxo de trabalho de mercado de previsão se apoia. Conhecer a interface facilita formular uma solicitação que funcione da forma pretendida.

Fonte: Referência de comandos do MetaMask Agent Wallet.

Com esse entendimento básico, aqui estão 9 dicas para usar o MetaMask Agent Wallet para negociar mercados de previsão.

1. Execute o setup uma vez e, em seguida, financie uma carteira separada do seu saldo spot

As negociações em mercados de previsão são roteadas por uma carteira de depósito de previsão dedicada, não pelo saldo da sua carteira principal. O fluxo inicial é mm predict setup --wait, seguido de mm predict deposit --amount --wait, que converte Polygon USDC.e mantido na sua carteira em pUSD dentro dessa carteira de depósito. Pular o setup antes de depositar pode gerar um simples JsonRpcError: execution reverted em vez de um código de erro claro.

Dois modos de falha relacionados que vale reconhecer: PREDICT_INSUFFICIENT_GAS significa que a carteira precisa de POL nativo na Polygon para cobrir o gas da transação de depósito, e PREDICT_INSUFFICIENT_ALLOWANCE significa que a permissão do token precisa ser corrigida com mm predict approve antes que um depósito ou ordem possa ser processado. Ambos estão a um único comando de serem resolvidos, mas somente após serem identificados corretamente.

O geobloqueio também tende a aparecer aqui, antes que qualquer ordem seja colocada — se a região da conta for restrita, setup ou deposit é tipicamente onde isso se manifesta como falha, não na etapa de ordem. Verifique mm predict geoblock antes de financiar, não depois (mais detalhes na dica 6), e não trate um resultado null como sinal de liberação: a verificação de geobloqueio pode retornar null para uma conta restrita, e o agente não distingue isso de forma confiável de uma liberação explícita hoje, mesmo que operacionalmente signifique a mesma coisa. Trate um resultado ambíguo da mesma forma que um bloqueado, até que seja confirmado o contrário.

2. Saiba que a ordem, não o depósito ou o resgate, é o que fica fora do radar do Guard Mode

Esse é o mesmo padrão das negociações de futuros perpétuos no Agent Wallet, não o padrão dos swaps — mas nos mercados de previsão é a etapa intermediária que é off-chain, não apenas uma das pontas. A política de saída da MetaMask nomeia "depósitos (por exemplo, para Uniswap, Polymarket ou Hyperliquid)" como o que conta para o limite de saída acumulado em 24 horas — a Polymarket é citada pelo nome, da mesma forma que a Hyperliquid. Isso significa que a transação de financiamento na carteira de depósito de previsão é o que o limite de saída do Guard Mode, as listas de permissões e a autenticação de dois fatores avaliam. mm predict place e mm predict cancel são chamadas síncronas ao livro de ordens da Polymarket, não transações EVM — portanto, não são verificadas por essas proteções, independentemente do tamanho.

O resgate merece ser destacado separadamente: mm predict redeem é documentado com --wait, o mesmo padrão baseado em jobs usado para mm predict setup e mm predict deposit, que a página de arquitetura descreve como a assinatura de uma solicitação de assinatura ou transação que passa por simulação, varredura de ameaças e avaliação de política. Isso é um forte indicativo de que reivindicar uma posição resolvida é uma transação real on-chain, não uma ação off-chain no livro de ordens como colocar ou cancelar — portanto, trate a etapa de resgate com o mesmo cuidado que o depósito, não da mesma forma que uma ordem.

A varredura de ameaças é a única proteção que não se divide por etapa da forma que o limite de saída faz: ela se aplica tanto no Guard Mode quanto no Beast Mode, conforme a comparação de modos de negociação — apenas o limite de saída e as listas de permissões são exclusivos do Guard Mode. Isso se aplica ao modo de carteira de servidor; os modos de negociação não se aplicam a configurações com carteira própria (bring-your-own-wallet). A conclusão prática: um trader dimensionando uma única ordem não precisa pensar no limite de saída no momento de colocá-la, mas financiar a carteira de depósito e, posteriormente, resgatar um ganho são os dois momentos em que essa disciplina ainda se aplica.

3. --limit-price é para visualização, --price é para execução — eles não são intercambiáveis

mm predict quote aceita um --limit-price opcional para visualizar o custo a um preço específico. mm predict place não aceita esse parâmetro; ele requer --price, o pior preço de preenchimento por cota que um trader aceitará, em uma escala de 0 a 1. Eles parecem similares e ambos influenciam o custo, mas um é uma entrada exclusiva de visualização e o outro é o limite de execução de uma ordem ativa — copiar os parâmetros de uma cotação diretamente em um comando de colocação falhará em vez de silenciosamente fazer a mesma coisa.

4. Substitua o tamanho do tick apenas quando o padrão não for adequado

Tanto mm predict quote quanto mm predict place aceitam --tick-size para substituir o incremento de preço padrão de um mercado. Os valores válidos são 0.1, 0.01, 0.005, 0.0025, 0.001 e 0.0001; omitir o parâmetro usa o tick size padrão do CLOB para aquele token. Passar qualquer valor fora dessa lista retorna INVALID_TICK_SIZE. Para a maioria dos mercados, o padrão é a escolha certa — esse parâmetro existe para os casos em que um trader precisa de granularidade de preço mais fina ou mais grossa do que o padrão do mercado permite.

5. Combine o tipo de ordem com a urgência de preenchimento

mm predict place usa GTC (good-till-cancelled) por padrão, que permanece no livro até ser preenchido ou cancelado. GTD (good-till-date) requer um timestamp de --expiration. FOK (fill-or-kill) e FAK (fill-and-kill) exigem preenchimento imediato — FOK tudo ou nada, FAK para o que for preenchido imediatamente com o restante cancelado — e nenhum dos dois pode ser combinado com --post-only, que separadamente rejeita uma ordem que cruzaria o livro.

Uma ordem FOK que não puder ser totalmente preenchida ao preço solicitado retorna PREDICT_ORDER_NOT_FILLED, com uma sugestão para ajustar --size ou --price, verificar o livro ou mudar para GTC. Um prompt como "compre isso somente se puder preencher tudo agora" está pedindo FOK; "entre nessa posição eventualmente, a esse preço ou melhor" está pedindo GTC, e confundir os dois gera uma ordem rejeitada em vez da paciência que o trader realmente queria.

6. Verifique a liquidez e o geobloqueio antes de dimensionar uma aposta, não depois

mm predict book retorna o livro de ordens de um token, que é a forma de verificar se um determinado tamanho é realista antes de colocá-lo — PREDICT_ORDER_SIZE_TOO_SMALL é acionado quando uma solicitação fica abaixo do mínimo da exchange, e sua sugestão aponta para aumentar --size.

Separadamente, mm predict geoblock verifica o status de geobloqueio da Polymarket para o IP da conta antes de qualquer movimentação de dinheiro. Dois códigos de erro refletem essa verificação acontecendo na camada da Polymarket, não na camada da carteira: PREDICT_GEOBLOCKED quando a região está bloqueada pela API de geobloqueio, e PREDICT_UNAVAILABLE_FOR_LEGAL_REASONS quando a Polymarket retorna uma restrição legal HTTP 451. Nenhum deles é uma decisão de política da MetaMask ou algo que o Guard Mode versus Beast Mode altera — é a disponibilidade regional da própria Polymarket, exposta pela CLI.

7. Não há simulação — uma cotação é a visualização mais próxima

Ao contrário de mm perps open, que aceita --dry-run para validar uma ordem sem assiná-la, mm predict place não tem um parâmetro equivalente na referência de comandos. A coisa mais próxima de ensaiar uma ordem é mm predict quote, que visualiza o custo a um determinado preço e tamanho sem tocar no livro. Isso é uma visualização genuína de precificação, não uma simulação de se a ordem seria preenchida — uma cotação pode parecer correta e o mercado ainda pode se mover antes que a chamada real de place seja executada.

8. O resgate é uma etapa separada e explícita — e é a segunda transação real no fluxo de trabalho

Uma posição resolvida e vencedora não se converte em saldo disponível em uma única etapa. mm predict redeem list mostra quais posições resolvidas são atualmente resgatáveis, e mm predict redeem --wait ou mm predict redeem --all --wait reivindica uma ou todas elas — mas isso apenas move os ganhos para pUSD dentro da carteira de depósito de previsão, não de volta para a carteira principal do trader. PREDICT_REDEEM_NONE e PREDICT_REDEEM_NOT_FOUND são os dois códigos de erro que vale reconhecer aqui: o primeiro significa que nada é atualmente resgatável, e o segundo significa que o condition ID específico passado não é um alvo de resgate válido — geralmente um sinal para verificar redeem list novamente em vez de tentar o mesmo ID.

Transferir esse pUSD para o saldo disponível é uma etapa adicional e separada: mm predict withdraw --amount . Pular isso após o resgate é uma forma comum de achar que uma aposta foi "sacada" quando os ganhos ainda estão na carteira de previsão. PREDICT_WITHDRAW_ZERO é acionado com um valor zero ou ausente, e PREDICT_WITHDRAW_INSUFFICIENT_BALANCE é acionado quando a carteira de previsão não tem pUSD suficiente para cobrir o saque solicitado.

O resgate, assim como o depósito, se comporta como uma transação real em vez de uma ação off-chain no livro de ordens — é documentado com o mesmo padrão de job --wait que mm predict setup e mm predict deposit, ao contrário de mm predict place ou mm predict cancel, que nunca o utilizam. Trate-o com o mesmo cuidado descrito na dica 2.

9. Use histórico e posições para finalidades diferentes, e combine o campo de ordenação com a consulta

mm predict positions mostra o que está atualmente aberto. mm predict history é uma visão separada de posições fechadas: por padrão exibe posições fechadas com pnl assinado, e mudar para --type trade ou --type redeem mostra atividade de preenchimento ou reivindicação. --start e --end só filtram quando --type é trade ou redeem — eles são silenciosamente inaplicáveis à visão padrão de posições fechadas. Os campos de ordenação também são específicos por tipo: posições fechadas ordenam por realizedpnl, title, price, avgprice ou timestamp, enquanto atividades de trade e redeem ordenam por timestamp, tokens ou cash. Passar um campo de ordenação da lista errada retorna PREDICT_HISTORY_INVALID_SORT_BY — uma solicitação de "minhas maiores vitórias, ordenadas por tamanho" precisa especificar qual desses dois vocabulários ela usa.

O que o Agent Wallet não faz para mercados de previsão

Ser claro sobre os limites é mais útil do que sugerir um escopo mais amplo.

mm predict não é o recurso Predictions para consumidores da MetaMask no Mobile — é uma integração separada, orientada por CLI, com a Polymarket, desenvolvida para desenvolvedores e agentes, com seus próprios comandos e sua própria carteira de depósito dedicada. Um trader vindo do aplicativo Mobile não deve esperar que os dois compartilhem saldos, histórico ou configurações.

O Agent Wallet não contorna nem substitui as restrições regionais da Polymarket. As verificações de geobloqueio e disponibilidade legal acontecem na camada da Polymarket e se aplicam da mesma forma independentemente do modo de carteira, modo de negociação ou como a solicitação é formulada.

Os ganhos não são resgatados automaticamente na resolução. Uma posição resolvida e vencedora fica como resgatável até que mm predict redeem seja executado — não há varredura em segundo plano que a reivindique em nome do trader.

Não há copy-trading integrado, espelhamento de portfólio ou lógica de ordem personalizada sobre mm predict — cada chamada de comando é uma ação única e explícita. Traders que desejam uma lógica permanente como essa podem construí-la como um plugin, um recurso em beta que permite que um pacote npm instalado adicione novos comandos à CLI sob capacidades com consentimento, mas esse é um caminho de construção própria, não algo que o Agent Wallet já oferece.