Como pagar por APIs com x402 usando o MetaMask Agent Wallet: 8 dicas

Quando uma API, um feed de dados ou uma ferramenta MCP responde ao seu agente com 402 Payment Required, a MetaMask Agent Wallet pode pagar em USDC, sem cadastro nem chave de API. O agente lê a oferta do servidor, mostra a você o ativo, o valor, a rede e o destinatário, e assina uma autorização de pagamento única depois que você aprova. A chave privada permanece na carteira. A solicitação de assinatura também passa pela verificação de ameaças do serviço da carteira.

Aviso legal: este guia tem fins exclusivamente educacionais. Não constitui aconselhamento financeiro nem solicitação de investimento, e não se destina ao público do Reino Unido. Pagamentos em cripto feitos por agentes de IA envolvem riscos e não são adequados para todos os usuários.

Este é um guia operacional para pagar com x402 pela Agent Wallet. Para entender o que é o x402, como funciona o handshake do 402 e quem governa o protocolo, veja o que é o x402. Quem desenvolve pagamentos x402 baseados em delegação nos próprios apps deve começar pelos guias de x402 do Smart Accounts Kit. Se a Agent Wallet ainda não estiver configurada, comece pelo guia de início rápido.

Por que os agentes pagam por chamada em vez de guardar chaves de API

Uma API paga geralmente significa uma conta e uma chave de API de longa duração. Para um agente de IA, essa chave precisa ficar em algum lugar que ele consiga ler, o que a torna um alvo. Em uma pesquisa publicada em 5 de fevereiro de 2026, a Snyk analisou 3.984 skills no marketplace ClawHub e encontrou 283 skills (cerca de 7,1%) que passavam chaves de API, senhas ou números de cartão pela janela de contexto do modelo ou para arquivos de memória em texto simples, de onde um prompt injection pode extraí-los.

O x402 elimina o segredo permanente. O agente paga por requisição com uma autorização assinada para um valor exato, destinada a um recipiente específico e válida por um curto período. Com a Agent Wallet, essa assinatura vem do serviço da carteira por meio de mm wallet sign-typed-data, então o agente nunca lida com uma chave privada nem com uma chave de API. Cada autorização carrega um nonce aleatório, por isso não pode ser liquidada duas vezes. Uma visão mais ampla do que o x402 muda no comércio entre agentes, incluindo agentes que vendem serviços para outros agentes, virá em um próximo artigo.

A superfície do x402, em detalhes

O suporte ao x402 vem como um script auxiliar em Python dentro da skill metamask-agent-wallet, e não como um subcomando do mm. Seu agente o chama quando uma requisição retorna 402. Normalmente, basta você pedir em linguagem natural («Busque os dados premium nesta URL e pague se retornar 402»), e o agente executa essas etapas por você.

A referência completa está no guia de pagamentos x402 e na referência de x402 da skill.

Com esse fluxo em mente, aqui estão 9 dicas para usar pagamentos x402 pela Agent Wallet.

1. Deposite USDC na rede que o serviço pedir

O servidor decide quais ativos e redes aceita. O agente só pode pagar uma opção que o servidor oferece.

A Agent Wallet paga apenas ofertas EVM, em redes incluídas em mm chains list. Os saldos são por rede, então USDC na Ethereum não cobre uma oferta na Base. Se você tem USDC em outra rede, também pode pedir ao agente que mova os fundos para a rede necessária. O pagamento em si é uma autorização offchain, sem gas. O facilitator do serviço a liquida onchain, então sua carteira não precisa de tokens nativos para cobrir as taxas de rede do pagamento.

2. Inspecione a oferta antes de pagar

inspect lê o 402 sem assinar nem gastar nada. Ele retorna o ativo, um valor legível, a rede, o destinatário payTo e o recurso. A skill instrui o agente a mostrar esses detalhes e aguardar sua aprovação antes de executar pay, e o pay se recusa a rodar sem --confirm.

Algumas verificações são executadas antes de qualquer assinatura. A URL do recurso deve começar com https://. O script não segue redirecionamentos, então um redirecionamento entre hosts não consegue desviar um pagamento para um servidor que você não escolheu. O valor deve ser um número inteiro positivo na menor unidade do token, e o destinatário e o ativo devem ser endereços válidos. No esquema exact, o valor assinado é igual ao valor oferecido. Não é um teto até o qual o servidor pode cobrar.

3. Defina a confirmação a cada pagamento como padrão

A skill da Agent Wallet pode instruir o agente a confirmar com você, por padrão, o ativo, o valor, a rede, o destinatário e o recurso antes de cada pagamento x402. A confirmação acontece na sua conversa com o agente. Ela é separada da 2FA, que o serviço da carteira aciona apenas quando uma solicitação é sinalizada ou fica fora da sua política.

Isso funciona bem para um agente que compra um relatório de pesquisa, algumas consultas de dados ou um gift card em uma sessão. Já não é adequado para um loop que chama um endpoint pago a cada poucos segundos, porque cada chamada fica esperando por você. Uma compra com várias etapas que cobra em vários pontos pede confirmação em cada um deles.

4. Saiba o que o Guard Mode verifica em um pagamento x402

