Paddock

Paddock

Agent 付款无法撤销。Paddock 为 AI Agent 提供付款前验证。

它会在 Agent 付款前检查 x402 API 是否真实、在线且定价合理，并统计 AI Agent 在 Base 和 Solana 上通过 x402 相互支付的实际情况。

Paddock 捕捉实时 Agent 经济的快照，包括交易量、支出、买家、服务提供方、类别占比和可靠性，并通过一组 MCP 工具和 HTTP API 提供这些数据。Agent 可以直接调用这些工具和 API，并使用 x402 按查询付费或使用订阅密钥。

关于 openapi.json 的说明： 此存储库中的 openapi.json 与 paddock.finance/openapi.json 上提供的实时规范逐字节一致。该规范由网站的路由生成，是事实来源。两者声明的 info.version 相同（目前为 3.8.0）；如果两者出现不一致，以实时规范为准，此文件已过时。工具发现和客户端生成可以使用任一文件。

Agent 为什么会调用它

• 现在应该为这个端点付费吗？ verify_before_pay 会实时探测目标，检查其合约是否符合你的预期以及卖家自行发布的配置，然后补充结算时效性、循环信号和相对市场的价格信息，之后你的 Agent 才会授权一笔无法撤回的付款。
• 寻找最佳的在线服务提供方。 根据可靠性（7 天成功率）、声誉（独立买家数）和价格的综合评分，对某个类别的服务提供方进行排名，让 Agent 能够选择最强的选项，而不只是最便宜的选项。
• 这项服务还在线吗？ 按域名查询在线状态、运行状态、7 天探测成功率和延迟，让 Agent 在向服务提供方发起付费调用前了解情况。
• 需求正在流向哪里？ 将今天的快照与过去某个日期进行比较，查看新增服务、已停用服务、类别占比变化和排名靠前的变动项，让 Agent 了解支出流向的变化。

MCP 工具

目前共有 12 个工具，分为三个访问层级。get_market_summary 完全无需身份验证。五个工具可通过免费密钥使用，每个 UTC 日可调用 10 次，五个工具共享调用次数；只需提供电子邮件地址，即可立即获取密钥。其余工具为高级功能：需要 Paddock API 密钥、通过 x402/MPP 按查询付费，或每天一次免费试用调用（如有注明）。

