Circle在9月9日开放Agent Marketplace的Discovery API。开发者无需API密钥、认证或Circle账户,即可通过一个公开端点查询接受USDC的x402服务,并按类别、网络、价格和支付方式筛选。返回结果不仅列出服务地址,还包含网络、代币合约、收款钱包、原子单位价格和输入参数结构,使代理能够在程序中完成“发现—核价—付款—调用”的闭环。
过去代理支付的讨论大多集中在钱包和签名,但一个代理首先要知道市场上有什么服务、服务是否在线、价格如何表达。若每个提供商都使用自己的目录与文档,代理仍要靠人工配置。Discovery API试图把可付费接口整理成机器可读目录,覆盖市场数据、网页搜索、媒体生成、预测市场和基础设施等类别。
Lo que se devuelve es información del contrato de pago, no una garantía ilimitada sobre la calidad del servicio
El endpoint de ejemplo oficial es `https://api.circle.com/v2/x402/discovery/resources`. Cada registro incluye resource, type, accepts y metadata. El bloque accepts usa la identificación de red CAIP-2; enumera contratos de activos, direcciones payTo y montos en unidades atómicas. metadata explica el proveedor, la categoría, la descripción de la interfaz, el esquema JSON de entrada y si admite x402 normal o Circle Gateway. USDC tiene seis decimales; en el ejemplo, 8000 representa 0.008 USDC.
Los desarrolladores pueden filtrar por seis categorías, además de limitar el tipo de network, http o mcp, el precio máximo en dólares y si hay soporte para Gateway. La documentación oficial advierte específicamente que, para consultar cadenas concretas, se use el parámetro estructurado de network, no depender de búsquedas de texto libre. Esta distinción es muy real: si un agente interpreta erróneamente “Base” en una descripción como la red de pago, podría preparar fondos en la cadena equivocada.
Circle afirma que verificará el estado de salud y la disponibilidad en línea del servicio del directorio, y continuará aplicando sanciones y revisiones al vendedor. Esto mejora la calidad del directorio, pero no significa que Circle garantice de forma integral el contenido del servicio, la exactitud de la salida o la legalidad del negocio. Las comprobaciones de salud solo pueden demostrar que el endpoint responde en un momento dado; no pueden probar que los datos del mercado sean correctos, que el contenido generado no infrinja derechos, o que el servicio predicho sea adecuado para una jurisdicción específica. El usuario aún debe definir por su cuenta proveedores confiables y los límites de uso.
El pago puede seguir dos rutas: x402 usa transferencias on-chain de USDC tras la firma; Gateway Nanopayments usa liquidación por lotes fuera de cadena, reduciendo la fricción de Gas en pagos pequeños. El directorio indicará, mediante sus flags, qué ruta admite cada servicio. Ambas difieren en su finalidad, en la forma de reembolso y en cómo se gestionan disputas; el agente no puede elegir solo según el precio más bajo, sino que también debe calcular comisiones de red, riesgos de liquidación, tiempos de respuesta y la capacidad de compensar tras fallos.
Para escalar la economía de los agentes, es más importante el control de cupos y la compra trazable que el pago automático
Las consultas sin clave reducen el umbral para el descubrimiento y también amplían la superficie de ataque de la cadena de suministro. Un proveedor malicioso podría atraer a los agentes con nombres similares, precios bajos o descripciones engañosas. En sistemas de producción, se deben fijar las categorías permitidas, las redes y el precio unitario máximo; para nuevos vendedores, establecer un cupo de prueba y verificar que la dirección de cobro coincida con lo devuelto por el directorio. El resultado del directorio también debe almacenarse en caché con marca de tiempo: antes de pagar, confirmar de nuevo el precio para evitar usar cotizaciones caducadas.
Los agentes también necesitan una estrategia de compra. Para la misma tarea de búsqueda puede haber múltiples servicios; el precio más bajo no necesariamente da el mejor resultado. El sistema puede registrar la tasa de éxito, la latencia, la consistencia de resultados y el historial de reembolsos, construyendo gradualmente una puntuación de proveedores. Para datos críticos, incluso se puede validar de forma cruzada desde dos servicios independientes, y luego decidir si el resultado se usa para transacciones, control de riesgos o publicación pública. La API de descubrimiento hace que el mercado sea buscable, pero la responsabilidad de la elección sigue recayendo en el comprador.
Cada micro-pago debe dejar un task ID, recurso del servicio, cotización, red, activo, monto, dirección de cobro, firmante y un resumen de la respuesta. Las finanzas de la empresa deben mapear un gran volumen de registros pequeños on-chain o de liquidación por lotes a usos de negocio concretos; de lo contrario, incluso “cada vez por menos de un centavo” se acumulará en cuentas imposibles de explicar. El monedero de los agentes, idealmente, debe usar límites diarios, de tarea y por categoría, en lugar de tener un saldo único que pueda gastarse arbitrariamente.
El directorio también necesita ser “exitable” (desacoplable). Las empresas deben conservar la dirección original del servicio y la especificación del protocolo, evitando que toda su lógica de compras dependa de un único directorio; si el directorio no está disponible temporalmente, puede usarse una caché validada o llamar directamente a proveedores existentes. La caché debe tener un periodo de validez y, antes de pagar, volver a comprobar el monto y la dirección; no se puede sacrificar la seguridad de la transacción para mantener la continuidad del funcionamiento.
Esta capacidad ya se ofrece mediante endpoints públicos; el contenido del directorio y el alcance seguirán cambiando según el estado de salud del servicio, el soporte de la cadena y las verificaciones de cumplimiento. Lo que resuelve es cómo un agente puede encontrar y entender un servicio de pago; no significa que todos los servicios listados sean aptos para comprarse directamente. Un mercado de agentes realmente utilizable requiere que se cumplan en conjunto: descubrimiento, identidad, pagos, reseñas, reembolsos y auditoría. Circle completó una capa importante, pero al integrarlo, las empresas aún deben separar con rigor lo “pagable” de lo “pagadero”.
