计量路由与支付响应

资源价格、计费模式以及专有的 402 响应封装。

最近更新: 2026年9月30日

当前计费状态

全部八条数据路由目前按 Owner 决定运行在 observe 模式下。下方生成的清单读取实际的处理器包装和本应用实例的配置。它列出公示价格;并不意味着计费已启用。同一路径上的 GET 和 POST 一并显示。所有数据路由访问都使用现有的 read 权限,包括计费启用时。

响应头

  • X-Credits-Price 公示每次调用的 Credits。
  • X-Payment-Notice 说明 observe_mode_no_charge、enforcement_pending、terms_required 或 billing_unavailable。
  • X-Credits-Charged 和 X-Credits-Remaining 描述一次已扣费的调用。
  • X-Credits-Refunded 在适用时报告退款。

402 响应

计量数据调用的 Credits 不足时,响应封装包含 x402Version: 1 和一个 accepts 列表,其中 scheme 为 ftsobest-prepaid-router。这是我们预付流程的发现封装,不是 exact 支付指令。maxAmountRequired 为 0;请从充值端点获取真实报价。不要支付零,也不要从该字段推断金额。extra 对象链接到流程并携带其 USD 锚定。浏览器会话可能额外收到 topupPage。匿名 enforce 目前尚未启用,不得表述为正在收费。

{
  "x402Version": 1,
  "error": "insufficient_credits",
  "code": "insufficient_credits",
  "accepts": [
    {
      "scheme": "ftsobest-prepaid-router",
      "network": "flare",
      "maxAmountRequired": "0",
      "extra": {
        "flow": "challenge -> token -> topup(authorization, asset optional) -> router.pay(tx) -> confirm(txHash) -> retry with Bearer"
      }
    }
  ]
}

这是简化后的封装,不是完整的 Schema。订阅容量不足时改用 code slot_required 或 insufficient_credits,并附带 purchase 及 buyEndpoint/topupEndpoint 信息;它们不保证同样的 accepts 封装。

读取数据路由

curl -i 'https://ftso.app/api/ftso/analytics/overview?chain=flare' \
  -H 'authorization: Bearer fbx_READ_TOKEN'

管理 API 参见操作参考,余额充值参见充值。

计量数据路由

  • GET /api/ftso/analytics/board — ftso-analytics: 1 每次调用的 Credits; Scope: read; 模式: observe.
  • GET /api/ftso/analytics/movers — ftso-analytics: 1 每次调用的 Credits; Scope: read; 模式: observe.
  • GET /api/ftso/analytics/overview — ftso-analytics: 1 每次调用的 Credits; Scope: read; 模式: observe.
  • GET /api/ftso/analytics/volatility — ftso-analytics: 1 每次调用的 Credits; Scope: read; 模式: observe.
  • GET /api/intelligence/trust-radar — trust-radar: 5 每次调用的 Credits; Scope: read; 模式: observe.
  • GET/POST /api/providers/{chain}/rewards — providers-rewards: 2 每次调用的 Credits; Scope: read; 模式: observe.
  • GET /api/rewards-intelligence/external-rewards/scan — rewards-intelligence-scan: 10 每次调用的 Credits; Scope: read; 模式: observe.
  • GET /api/rewards-intelligence/reports — rewards-intelligence-reports: 10 每次调用的 Credits; Scope: read; 模式: observe.