工具	价格	描述
verify_before_pay	免费密钥，或每次查询 $0.25 USDC	唯一无法由卖家自行报告的付款前检查。实时探测目标服务的 402 响应，将合约与您的预期及卖家自行发布的配置进行比对，然后补充结算近期情况、循环信号及价格与市场的比较结果。返回 route 的结果（true、false 或 inconclusive），每种结果均附有带日期的证据。在您的 Agent 授权任何 x402 付款之前调用此工具。
get_market_summary	免费	当前 AI Agent 商业市场概览：每日交易总量、USDC 支出、独立买家 Agent 数量、在线服务提供商数量，以及按交易量占比排列的主要支出类别。
get_category_detail	免费密钥	特定类别（llm、data、search、infra、content、markets、payments、comms；接受别名）中的所有服务，包括交易次数、定价、提供商数量和可靠性评分。
get_niche_gaps	免费密钥，或每次查询 $0.01 USDC	按 opportunity_score（交易量高、提供商少）对所有类别进行排名，并提供市场份额、头部提供商集中度，以及 Open/Tightening/Consolidating/Mature 信号。回答“我应该在哪里构建 x402 服务？”
get_best_value_provider	每次查询 $0.02 USDC	按可靠性（7 天成功率）、声誉（独立买家数量）和价格的综合指标，对某一类别中的提供商进行排名。
get_liveness	免费密钥，或每次查询 $0.001 USDC	针对 TrustBench 探测的任意域名提供逐域名在线状态，并附完整探测详情：在线/离线（7 天探测成功率 >= 0.95）、评分、延迟 p50/p95、样本数、端点数和上次探测时间。读取与 get_category_detail 相同的每夜汇总数据；区别在于覆盖范围和深度，而非数据新鲜度。它还可查询完全没有 x402 交易量的域名，而类别工具无法做到这一点。
get_changes	每次查询 $0.10 USDC	将今日市场快照与过去某个日期（最多追溯 90 天）进行比较：新增服务、停用服务、类别份额变化和主要变动项。
get_circular_signal	每次查询 $0.99 USDC	洗量/循环结算信号，按支付协调方汇总：集群数量、集群交易量（30 天/7 天）、自筹资金百分比、外部付款方数量、被标记结算的占比及趋势。仅提供汇总数据，不包含钱包地址或运营方身份。
get_whale_activity	每次查询 $0.99 USDC	某个时间窗口内的大额结算和主要变动项，按支付协调方、类别和金额区间汇总：金额、次数及各类别的变动项数量。只描述金额大小和发生领域，从不披露参与者身份。
get_token_metrics	免费密钥，或每次查询 $0.01 USDC	按指标和日期范围提供第一方图表/时间序列数据：随时间变化的支出份额、每日交易数、类别集中度、新服务、在线状态评分，以及 Agent Commerce Index（ACI）。
get_provider_revenue	每次查询 $0.99 USDC	在一个时间窗口的每日快照中，哪些提供商收入最高，以及该结果能够覆盖多少市场。仅统计可归属的范围，排除支付协调方的过账资金和被标记为循环交易的钱包；未解析的钱包不会被丢弃，而是作为一条明确的 unattributed 记录显示（仅提供交易份额，不存在相应的美元金额）。报告所有汇总日期的收款方列表是否完整。
get_report_data	免费元数据 + 完整数据每次查询 $0.99 USDC	通过未认证的 /api/paddock/mcp/report-data 路由提供免费元数据（标题、目录、执行摘要节选）；通过经 x402 加固的 /api/paddock/mcp/report-data/paid 路由提供月度《Agent Commerce 状况报告》的完整结构化 JSON、生态系统趋势、类别细分、包含组件分解的 Agent Commerce Index（ACI）、协议比较及可靠性数据。
付费工具（verify_before_pay、get_niche_gaps、get_best_value_provider、get_liveness、get_changes、get_circular_signal、get_whale_activity、get_token_metrics、get_provider_revenue）每天允许每个 IP 免费试用调用一次。get_report_data 的完整数据路由不提供免费试用；只有其元数据免费。

get_report_data 发布了两个路径。免费元数据路由（/api/paddock/mcp/report-data）声明为 security: []，并特意排除在 x402scan 索引之外；完整数据路由（/api/paddock/mcp/report-data/paid）采用 x402 支付方案。两者都可在 openapi.json 中查看。

签名证明

Paddock 可为任何付款前检查生成签名证明：一种可移植的 JSON 记录，其中包含观测到的付款条款、用于核验的结算历史、观测时间窗口和判定结果，并以 RFC 8785 规范形式通过 Ed25519 签名。签名密钥发布在一个众所周知的路径上，记录可独立验证，无需访问 API，也无需信任 Paddock。这是为 x402 争议解决扩展提议的证明证据格式。

• 公钥路径：/.well-known/paddock-attestation-key
• 自行验证：获取记录，按照 RFC 8785 进行规范化，并使用已发布的密钥验证 Ed25519 签名。
• 实时示例：https://paddock.finance/a/mFxHpIcBGHR0NsmkpT8rHb0wvX_8tIr3K0xOl_4W4UY

从 Claude Desktop 连接

在 Claude Desktop 中，打开 Settings → Connectors → Add custom connector，然后粘贴下面的 Paddock MCP URL。Claude 会自动发现工具。

https://paddock.finance/api/mcp/mcp

