Circle在9月9日开放Agent Marketplace的Discovery API。开发者无需API密钥、认证或Circle账户,即可通过一个公开端点查询接受USDC的x402服务,并按类别、网络、价格和支付方式筛选。返回结果不仅列出服务地址,还包含网络、代币合约、收款钱包、原子单位价格和输入参数结构,使代理能够在程序中完成“发现—核价—付款—调用”的闭环。
过去代理支付的讨论大多集中在钱包和签名,但一个代理首先要知道市场上有什么服务、服务是否在线、价格如何表达。若每个提供商都使用自己的目录与文档,代理仍要靠人工配置。Discovery API试图把可付费接口整理成机器可读目录,覆盖市场数据、网页搜索、媒体生成、预测市场和基础设施等类别。
返回的是支付合同信息,不是对服务质量的无限担保
官方示例端点为`https://api.circle.com/v2/x402/discovery/resources`。每条记录包含resource、type、accepts和metadata。accepts区块使用CAIP-2标识网络,列出资产合约、payTo地址和原子单位金额;metadata说明提供商、分类、接口描述、输入JSON Schema,以及是否支持普通x402或Circle Gateway。USDC有六位小数,示例中的8000代表0.008 USDC。
开发者可以按六个类别筛选,还能限定network、http或mcp类型、最高美元价格和Gateway支持情况。官方特别提醒,查特定链应使用结构化network参数,而不是依赖自由文本搜索。这种区分很实际:代理若把描述里出现的“Base”误认为付款网络,可能在错误链上准备资金。
Circle称会检查目录服务的健康与在线状态,并持续对卖方进行制裁筛查。这提高了目录质量,但不意味着服务内容、输出准确性或业务合法性由Circle全面担保。健康检查只能证明端点在某个时刻响应,无法证明市场数据正确、生成内容不侵权或预测服务适合某个司法辖区。使用方仍需自行设定可信提供商和用途边界。
付款可以走两条路径:x402使用签名后的链上USDC转账;Gateway Nanopayments采用链下批量结算,减少小额支付的Gas摩擦。目录中的标志会说明服务支持哪种路径。两者的最终性、退款方式和争议处理不同,代理不能只按最低标价选择,还要计算网络费、结算风险、响应时间和失败后的补偿能力。
代理经济要规模化,额度控制和可追溯采购比自动付款更重要
无密钥查询降低了发现门槛,也扩大了供应链攻击面。恶意提供商可能用相似名称、低价或诱导描述吸引代理。生产系统应固定允许的类别、网络和最高单价,对新卖方设置试用额度,并校验收款地址与目录返回是否一致。目录结果也应带时间戳缓存,付款前重新确认价格,避免使用过期报价。
代理还需要采购策略。同一个搜索任务可能有多个服务,最低价未必给出最好结果。系统可以记录成功率、延迟、结果一致性和退款历史,逐步形成供应商评分。对关键数据,甚至可以从两家独立服务交叉验证,再决定是否把结果用于交易、风控或公开发布。发现API让市场可搜,但选择责任仍在买方。
每笔微支付都应留下任务ID、服务资源、报价、网络、资产、金额、收款地址、签名者和返回摘要。企业财务需要把大量小额链上或批量结算记录映射到具体业务用途,否则“每次不到一美分”也会累积成无法解释的账目。代理的钱包最好采用日限额、任务限额和类别限额,而不是拥有一笔可随意支配的余额。
目录也需要可退出性。企业应保留原始服务地址和协议规范,避免自己的全部采购逻辑只能通过单一目录运行;一旦目录临时不可用,可以使用经过验证的缓存或直接调用既有供应商。缓存必须设置有效期,并在付款前再次校验金额和地址,不能为了连续运行牺牲交易安全。
这项能力已经通过公开端点提供,目录内容和覆盖范围仍会随服务健康、链支持和合规筛查变化。它解决的是代理如何找到并理解可付费服务,不等于所有列出服务都适合直接购买。真正可用的代理市场,需要发现、身份、支付、评价、退款和审计共同成立。Circle完成了其中重要的一层,企业接入时仍要把“能付”与“该付”严格分开。










