Paddock

Paddock

エージェントによる支払いにチャージバックはありません。Paddock は、AI エージェントが支払う前に行う事前決済検証です。

エージェントが API に支払う前に、その x402 API が実在し、稼働中で、価格が適正かを確認します。また、Base と Solana 上の x402 で、AI エージェント同士が実際に支払っている金額を測定します。

Paddock は、エージェント経済の最新状況、取引量、支出、購入者、プロバイダー、カテゴリ別シェア、信頼性をスナップショットとして記録し、一連の MCP ツールと HTTP API を通じて提供します。エージェントはこれらを直接呼び出し、x402 によるクエリごとの支払い、またはサブスクリプションキーで利用できます。

openapi.json に関する注意： このリポジトリ内の openapi.json は、paddock.finance/openapi.json で提供されるライブ仕様をバイト単位でそのまま複製したもので、サイトのルートから生成される正本です。どちらも同じ info.version（現在は 3.8.0）を宣言しています。両者に食い違いが生じた場合は、ライブ仕様が正しく、このファイルが古いものです。ツールの検出やクライアントの生成には、どちらを使用してもかまいません。

エージェントが呼び出す理由

• 今すぐこのエンドポイントに支払うべきですか？ verify_before_pay は対象をライブでプローブし、契約内容が想定および販売者自身が公開している設定と一致するかを確認します。さらに、決済の新しさ、循環性のシグナル、市場に対する価格を加味してから、取り消せない支払いをエージェントが承認できるようにします。
• 稼働中の最適なプロバイダーを見つけます。 信頼性（過去7日間の成功率）、評判（ユニークな購入者数）、価格を組み合わせた指標で、カテゴリ内のプロバイダーをランク付けします。これにより、エージェントは最安の選択肢ではなく、最も優れた選択肢にリクエストを振り分けられます。
• このサービスはまだ稼働していますか？ ドメインごとの稼働状況の照会で、稼働中か停止中か、過去7日間のプローブ成功率、レイテンシを確認してから、エージェントが有料の呼び出しをプロバイダーに行えるようにします。
• 需要はどこへ移っていますか？ 今日のスナップショットを過去の日付と比較し、新しいサービス、終了したサービス、カテゴリ別シェアの変動、急上昇した項目を確認できます。これにより、エージェントは支出がどこへ移っているかを把握できます。

MCP ツール

3つのアクセス層にわたって、12個のツールが稼働しています。get_market_summary は認証なしで利用できます。5つのツールは無料キーで利用でき、5つすべてで共有される1日10回（UTC）の呼び出し枠があり、メールアドレスを入力するとすぐに発行されます。残りはプレミアムツールで、Paddock API キー、クエリごとの x402/MPP 支払い、または1日1回の無料トライアル（記載がある場合）が必要です。

ツール	価格	説明
verify_before_pay	無料キー、またはクエリあたり $0.25 USDC	販売者が自己申告できない、支払い前のチェックです。対象にライブでアクセスして 402 を確認し、コントラクトが期待値および販売者自身が公開している設定と一致するかを確認したうえで、決済の新しさ、循環シグナル、市場に対する価格を加味します。日付付きの証拠とともに、route が true／false／判定不能のいずれかを返します。エージェントが x402 の支払いを承認する前に呼び出してください。
get_market_summary	無料	AI エージェントのコマース市場の現在の概要を返します。1 日あたりの総取引量、USDC の支出額、ユニークな購入エージェント数、稼働中のサービスプロバイダー数、取引量に占める割合とともに上位の支出カテゴリを確認できます。
get_category_detail	無料キー	特定カテゴリ（llm、data、search、infra、content、markets、payments、comms。エイリアスも使用できます）の全サービスについて、取引件数、価格、プロバイダー数、信頼性スコアを返します。
get_niche_gaps	無料キー、またはクエリあたり $0.01 USDC	各カテゴリを opportunity_score（取引量が多く、プロバイダーが少ないほど高評価）で順位付けし、シェア、上位プロバイダーへの集中度、「オープン／引き締まり中／集約中／成熟」のシグナルを返します。「x402 サービスを構築するなら、どこがよいか？」に答えます。
get_best_value_provider	クエリあたり $0.02 USDC	1 つのカテゴリ内のプロバイダーを、信頼性（過去 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 ルートでは、月次の「State of 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 ごとに 1 日 1 回、無料で試用できます。get_report_data は全データのルートに無料試用はありません。メタデータのみ無料です。

