x402-factory

x402-factory 客户端

为 x402-factory.com 提供类型化客户端、实用示例和 Agent 技能 —— 为 AI Agent 提供 200 多种付费数据 API（预测市场概率、天气情报、美国经济数据、SEC/EDGAR 和召回信息源），通过 x402 协议（HTTP 402 + Base 上的 USDC）按次付费。无需 API 密钥，无需账户：使用任意钱包，每次调用只需几美分。

付费前先评估 — 免费验证数据

平台会永久免费公开自己的评分表：

• 预测验证 — 对照真实 NWS 气象站观测数据，对每项预测评分，并按提前时间、地区、方法和模型版本分类： /v1/verification/scores。 在当前模型下，短提前时间的站点融合结果优于 NWS 原始数据（截至 2026-10-15，滚动 90 天窗口，在 nws-blend 分段中 — 同一样本与 NWS 基线进行配对比较：提前 1 小时时，温度 MAE 为 0.84，而 NWS 为 1.14 °C，n=3,506；提前 3 小时为 0.89，而 NWS 为 1.16；到提前 24 小时时逐渐趋于与 NWS 持平 — 这正是该方法所预测的衰减趋势。 你可以自行重新计算：将实时表格筛选到 nws-blend 分段）。
• 模型与市场校准门槛 — 只有在市场类别自身的已结算历史证明其经过校准后，才会出售这些类别；完整的可靠性表格（以及目前暂不提供的内容及其原因）均公开： /v1/edge/calibration。
• 概率目录中的免费延迟数据源和变更探测工具。

快速入门（TypeScript）

import { X402FactoryClient } from "./ts/client.js";
// Free routes need nothing:
const free = new X402FactoryClient();
console.log(await free.verificationScores());
// Paid routes need any funded wallet via @x402/fetch:
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";
const paid = new X402FactoryClient({
  fetch: wrapFetchWithPayment(fetch, privateKeyToAccount(process.env.PK as `0x${string}`)),
});
console.log(await paid.get("/v1/econ/dashboard")); // $0.03, settles automatically

Python：参见 py/client.py。实用示例（仅限免费路由，可直接运行）：examples/。

MCP

远程 MCP 服务端点：POST https://x402-factory.com/mcp（可流式传输的 HTTP，无状态 JSON）。免费和延迟工具会返回数据；付费工具会返回结构化的 payment_required 指引，其中包含 HTTP 路由和价格 —— 这个镜像是免费引流入口，并非绕过付费墙的途径。速率限制：30 次请求/分钟。

Agent 技能

skill/ 将目录封装为面向任务的技能： 无需钱包的发现模式（仅限免费路由），以及通过现有 x402 钱包工具运行的付费模式，并设有单次调用上限。MIT-0。

诚信承诺

每个响应都包含 meta.sources 和 meta.data_mode；方法标签在整个流程中均如实标注（NWS 直通会明确标注）；技能声明只会在免费验证数据中有测量结果和 n 值时显示。 许可证：MIT。