Cómo pagar APIs con x402 usando MetaMask Agent Wallet: 8 consejos

Cuando una API, un feed de datos o una herramienta MCP responde a tu agente con 402 Payment Required, MetaMask Agent Wallet puede pagarlo en USDC sin registro ni clave de API. El agente lee la oferta del servidor, te muestra el activo, el monto, la red y el destinatario, y firma una autorización de pago de un solo uso después de que la apruebes. La clave privada permanece en la wallet. La solicitud de firma también pasa por el análisis de amenazas del servicio de la wallet.

Aviso legal: esta guía tiene fines exclusivamente educativos. No constituye asesoramiento financiero ni una solicitud de inversión, y no está dirigida a audiencias del Reino Unido. Los pagos con criptomonedas realizados por agentes de IA conllevan riesgos y no son adecuados para todos los usuarios.

Esta es una guía operativa para pagar con x402 a través de Agent Wallet. Para saber qué es x402, cómo funciona el handshake 402 y quién gobierna el protocolo, consulta qué es x402. Los desarrolladores que quieran integrar pagos x402 basados en delegación en sus propias apps deberían empezar con las guías x402 del Smart Accounts Kit. Si aún no has configurado Agent Wallet, empieza con la guía de inicio rápido.

Por qué los agentes pagan por llamada en lugar de guardar claves de API

Una API de pago suele implicar una cuenta y una clave de API de larga duración. En el caso de un agente de IA, esa clave tiene que estar en un lugar al que el agente pueda acceder, lo que la convierte en un objetivo. En una investigación publicada el 5 de febrero de 2026, Snyk analizó 3984 skills del marketplace ClawHub y encontró 283 skills (cerca del 7,1 %) que hacían pasar claves de API, contraseñas o números de tarjeta por la ventana de contexto del modelo o los guardaban en archivos de memoria en texto plano, de donde una inyección de prompts puede extraerlos de nuevo.

x402 elimina el secreto permanente. El agente paga por cada solicitud con una autorización firmada por un monto exacto a un destinatario específico, válida durante un periodo breve. Con Agent Wallet, esa firma proviene del servicio de la wallet mediante mm wallet sign-typed-data, por lo que el agente nunca maneja una clave privada ni una clave de API. Cada autorización incluye un nonce aleatorio, de modo que no puede liquidarse dos veces. Un análisis más amplio de lo que x402 cambia en el comercio entre agentes, incluidos los agentes que venden servicios a otros agentes, llegará en un próximo artículo.

La superficie de x402, desglosada

El soporte de x402 se incluye como un script auxiliar de Python dentro del skill metamask-agent-wallet, no como un subcomando de mm. Tu agente lo llama cuando una solicitud devuelve 402. Normalmente basta con pedírselo en lenguaje natural («Obtén los datos premium de esta URL y paga si devuelve 402»), y el agente ejecuta estos pasos por ti.

La referencia completa está en la guía de pagos x402 y en la referencia de x402 del skill.

Con este flujo en mente, aquí tienes 9 consejos para usar pagos x402 a través de Agent Wallet.

1. Deposita USDC en la red que pide el servicio

El servidor decide qué activos y redes acepta. El agente solo puede pagar una opción que el servidor ofrezca.

Agent Wallet solo paga ofertas EVM, en las redes que incluye mm chains list. Los saldos son por cadena, así que el USDC en Ethereum no cubrirá una oferta en Base. Si tienes fondos en USDC en otra cadena, también puedes pedirle al agente que los mueva a la cadena requerida. El pago en sí es una autorización offchain sin gas. El facilitator del servicio la liquida onchain, por lo que tu wallet no necesita tokens nativos para cubrir las comisiones de red del pago.

2. Inspecciona la oferta antes de pagar

inspect lee el 402 sin firmar ni gastar. Devuelve el activo, un monto legible, la red, el destinatario payTo y el recurso. El skill le indica al agente que te muestre esos detalles y espere tu aprobación antes de ejecutar pay, y pay se niega a ejecutarse sin --confirm.

Antes de firmar nada se realizan varias comprobaciones. La URL del recurso debe ser https://. El script no sigue redirecciones, por lo que una redirección entre hosts no puede desviar un pago a un servidor que no elegiste. El monto debe ser un número entero positivo de la unidad más pequeña del token, y el destinatario y el activo deben ser direcciones válidas. En el esquema exact, el monto firmado es igual al monto ofrecido. No es un tope hasta el cual el servidor pueda cobrar.

3. Establece como predeterminada una confirmación para cada pago

La skill de Agent Wallet puede indicarle al agente que confirme contigo el activo, el importe, la red, el destinatario y el recurso antes de cada pago x402, de forma predeterminada. La confirmación se realiza en tu conversación con el agente. Es independiente de la 2FA, que el servicio de wallet activa solo cuando se marca una solicitud o esta queda fuera de tu política.

Esto encaja con un agente que compra un informe de investigación, algunas consultas de datos o una tarjeta regalo en una sesión. No es adecuado para un bucle que llama a un endpoint de pago cada pocos segundos, porque cada llamada espera tu respuesta. Una compra de varios pasos que cobra en varias etapas te pedirá confirmación en cada una.

4. Conoce qué comprueba Guard Mode en un pago x402