免费工具可通过连接器直接使用，无需身份验证。付费工具也可通过连接器使用：在工具调用中将 Paddock API 密钥作为 api_key 参数传入，服务端会将其转发为 X-Paddock-Key 标头，并从您的订阅中扣除该次调用的费用。省略 api_key 可使用每日一次的免费试用，或通过 x402 按查询支付工具的 USDC 价格。

从其他 MCP 客户端连接

Paddock 在同一 URL 上提供标准 MCP HTTP 传输：将任何兼容 MCP 的客户端指向该地址：

https://paddock.finance/api/mcp/mcp

如需查看工具发现信息、架构和完整路由映射，请参阅本仓库中的 openapi.json（镜像地址为 paddock.finance/openapi.json）。

免费密钥

初次使用？在 Paddock 上构建 提供了操作指南：60 秒快速入门、每种免费工具的实际用途、五个示例，以及如何规划用量。本 README 的其余部分是参考资料。

get_market_summary 对所有人开放，无需密钥、无需注册，也没有速率限制。这是引用数据的入口。如果你要引用 Paddock 的数据，请从这里引用。

另外五种工具 verify_before_pay、get_category_detail、get_niche_gaps、get_token_metrics、get_liveness 可通过免费密钥使用。发送一个请求即可获取密钥：

curl -X POST https://paddock.finance/api/keys/free \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]"}'

密钥会在响应中返回，并通过电子邮件发送给你。通过 X-Paddock-Key 标头传递，或通过 MCP 连接器的 api_key 参数传递。

• 五种工具每天共用 10 次调用额度，共用一个计数器，而非每种工具各有 10 次。
• 每个成功响应都包含一个 usage 对象（used、limit、remaining、resets_at），方便你自行监控用量。
• 超出限额时会返回结构化的 429 响应，注明重置时间和两种付费方式。
• 高级工具从不接受免费密钥。调用此类工具会返回结构化的 402 响应，注明价格；此次拒绝不会计入每日限额。

免费试用和免费密钥并不相同。 免费试用每天按 IP 提供 1 次调用，完全无需密钥，所有付费工具共用此额度；这是零门槛体验方式，目前仍可使用。免费密钥则是更高一级的工作流方案，额度与你的密钥关联，而非 IP。

可免费用于开发和内部用途。重新分发、转售或向你的终端用户提供 Paddock 数据，均需商业许可：请参阅 paddock.finance/api-access 或联系 [email protected]。

定价

方案	价格	限额
无密钥	免费	get_market_summary，无限使用，无需密钥，无上限
免费密钥	免费	五种工具每天 10 次查询，共用额度，参见免费密钥
Builder	$99/mo	每天 10,000 次查询
Pro Agent	$499/mo	无限
x402 按查询付费	按次付费	面向 Agent 原生使用，无需订阅，在调用时按工具的 USDC 价格付费

x402 按查询付费选项面向 Agent 原生的按次付费访问，无需订阅：Agent 在调用时结算该工具的 USDC 价格。要订阅 Builder 或 Pro Agent 并获取 API 密钥，请参阅 paddock.finance/api-access。

身份验证

密钥分为三类，传递方式相同，均通过 X-Paddock-Key 标头传递：pk_free_（免费方案，五种工具，每天共用 10 次额度）、pk_builder_（$99/mo）和 pk_proagent_（$499/mo）。付费工具接受 Builder 或 Pro Agent 密钥；每次请求都要附带密钥，调用费用会从订阅的每日额度中扣除。通过 MCP 连接器（例如在 Claude 中）使用时，应改为将密钥作为工具参数 api_key 传递；服务端会将其转发为 X-Paddock-Key。此外，Agent 也可通过 x402 按查询付费：省略密钥，并在调用时通过 x402 付款流程结算该工具的 USDC 价格。免费工具无需密钥。

文档与联系

• 权威文档：paddock.finance/docs
• 问题咨询：[email protected]
• X 上的账号：@PaddockFinance

状态

已投入生产。每日 23:30 UTC 写入快照。