No modo de carteira de servidor, toda solicitação de assinatura vai para o serviço da carteira, que faz uma varredura de ameaças antes de assinar. Uma solicitação sinalizada fica pausada em AWAITING_MFA até você aprová-la. As autorizações x402 têm uma janela de validade curta, definida pelo servidor. Se o Guard Mode pausar a assinatura para a 2FA e você aprovar depois que a janela fechar, a autorização expira sem ser usada. Peça ao agente para executar pay novamente, o que busca um novo 402 e assina com valores novos. As aprovações chegam onde o seu método de login as envia: um link por e-mail para login com Google ou e-mail, ou o menu de notificações do MetaMask Mobile para login com QR code.

O limite contínuo de saída em 24 horas funciona de forma diferente aqui. A política de saída acompanha transferências de tokens, swaps e depósitos e, desde 27 de outubro de 2026, informa que assinaturas, como Permit2, não entram no cálculo de saída. Uma autorização x402 é uma assinatura, então o limite de 24 horas não é um teto confiável para gastos com x402. A etapa de confirmação depende de o agente seguir a skill, e o teto máximo real é o saldo de tokens da carteira pagadora. Uma forma de limitar a exposição é usar uma carteira separada, abastecida apenas para chamadas de API pagas. mm wallet create e mm wallet select gerenciam várias carteiras.

5. Escolha uma opção quando o servidor oferecer várias

Quando um 402 lista o mesmo scheme em mais de uma rede ou ativo compatível, o script para com o erro «multiple eligible options» em vez de escolher por você. Um serviço que aceita USDC tanto na Base quanto na Monad pode causar isso. Execute novamente com --network (por exemplo, eip155:8453 para a Base) ou --asset com o contrato do token. Diga ao agente em qual rede você colocou fundos, e ele poderá passar a flag logo na primeira tentativa.

6. Confirme que a oferta é uma que a Agent Wallet consegue assinar

O helper assina o scheme exact com EIP-3009 transferWithAuthorization em redes EVM, para o protocolo x402 v1 e v2. Ele retorna um erro claro e não assina nada quando encontra:

Se um serviço oferece Permit2 e EIP-3009 para o mesmo ativo, a opção EIP-3009 é a utilizada. A página de solução de problemas lista cada erro.

7. Não execute um pagamento novamente às cegas

O script não guarda registro de pagamentos anteriores. O nonce do EIP-3009 impede que a mesma autorização assinada seja liquidada duas vezes, mas cada nova execução de pay cria um novo pagamento. Se pay retornar «payment not accepted», verifique a saída da liquidação e se a janela de autorização expirou antes de tentar de novo. Uma segunda execução para o mesmo recurso é uma segunda cobrança, e o guia do x402 orienta quem faz as chamadas a se proteger contra chamadas repetidas.

8. Pague também por ferramentas MCP e endpoints POST

O x402 não se limita a requisições GET. Passe --method e --data, e o helper reenvia o mesmo corpo da requisição com o pagamento anexado, de modo que um POST pago (um endpoint de chat completion de IA, por exemplo) funciona como um download pago.

Ferramentas MCP pagas usam o transporte MCP do x402 v2. Uma chamada de ferramenta sem pagamento retorna um resultado de erro com o desafio de pagamento. O agente executa mcp-inspect, mostra a oferta para você, executa mcp-sign --confirm depois da sua aprovação e tenta de novo a chamada da ferramenta com o payload assinado em _meta["x402/payment"]. O script assina, mas não fala MCP, então a própria sessão MCP do agente entrega a nova tentativa. Se a nova tentativa voltar com outro desafio, o pagamento não foi liquidado, e o agente informa isso a você em vez de assinar novamente.

O que os agentes compram com x402

Um uso é a compra de dados: um agente de trading pode buscar sinais ou pesquisas de dev antes de agir e depois passar para swaps ou perps para a execução. Alguns serviços que aceitam x402, com detalhes extraídos da própria documentação deles em 27 de outubro de 2026:

Cada serviço define seu próprio formato de oferta, então peça ao agente que execute inspect primeiro para confirmar que a oferta é uma que a Agent Wallet consegue assinar (dica 6). Os endpoints x402 da Nansen, por exemplo, aceitam requisições POST e são compatíveis apenas com x402 v2. Um exemplo de requisição: “Busque os net flows de Smart Money da Nansen para a Ethereum. Se retornar 402, mostre o custo e pague depois que eu confirmar.” Para descobrir mais serviços x402, a x402scan é um explorador do ecossistema x402.

O que a Agent Wallet não faz com o x402

• Limitar os gastos com x402 usando o limite de saída. Por enquanto, a política de saída não inclui as assinaturas no cálculo das 24 horas.

• Assinar todas as ofertas x402. Ofertas somente Permit2, upto e não EVM são rejeitadas.

• Evitar pagamentos duplicados. Ainda não há um registro de pagamentos. Executar pay novamente paga de novo.

• Vender via x402. O helper funciona apenas para o lado do comprador. Hospedar um endpoint pago para outros agentes exige uma configuração à parte.

• Executar como um comando mm. É um script Python 3 na skill. Ele sempre exibe JSON, então --toon e --format não se aplicam.