get_report_data は 2 つのパスで公開されています。無料のメタデータ用ルート（/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

無料ツールは、認証なしでコネクター経由で利用できます。有料ツールもコネクター経由で利用できます。ツール呼び出しの api_key 引数に Paddock API キーを渡すと、サーバーがこれを X-Paddock-Key ヘッダーとして転送し、サブスクリプションに対して課金します。api_key を省略すると、1 日 1 回の無料試用を利用するか、x402 によるクエリごとの支払いでツールの USDC 価格を決済できます。

その他の MCP クライアントから接続する

Paddock は同じ URL で標準の MCP HTTP トランスポートを公開しています。MCP 対応クライアントからこの URL に接続します。

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

ツールの検出、スキーマ、完全なルート一覧については、このリポジトリの openapi.json（paddock.finance/openapi.json にもミラーされています）を参照してください。

無料キー

初めての方へ：Paddock で構築する は、60 秒で始める方法、各無料ツールの実際の用途、5 つの実践例、利用量の見積もり方法を紹介するガイドです。この README の残りはリファレンスです。

get_market_summary は、キー不要、登録不要、レート制限なしで誰でも利用できます。引用元として使えます。Paddock の数値を引用する場合は、ここから引用してください。

さらに 5 つのツール、verify_before_pay、get_category_detail、get_niche_gaps、get_token_metrics、get_liveness は無料キーで利用できます。1 回のリクエストでキーを取得できます。

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

キーはレスポンスで返され、メールでも送信されます。X-Paddock-Key ヘッダー、または MCP コネクター経由で api_key 引数として渡してください。

• 1 日あたり UTC で 10 回、5 つのツール全体で共有されます。各ツールに 10 回ずつではなく、カウンターは 1 つです。
• 成功したレスポンスには usage オブジェクト（used、limit、remaining、resets_at）が含まれるため、利用量を把握できます。
• 上限を超えると、リセット時刻と 2 つの有料プランを示す構造化された 429 が返されます。
• プレミアムツールは無料キーでは利用できません。呼び出すと料金を示す構造化された 402 が返されます。この拒否は1 日あたりの上限回数にはカウントされません。

無料トライアルと無料キーは別物です。 無料トライアルは、キーなしで IP アドレスごとに 1 日 1 回利用でき、有料ツール全体で共有される、手軽に試すためのものです。現在も利用できます。無料キーはその上位のワークフロープランで、IP アドレスではなくキーに紐付けられます。

開発および社内利用は無料です。再配布、再販売、またはエンドユーザーへの Paddock データ提供には商用ライセンスが必要です。paddock.finance/api-access をご覧いただくか、[email protected] までお問い合わせください。

料金

プラン	料金	上限
キー不要	無料	get_market_summary、無制限、キー不要、上限なし
無料キー	無料	5 つのツールを 1 日あたり 10 回まで共有して利用できます。無料キーをご覧ください
Builder	月額 $99	1 日あたり 10,000 クエリ
Pro Agent	月額 $499	無制限
x402 従量課金	取得ごとに支払い	エージェント向け、サブスクリプション不要。呼び出し時にツールごとの USDC 料金を支払います

x402 従量課金オプションは、サブスクリプションなしで取得ごとに支払う、エージェント向けのアクセス方法です。エージェントは呼び出し時にツールの USDC 料金を精算します。Builder または Pro Agent に登録して API キーを取得するには、paddock.finance/api-access をご覧ください。

認証

キーは 3 種類あり、いずれも同じ方法で X-Paddock-Key ヘッダーに渡します。pk_free_（無料プラン、5 つのツール、1 日 10 回まで共有）、pk_builder_（月額 $99）、pk_proagent_（月額 $499）です。有料ツールでは Builder または Pro Agent のキーを利用できます。各リクエストでキーを渡すと、呼び出しはサブスクリプションの 1 日あたりの上限に計上されます。MCP コネクター（例：Claude）経由の場合は、代わりにキーを api_key ツール引数として渡してください。サーバーが X-Paddock-Key として転送します。また、エージェントは x402 でクエリごとに支払うこともできます。キーを省略し、呼び出し時に x402 の決済フローでツールの USDC 料金を精算してください。無料ツールにはどちらも必要ありません。

ドキュメントとお問い合わせ

• 正式なドキュメント：paddock.finance/docs
• ご質問：[email protected]
• X：@PaddockFinance

ステータス

本番稼働中です。スナップショットは毎日 23:30 UTC に作成されます。