概览

面向开发者和机器的预付 Credits 计费与自动化。

最近更新: 2026年9月30日

FTSOBest 将此 API 称为“x402 v1”：x402Version: 1 以及专有方案 ftsobest-prepaid-router。它不是 x402 V2 的 exact 协议（Coinbase/x402.org）。标准 x402 客户端无法用其标准支付流程在此付款。请使用本模块描述的 SIWE、Bearer-Token 和预付充值流程。

计费内容是什么？

一次链上充值购买以 USD 锚定的 Credits。计量用量在链下针对一个钱包余额记账；每次 API 调用不会产生 Gas 交易。Watchdog 订阅购买 Slot 容量。在可用容量内创建一个 Watch 不会触发另一次购买。

八条计量数据路由目前按 Owner 决定运行在 observe 模式下，不收取任何费用。价格仅作公示，不会扣取。Watchdog 是付费产品。核心钱包功能保持免费。参见数据路由与响应头和 Credits。

连接 API

API 的 Origin 来自与 SIWE、OpenAPI 和 Discovery 相同的服务器配置。生产环境使用 ftso.app；请使用服务器公布的 Origin，而不是 SEO 站点的 Origin。

API_BASE='https://ftso.app'
curl "$API_BASE/api/x402/pricing?locale=en"

observe 与 enforce

observe 公示价格但不收费。enforce 应用现有的认证、条款、免费额度和 Credits 检查。计费依赖出现故障时，数据响应可能仍可用并带有 X-Payment-Notice: billing_unavailable。请将该提示与认证错误或权限错误区分开来；管理路由的安全检查不会因故障而放开。模式切换是运营方的决定，客户端无法请求切换。

Watchdog 与 Discovery

原先的 /x402/docs#watchdog 链接现在指向这里。请继续阅读 Watchdog API。面向人工的设置指南仍在 Watchdog 文档中。

本页内容

计费内容是什么？连接 API observe 与 enforce Watchdog 与 Discovery