MetaMask Agent Wallet opera en los mercados de predicción de Polymarket a través del conjunto de comandos mm predict. Un trader le pide a su agente que consulte las probabilidades, defina el monto de una apuesta, o reclame y retire sus ganancias en lenguaje natural, y el agente enruta esa solicitud a los comandos que financian una wallet de depósito dedicada, obtienen una cotización de la orden, la colocan, la canjean una vez resuelta y retiran los fondos.
Al igual que el trading de futuros perpetuos en Agent Wallet, y a diferencia de los swaps, el paso intermedio es el que ocurre fuera de los registros: colocar y cancelar una orden se ejecuta off-chain contra el libro de órdenes de límite central de Polymarket, mientras que financiar la wallet de depósito y reclamar las ganancias resueltas son las dos operaciones que se comportan como transacciones reales que MetaMask evalúa.
Esta distinción es fácil de pasar por alto en un solo prompt. "Apuesta $20 a que la Fed recorta las tasas" lleva consigo supuestos no declarados sobre el precio, el tipo de orden y cuánto debe mantenerse ese precio; supuestos que una interfaz de usuario paso a paso mostraría como pantallas separadas, pero que una frase colapsa en una sola solicitud. Este artículo cubre los detalles que vale la pena hacer explícitos antes de que un agente actúe sobre esa frase.
Esta es una guía de mecánicas de trading, no una introducción a los mercados de predicción. Para entender qué son los mercados de predicción y cómo los precios reflejan probabilidades, consulta qué es Polymarket. Para libros de órdenes, spreads, liquidez y mecánicas de resolución, consulta conceptos esenciales de mercados de predicción y cómo funciona el pricing en mercados de predicción. Para la categoría de wallet en sí, consulta qué es una agentic wallet y cómo funcionan las agentic wallets. Para la misma distinción entre depósito y orden en una clase de activo diferente, consulta cómo operar perps y cómo hacer swap y bridge de tokens con MetaMask Agent Wallet.
Vale la pena aclarar algo desde el principio: mm predict es la integración propia de Polymarket del CLI de Agent Wallet, diseñada para desarrolladores y agentes. Es un producto independiente de MetaMask Predictions, la funcionalidad orientada al consumidor integrada en MetaMask Mobile. Ambas operan en Polymarket, pero son superficies distintas con comandos diferentes, y este artículo cubre únicamente el CLI.
La superficie de mercados de predicción, desglosada
Estos son los comandos en los que se apoya un flujo de trabajo de mercados de predicción. Conocer la superficie facilita formular una solicitud que llegue tal como se pretende.
Lo que le pides a tu agente | Lo que se ejecuta | Lo que hace |
"Configúrame para operar en mercados de predicción" | mm predict setup --wait
| Configuración única de la wallet de depósito dedicada para predicciones |
"Pon $50 en mi wallet de mercados de predicción" | mm predict deposit --amount 50 --wait
| Convierte Polygon USDC.e de tu wallet en pUSD dentro de la wallet de depósito de predicciones |
"Busca mercados sobre la próxima decisión de tasas de la Fed" | mm predict markets search ""
| Busca mercados en Polymarket por palabra clave |
"Cuánto costarían 20 acciones YES en ese mercado" | mm predict quote --token-id --side buy --size 20
| Previsualiza el costo de la orden sin colocarla |
"Apuesta 10 USDC a YES a 62 centavos" | mm predict place --token-id --side buy --size 10 --price 0.62
| Coloca una orden activa en el libro de órdenes de Polymarket |
"Muéstrame mis posiciones abiertas en mercados de predicción" | mm predict positions
| Lista las tenencias actuales |
"Canjea mis apuestas ganadoras" | mm predict redeem --all --wait
| Reclama los pagos de posiciones resueltas y ganadoras |
"Mueve mis ganancias de vuelta a mi wallet" | mm predict withdraw --amount
| Retira pUSD de la wallet de depósito de predicciones |
Fuente: Referencia de comandos de MetaMask Agent Wallet.
Con esa comprensión básica, aquí tienes 9 consejos para usar MetaMask Agent Wallet en el trading de mercados de predicción.
1. Ejecuta la configuración una sola vez y luego financia una wallet separada de tu saldo spot
El trading en mercados de predicción se enruta a través de una wallet de depósito dedicada para predicciones, no a través del saldo de tu wallet principal. El flujo inicial es mm predict setup --wait, seguido de mm predict deposit --amount --wait, que convierte Polygon USDC.e almacenado en tu wallet en pUSD dentro de esa wallet de depósito. Omitir la configuración antes de depositar puede producir un escueto JsonRpcError: execution reverted en lugar de un código de error claro.
Dos modos de fallo relacionados que vale la pena reconocer: PREDICT_INSUFFICIENT_GAS significa que la wallet necesita POL nativo en Polygon para cubrir el gas de la transacción de depósito, y PREDICT_INSUFFICIENT_ALLOWANCE significa que la allowance del token debe repararse con mm predict approve antes de que un depósito o una orden pueda procesarse. Ambos están a un solo comando de resolverse, pero solo una vez identificados correctamente.
El geobloqueo también es más probable que aparezca justo aquí, antes de que se coloque una sola orden; si la región de la cuenta está restringida, setup o deposit es típicamente donde eso se manifiesta como un fallo, no más adelante en el paso de la orden. Verifica mm predict geoblock antes de financiar, no después (más en el consejo 6), y no trates un resultado null como una señal de que todo está bien: la verificación de geobloqueo puede devolver null para una cuenta restringida, y el agente no distingue de forma confiable eso de un resultado explícitamente libre hoy en día, aunque operacionalmente signifique lo mismo. Trata un resultado poco claro igual que uno bloqueado hasta que se confirme lo contrario.
2. Ten en cuenta que la orden, no el depósito ni el canje, es lo que queda fuera del radar del Guard Mode
Este es el mismo patrón que el trading de futuros perpetuos en Agent Wallet, no el patrón de los swaps; pero en los mercados de predicción es el paso intermedio el que es off-chain, no solo uno de los extremos. La política de salida de MetaMask nombra "depósitos (por ejemplo, a Uniswap, Polymarket o Hyperliquid)" como lo que cuenta para el límite de salida acumulado en 24 horas; Polymarket se menciona por nombre, igual que Hyperliquid. Eso significa que la transacción de financiamiento hacia la wallet de depósito de predicciones es lo que el límite de salida del Guard Mode, las listas de permitidos y la autenticación de dos factores evalúan. mm predict place y mm predict cancel son llamadas síncronas contra el libro de órdenes de Polymarket, no transacciones EVM, por lo que no se verifican contra esas salvaguardas independientemente del tamaño.
El canje merece mencionarse por separado: mm predict redeem está documentado con --wait, el mismo patrón basado en jobs que se usa para mm predict setup y mm predict deposit, que la página de arquitectura describe como la firma de una solicitud de firma o transacción que pasa por simulación, análisis de amenazas y evaluación de políticas. Eso es una señal clara de que reclamar una posición resuelta es una transacción real on-chain, no una acción off-chain en el libro de órdenes como colocar o cancelar; así que trata el paso de canje con el mismo cuidado que el depósito, no de la misma manera que una orden.
El análisis de amenazas es la única salvaguarda que no se divide por tramo de la misma manera que el límite de salida: se aplica tanto en Guard Mode como en Beast Mode, según la comparación de modos de trading; solo el límite de salida y las listas de permitidos son exclusivos del Guard Mode. Esto aplica al modo server-wallet; los modos de trading no aplican a configuraciones bring-your-own-wallet. La conclusión práctica: un trader que dimensiona una sola orden no necesita pensar en el límite de salida en el momento de colocarla, pero financiar la wallet de depósito y luego canjear una ganancia son los dos momentos en que esa disciplina sigue aplicando.
3. --limit-price previsualiza, --price coloca; no son intercambiables
mm predict quote acepta un --limit-price opcional para previsualizar el costo a un precio específico. mm predict place no acepta ese flag en absoluto; requiere --price, el precio de ejecución más desfavorable por acción que un trader aceptará, en una escala de 0 a 1. Se parecen y ambos influyen en el costo, pero uno es una entrada solo de previsualización y el otro es el límite de ejecución de una orden activa; copiar los flags de una cotización directamente en un comando de colocación fallará en lugar de hacer silenciosamente lo mismo.
4. Anula el tick size solo cuando el valor predeterminado no se ajusta
Tanto mm predict quote como mm predict place aceptan --tick-size para anular el incremento de precio predeterminado de un mercado. Los valores válidos son 0.1, 0.01, 0.005, 0.0025, 0.001 y 0.0001; omitir el flag usa por defecto el tick size propio del CLOB para ese token. Pasar cualquier valor fuera de esa lista devuelve INVALID_TICK_SIZE. Para la mayoría de los mercados, el valor predeterminado es la opción correcta; este flag existe para los casos en que un trader necesita una granularidad de precio más fina o más gruesa que la que permite el valor predeterminado del mercado.
5. Elige el tipo de orden según la urgencia con que necesitas que se ejecute
mm predict place usa por defecto GTC (good-till-cancelled), que permanece en el libro hasta que se ejecuta o se cancela. GTD (good-till-date) requiere un timestamp de --expiration. FOK (fill-or-kill) y FAK (fill-and-kill) exigen una ejecución inmediata; FOK todo o nada, FAK por lo que se ejecute de inmediato con el resto cancelado; y ninguno puede combinarse con --post-only, que por su parte rechaza cualquier orden que cruce el libro.
Una orden FOK que no puede ejecutarse completamente al precio solicitado devuelve PREDICT_ORDER_NOT_FILLED, con una sugerencia de ajustar --size o --price, revisar el libro o cambiar a GTC. Un prompt como "compra esto solo si puedes ejecutar la orden completa ahora mismo" está pidiendo FOK; "méteme en esta posición eventualmente, a este precio o mejor" está pidiendo GTC, y confundir ambos produce una orden rechazada en lugar de la paciencia que el trader realmente quería.
6. Verifica la liquidez y el geobloqueo antes de dimensionar una apuesta, no después
mm predict book devuelve el libro de órdenes de un token, que es la forma de ver si un tamaño determinado es realista antes de colocarlo; PREDICT_ORDER_SIZE_TOO_SMALL se activa cuando una solicitud cae por debajo del mínimo del exchange, y su sugerencia apunta a aumentar --size.
Por otro lado, mm predict geoblock verifica el estado de geobloqueo de Polymarket para la IP de la cuenta antes de que se mueva cualquier dinero. Dos códigos de error reflejan que esta verificación ocurre en la capa de Polymarket, no en la capa de la wallet: PREDICT_GEOBLOCKED cuando la región está bloqueada según la API de geobloqueo, y PREDICT_UNAVAILABLE_FOR_LEGAL_REASONS cuando Polymarket devuelve un HTTP 451 de restricción legal. Ninguno es una decisión de política de MetaMask ni algo que cambie el Guard Mode frente al Beast Mode; es la disponibilidad regional propia de Polymarket, expuesta a través del CLI.
7. No hay ejecución de prueba; una cotización es la previsualización más cercana
A diferencia de mm perps open, que acepta --dry-run para validar una orden sin firmarla, mm predict place no tiene un flag equivalente en la referencia de comandos. Lo más parecido a ensayar una orden es mm predict quote, que previsualiza el costo a un precio y tamaño dados sin tocar el libro. Eso es una previsualización genuina del precio, no una simulación de si la orden se ejecutaría; una cotización puede verse correcta y el mercado puede moverse antes de que la llamada real a place llegue.
8. El canje es un paso separado y explícito, y es la segunda transacción real del flujo de trabajo
Una posición resuelta y ganadora no se convierte en saldo disponible en un solo paso. mm predict redeem list muestra qué posiciones resueltas son actualmente canjeables, y mm predict redeem --wait o mm predict redeem --all --wait reclama una o todas ellas; pero eso solo mueve las ganancias a pUSD dentro de la wallet de depósito de predicciones, no de vuelta a la wallet principal del trader. PREDICT_REDEEM_NONE y PREDICT_REDEEM_NOT_FOUND son los dos códigos de error que vale la pena reconocer aquí: el primero significa que actualmente no hay nada canjeable, y el segundo significa que el condition ID específico pasado no es un objetivo de canje válido; generalmente es señal de revisar redeem list nuevamente en lugar de reintentar con el mismo ID.
Sacar ese pUSD al saldo disponible es un paso adicional y separado: mm predict withdraw --amount . Omitirlo después de canjear es una forma común de pensar que una apuesta se ha "cobrado" cuando las ganancias siguen dentro de la wallet de predicciones. PREDICT_WITHDRAW_ZERO se activa con un monto cero o faltante, y PREDICT_WITHDRAW_INSUFFICIENT_BALANCE se activa cuando la wallet de predicciones no tiene suficiente pUSD para cubrir el retiro solicitado.
El canje, al igual que el depósito, se comporta como una transacción real en lugar de una acción off-chain en el libro de órdenes; está documentado con el mismo patrón de job --wait que mm predict setup y mm predict deposit, a diferencia de mm predict place o mm predict cancel, que nunca lo usan. Trátalo con el mismo cuidado descrito en el consejo 2.
9. Usa history y positions para tareas distintas, y ajusta el campo de ordenamiento a la consulta
mm predict positions muestra lo que está actualmente abierto. mm predict history es una vista separada de posiciones cerradas: por defecto muestra posiciones cerradas con pnl firmado, y cambiar a --type trade o --type redeem muestra la actividad de ejecución o reclamación en su lugar. --start y --end solo filtran cuando --type es trade o redeem; son silenciosamente inaplicables a la vista cerrada predeterminada. Los campos de ordenamiento también son específicos por tipo: las posiciones cerradas se ordenan por realizedpnl, title, price, avgprice o timestamp, mientras que la actividad de trade y redeem se ordena por timestamp, tokens o cash. Pasar un campo de ordenamiento de la lista incorrecta devuelve PREDICT_HISTORY_INVALID_SORT_BY; una solicitud de "mis mayores ganancias, ordenadas por tamaño" necesita especificar cuál de esos dos vocabularios pretende usar.
Lo que Agent Wallet no hace en los mercados de predicción
Ser claro sobre los límites es más útil que insinuar uno más amplio.
mm predict no es la funcionalidad de Predictions para consumidores de MetaMask en Mobile; es una integración separada con Polymarket impulsada por CLI, diseñada para desarrolladores y agentes, con sus propios comandos y su propia wallet de depósito dedicada. Un trader que viene de la app Mobile no debería esperar que ambas compartan saldos, historial o configuraciones.
Agent Wallet no omite ni anula las restricciones regionales de Polymarket. Las verificaciones de geobloqueo y disponibilidad legal ocurren en la capa de Polymarket y se aplican de la misma manera independientemente del modo de wallet, el modo de trading o cómo se formule la solicitud.
Las ganancias no se canjean automáticamente al resolverse. Una posición resuelta y ganadora permanece como canjeable hasta que se ejecute mm predict redeem; no hay ningún proceso en segundo plano que la reclame en nombre del trader.
No hay copy-trading integrado, espejado de portafolio ni lógica de órdenes personalizada incorporada sobre mm predict; cada llamada a un comando es una acción única y explícita. Los traders que quieran una lógica permanente de ese tipo pueden construirla como un plugin, una funcionalidad en beta que permite que un paquete npm instalado agregue nuevos comandos al CLI bajo capacidades con consentimiento controlado, pero eso es un camino de construcción propia y no algo que Agent Wallet incluya de serie.
No. Ambos operan en Polymarket, pero son productos distintos. MetaMask Predictions es la función para usuarios integrada en MetaMask Mobile; mm predict es el conjunto de comandos propio del Agent Wallet CLI para desarrolladores y agentes, con una wallet de depósito independiente y sin saldos ni historial compartidos con la función de Mobile.
No. Tanto colocar como cancelar una orden en un mercado de predicciones ocurre off-chain contra el libro de órdenes de Polymarket, por lo que no se evalúa frente al límite de salida de Guard Mode, las listas de permitidos ni el 2FA. La transacción EVM que sí pasa por esos controles es la que financia la wallet de depósito, el mismo patrón que los futuros perpetuos, y lo opuesto a los swaps, donde la propia operación es la transacción verificada. Canjear una posición resuelta se comporta como una segunda transacción real en lugar de una acción del libro de órdenes (está documentada con el mismo patrón de trabajo --wait que el depósito), por lo que merece el mismo cuidado, aunque en sí misma no esté sujeta al límite de salida, que rastrea el valor que sale de la wallet y no las ganancias que entran.
--limit-price es un indicador exclusivo de vista previa en mm predict quote. mm predict place no lo acepta en absoluto; requiere --price, el precio de ejecución más desfavorable por acción que la orden aceptará. No son indicadores intercambiables, aunque ambos influyen en el costo de una operación.
GTC (el predeterminado) permanece en el libro de órdenes hasta que se ejecuta o se cancela, y es adecuado para un trader dispuesto a esperar por un precio. GTD añade una fecha de vencimiento. FOK y FAK exigen una ejecución inmediata y son ideales para un trader que solo quiere operar si la transacción puede realizarse en ese momento. --post-only rechaza una orden que cruzaría el libro de órdenes y no puede combinarse con FOK ni FAK.
Ejecuta mm predict geoblock para verificar la IP de la cuenta contra el estado de geobloqueo de Polymarket antes de financiar cualquier cosa. PREDICT_GEOBLOCKED y PREDICT_UNAVAILABLE_FOR_LEGAL_REASONS reflejan restricciones aplicadas en la capa de Polymarket, no una configuración de la wallet de MetaMask.
No, y canjear tampoco es el último paso. Una posición ganadora resuelta pasa a ser canjeable, pero no se reclama automáticamente: ejecuta mm predict redeem list para ver qué es canjeable en este momento, luego mm predict redeem <CONDITION_ID> --wait o --all --wait para reclamarlo. Esto convierte la posición en pUSD dentro de la billetera de depósito de predict, no en saldo disponible en la billetera principal del trader. Para transferirlo allí se necesita una llamada adicional a mm predict withdraw --amount .
Más parecido al depósito. mm predict withdraw sigue el mismo patrón basado en trabajos que mm predict setup, mm predict deposit y mm predict redeem, a diferencia de mm predict place y mm predict cancel, que son llamadas síncronas contra el order book de Polymarket. PREDICT_WITHDRAW_ZERO y PREDICT_WITHDRAW_INSUFFICIENT_BALANCE son sus dos códigos de error específicos.
No directamente. mm predict place no tiene un equivalente a --dry-run. mm predict quote es la vista previa más cercana disponible: calcula el precio de una orden para un tamaño y precio determinados sin afectar el libro de órdenes, aunque no simula si la orden se ejecutaría realmente.