En el modo de wallet de servidor, cada solicitud de firma se envía al servicio de wallet, que realiza un análisis de amenazas antes de firmar. Una solicitud marcada se pausa en AWAITING_MFA hasta que la apruebes. Las autorizaciones x402 tienen una ventana de validez corta establecida por el servidor. Si Guard Mode pausa la firma para solicitar la 2FA y apruebas después de que se cierre la ventana, la autorización caduca sin usarse. Pide al agente que vuelva a ejecutar pay, que obtiene un nuevo 402 y firma valores nuevos. Las aprobaciones llegan por el medio que corresponda a tu método de inicio de sesión: un enlace por correo electrónico si usas Google o correo electrónico, o el menú de notificaciones de MetaMask Mobile si usas el inicio de sesión con QR.

El límite de salidas acumuladas en 24 horas funciona de otra manera aquí. La política de salidas contabiliza transferencias de tokens, swaps y depósitos, y a fecha del 27 de octubre de 2026 indica que las firmas, como Permit2, no se incluyen en el cálculo de salidas. Una autorización x402 es una firma, por lo que el límite de 24 horas no es un tope fiable para el gasto en x402. El paso de confirmación depende de que el agente siga la skill, y el límite máximo real es el saldo de tokens de la wallet que paga. Una forma de limitar la exposición es usar una wallet independiente, financiada solo para llamadas a APIs de pago. mm wallet create y mm wallet select sirven para gestionar varias wallets.

5. Elige una opción cuando el servidor ofrezca varias

Cuando un 402 enumera el mismo esquema en más de una red o activo compatible, el script se detiene con un error de «multiple eligible options» en lugar de elegir por ti. Un servicio que acepta USDC tanto en Base como en Monad puede provocarlo. Vuelve a ejecutarlo con --network (por ejemplo, eip155:8453 para Base) o con --asset y el contrato del token. Indica al agente en qué red has depositado fondos y podrá pasar la opción correcta al primer intento.

6. Comprueba que Agent Wallet pueda firmar la oferta

El helper firma el esquema exact con EIP-3009 transferWithAuthorization en redes EVM, para las versiones 1 y 2 del protocolo x402. Devuelve un error claro y no firma nada cuando detecta lo siguiente:

Si un servicio ofrece tanto Permit2 como EIP-3009 para el mismo activo, se usa la opción EIP-3009. La página de solución de problemas enumera cada error.

7. No vuelvas a ejecutar un pago a ciegas

El script no guarda ningún registro de los pagos anteriores. El nonce de EIP-3009 impide que la misma autorización firmada se liquide dos veces, pero cada nueva ejecución de pay crea un pago nuevo. Si pay devuelve «payment not accepted», revisa el resultado de la liquidación y comprueba si la ventana de autorización expiró antes de intentarlo de nuevo. Una segunda ejecución para el mismo recurso supone un segundo cobro, y la guía de x402 indica a quienes realizan las llamadas que se protejan contra llamadas repetidas.

8. Paga también por herramientas MCP y endpoints POST

x402 no se limita a las solicitudes GET. Si pasas --method y --data, el helper reproduce el mismo cuerpo de la solicitud con el pago adjunto, de modo que un POST de pago (un endpoint de chat completion de IA, por ejemplo) funciona igual que una descarga de pago.

Las herramientas MCP de pago usan el transporte MCP de x402 v2. Una llamada a una herramienta sin pagar devuelve un resultado de error con el desafío de pago. El agente ejecuta mcp-inspect, te muestra la oferta, ejecuta mcp-sign --confirm después de que apruebes y reintenta la llamada a la herramienta con el payload firmado en _meta["x402/payment"]. El script firma, pero no habla MCP, así que es la propia sesión MCP del agente la que envía el reintento. Si el reintento devuelve otro desafío, el pago no se liquidó, y el agente te lo comunica en lugar de volver a firmar.

Qué compran los agentes con x402

Un uso son los datos de pago: un agente de trading puede obtener señales o investigación sobre desarrolladores antes de actuar y luego pasar a swaps o perps para la ejecución. Algunos servicios que aceptan x402, con datos de su propia documentación a fecha del 27 de octubre de 2026:

Cada servicio define su propio formato de oferta, así que pide al agente que ejecute primero inspect para confirmar que Agent Wallet puede firmar la oferta (consejo 6). Por ejemplo, los endpoints x402 de Nansen aceptan solicitudes POST y solo admiten x402 v2. Un ejemplo de solicitud: «Obtén los flujos netos de Smart Money de Nansen para Ethereum. Si devuelve 402, muéstrame el costo y paga cuando yo confirme». Para descubrir más servicios x402, x402scan es un explorador del ecosistema x402.

Lo que Agent Wallet no hace con x402

• Limitar el gasto de x402 con el límite de salidas. Por ahora, la política de salidas excluye las firmas del cálculo de 24 horas.

• Firmar todas las ofertas x402. Las ofertas solo Permit2, upto y no EVM se rechazan.

• Evitar pagos duplicados. Todavía no hay un registro de pagos. Si vuelves a ejecutar pay, se paga de nuevo.

• Vender a través de x402. El helper es solo para compradores. Alojar un endpoint de pago para otros agentes requiere una configuración aparte.

• Ejecutarse como un comando mm. Es un script de Python 3 incluido en la skill. Siempre imprime JSON, por lo que --toon y --format no se aplican.