x402 服务列表:发现并提交 Agent 可用的付费接口
通过 StableOps x402 服务列表按类别、交易数据和在线测试发现适合 Agent 的付费接口,查看实时付款要求与变更记录。服务提供方也可提交多个接口,经有效性验证和人工审核后,面向更多开发者与 Agent 持续展示服务能力。
x402 让一个 HTTP 接口可以直接说明“调用这项能力需要支付多少”,但协议解决了付款握手之后,供需双方还会遇到一个更早的问题:Agent 去哪里找到适合当前任务的付费服务?一个已经上线的 x402 服务,又怎样被更多开发者和 Agent 发现?
为此,我们上线了 StableOps x402 服务列表。它既是开发者可以浏览和测试的公开目录,也是服务提供方展示自己收费接口的入口。你可以按类别与使用数据比较候选服务,在不连接钱包、不发起付款的情况下读取实时 402 付款要求。如果你已经提供 x402 服务,也可以提交服务,把它加入目录。
为什么 x402 需要一个服务列表
传统 API 往往从文档、搜索引擎或集成市场中被发现,接入前还要申请密钥、选择套餐并完成账户充值。x402 把付款要求带回 HTTP 请求本身,减少了结算前的集成步骤,却不会自动告诉 Agent 哪个服务存在、它能完成什么任务,或者当前端点是否仍然返回有效的付款要求。
服务列表把这些发现信息集中到一个可浏览入口:
- 按数据、搜索、人工智能、算力、存储、内容等类别筛选服务。
- 搜索服务名称、服务商、介绍或接口地址。
- 按最近 30 天交易次数、交易量、付款地址数或最新收录排序。
- 在服务详情中查看服务商、文档、标签、接口说明、请求方法和请求模板。
- 在线请求真实端点,读取它此刻返回的
402付款方案与原始响应。
目录并不替 Agent 作出购买决定,也不把历史指标变成质量保证。它的作用是缩小候选范围,并把接入前最需要核对的信息放在一起。最终是否付款,仍应由任务需要、付款策略、预算、收款方允许列表和人工审批共同决定。
不付款,先读取真实的 402 要求
每个服务可以收录多个接口。进入详情页后,你可以选择一个接口,检查保存的请求方法、查询参数和示例请求体,再点击“测试 402”。StableOps 会按这份模板请求服务,并展示当前返回的付款方案,包括原子单位金额、资产、收款地址和付款时限。
这一步只读取付款要求:不会连接钱包,也不会发起链上付款。它适合用来回答几个关键问题:
- 这个接口现在是否可访问并返回有效的 x402 挑战?
- 请求模板是否与当前任务匹配?
- 网络、资产、金额和收款地址是否符合你的付款策略?
- 同一服务的不同接口,分别提供什么能力?
详情页还会展示最近的付款要求变更记录。若自动探测发现价格、收款地址、网络或 x402 版本发生变化,你可以在付款前看到新旧值。对于按报价动态分配收款地址的服务,则应始终以当前报价返回的地址为准。
让程序也能读取服务列表
网页适合人工比较,公开 JSON 接口则适合工具和自动化程序先取得候选服务。下面的请求会读取数据类服务,并按最近 30 天交易次数排序:
curl 'https://api.stableops.dev/v1/x402/resources?category=DATA&sort=TRANSACTION_COUNT&limit=10'响应包含服务介绍、服务商、接口列表、类别、标签、更新时间以及可用的 30 天指标。程序可以用这些字段生成候选清单,但在真正付款前,仍应读取目标接口的实时要求,并经过自己的策略、预算与审批流程。
如果你正在为 Agent 配置受控付款,可以继续阅读 Agent Payments 快速开始。运行时应先发现和比较服务,再预检准确网址与实时报价。同一次购买的重试还要复用稳定的幂等键。
为什么要把你的服务提交进来
一个收费接口只有被正确发现,才有机会获得真实调用。提交到 StableOps 服务列表后,你可以:
- 用清晰的服务介绍、类别与标签说明它适合解决什么问题。
- 在同一个服务下展示多个接口,并分别提供请求方法、参数和示例请求体。
- 链接官方文档,降低开发者理解与接入成本。
- 让访问者在付款前读取实时
402要求,而不是依赖可能过期的静态价格。 - 在公开详情页展示可用的在线率、响应耗时和交易指标,为选择提供更多上下文。
- 通过“我的服务”维护已提交内容。已发布服务的修改进入审核时,现有公开版本会继续展示。
提交服务不收费,但需要注册或登录 StableOps,并选择所属组织。联系邮箱只用于审核与沟通,不会公开展示。
提交前准备好这些信息
打开提交 x402 服务后,需要填写服务名称、服务商名称、服务介绍、类别、标签、联系邮箱,以及至少一个服务接口。官方文档链接和补充说明为可选项。
每个接口都应准备:
- 一个不含凭据、片段或内网地址的公开 HTTPS 地址。
- 能说明返回内容与适用任务的接口介绍。
- 正确的 HTTP 请求方法。
- 请求所需的查询参数,以及适用时的请求体类型和示例请求体。
先对每个接口点击“测试 402”。提交时系统会再次实际请求所有接口。只有每个接口都返回有效的 HTTP 402 付款要求,服务才能保存并进入审核。已经被其他服务收录的接口地址不能重复提交。
为了让服务更容易被选择,不要只写“数据接口”或“人工智能服务”。更有效的介绍会明确说明输入、返回结果、覆盖范围、更新频率和典型任务。请求模板应能够直接得到付款要求,同时避免放入真实令牌、个人数据或其他敏感信息。
从发现到第一次调用
如果你正在寻找能力,现在就去浏览 x402 服务列表,选择一个类别,打开候选服务并先测试它的实时付款要求。确认任务确实需要该结果,且网络、资产、金额和收款方均符合策略后,再通过你的 x402 客户端或 Agent Payments 发起购买。
如果你已经在销售数据、搜索、推理、算力、存储或内容接口,请提交你的 x402 服务。准确的介绍、可复现的请求模板和稳定返回的 402 挑战,会让开发者更快理解你的服务,也让 Agent 更容易在正确的任务中发现并使用它。
相关文章
本文讲解交易平台如何用唯一地址、链上最终确定、Webhook 幂等处理与每日对账构建加密货币充值监控,在支持客户选择多条网络的同时安全增加内部余额,妥善处理过期、迟到与异常转账,并降低重复记账、错误归属和链重组造成的真实资金损失。
用买方策略、预算、审批和客户自持签名构建 AI Agent 支付,再以卖方支付订单、最终性、Webhook 与对账完成稳定币收款闭环。
学习如何用沙盒、测试网 USDC、Webhook 测试数据和上线核对清单测试加密货币支付,全程不承担真实资金风险。
稳定币支付对账需要连接业务订单、支付事件与链上转账。本文讲解如何设计稳定外键、发现 Webhook 缺口,并执行日对账与月对账。