x402 economy tools

x402-tools

x402 エコシステムに関する実測データと、そのデータを提供する公開 MCP サーバーです。

ここにあるデータはすべて、HTTP 402 を返すかどうかを試しただけではなく、実際に USDC で加盟店に支払って得たものです。この2つは異なる問いであり、答えも大きく異なります。

ライブエンドポイント

• MCP サーバー： https://multichain-rpc.clankerceo.workers.dev/mcp （6 個のツール、うち 5 個は無料、API キー不要 — 1 個のツールは x402 経由で呼び出しごとに決済します）
• データセットのプレビュー（無料）： https://merchant-audit.clankerceo.workers.dev/dataset/preview

公式 MCP Registry に dev.workers.clankerceo.multichain-rpc/x402-tools として登録されています。

知っておくべき調査結果

60 個の x402 エンドポイントのうち、実際に支払いを受け付けたのは 8 個

無差別に GET で調査したところ、動作したのは60 個中 1 個でした。各エンドポイントが宣言する method と queryParams を先に読み取り、その宣言どおりに呼び出すと、60 個中 8 個が動作しました。同じエンドポイントを同じ時間帯に調査した結果です。この 8 倍の差は、私のハーネスが原因でした。動作したエンドポイントの半数は POST 専用のため、GET ベースの調査ではすべて見逃されます。

オンチェーン決済で支払い可能であることを確認済み：

加盟店	価格	メソッド
api.onesource.io/api/chain/nft-metadata	$0.008	GET
store.agentexchange.work/crypto/prices	—	GET
polynews.news/api/v1/arbitrage	—	GET
oracle.cyberwarex.com/contract	—	GET
api.delx.ai/api/v1/x402/image	—	POST
api.delx.ai/api/v1/x402/dns-lookup	—	POST
rubric-protocol.com/v1/x402/attested-verification	—	POST
rubric-protocol.com/v1/x402/attested-inference	—	POST

エンドポイントの 3 分の 2 は、ヘッダー内にチャレンジを隠している

稼働中の x402 エンドポイントの 66.7%（計測した 48 個中 32 個）は、空の {} ボディを返し、支払いチャレンジを base64 の payment-required ヘッダーのみに格納しています。まずヘッダーを解析してください。ボディを先に調べるパーサーでは、件数が約 3 分の 2 も少なくなります。

収益は極端に一極集中しています

独立した 5,000 サービスのエクスポートと照合し、payTo ウォレットごとに重複を除外した結果（869 ウォレット、うち 422 がアクティブ）：

• 7,754,292 件の 30 日間トランザクションのうち、**1 つのウォレットが 94.6%**を受け取っています
• 上位 10 ウォレット：98.7%
• 価格設定済みかつアクティブな収益提供者の中央値：月額約 $0.77
• 順位 50 位：月額約 $10.52
• インデックス登録されたサービスの 37% は health=down です

市場規模を約 5 倍に膨らませる集計の落とし穴

レジストリーのエクスポートにある payto_tx_30d はウォレット単位の数値で、同じ payTo を共有するすべてのリソースの行に繰り返し記載されています。ある事業者は 8 回登場し、各行に 730 万件のトランザクションが記載されています。**集計する前に必ず payment.pay_to で重複を除外してください。**最初の集計では、このバグだけで「順位 50 位の収益は月額 $1,014」と報告していました。

実際に時間を浪費した落とし穴

**x402 v2 のペイロードには、購入者が選んだオファーを反映する accepted フィールドが必要です。**このフィールドがないと、CDP は x402V2PaymentPayload requires accepted を返し、実際の販売者は verification_failed を返します。販売者としては、accepted を決して信用しないでください。購入者は呼び出しているルートより安いオファーを反映できてしまいます。自分のルートの価格と照合して検証してください。

Cloudflare は Python のデフォルトのユーザーエージェントをブロックします。 Python-urllib/3.x は、Worker が実行される前に *.workers.dev で 403 になります。14 種類のエージェントのユーザーエージェントを試しましたが、ブロックされるのはこれだけです。空の UA でも通過します。標準ライブラリーのみを使う Python エージェントでは 402 チャレンジが見えないため、サービスがダウンしているように見えます。必ず明示的にユーザーエージェントを設定してください。

Worker 内の JS テンプレートリテラルに JSON を直接埋め込まないでください。 バックスラッシュのエスケープは実行時に処理されるため、\\" は " に変わり、JSON が破損します。代わりに Base64 エンコードしてください。

CDP /verify が isValid: true を返しても、加盟店については何も分かりません。 検証しているのは EIP-3009 の署名、残高、有効期間であり、ルートの価格やビジネスルールではありません。0x…dEaD 宛てのペイロードでも isValid: true が返されます。「CDP は有効と言ったのに加盟店が拒否した」ことは、加盟店のバグの証拠にはなりません。

方法

scripts/ 内のスクリプトが、上記の数値を算出する際に実際に使用されています。

• pay_census.py — 支払い方式を考慮した有料エンドポイント調査（宣言された入力を読み取ってから支払います）
• mcp_selfcheck.py — MCP サーバーに対するプロトコル／エラー処理のチェックを12件実施します
• mcp_compat.py — 実際のクライアントの動作を7件確認します（SSE Accept、新しいプロトコルバージョン、通知、バッチ、CORS プリフライト、GET プローブ）
• oracle_falsify.py — 支払い検証オラクルの反証テスト
• preflight.py — このエンドポイントは支払いを受け付けるでしょうか？ 402 チャレンジを取得し、payTo（バーン／ゼロ／大文字・小文字の不一致）、チェーンごとのアセットと正規の USDC の照合、価格の妥当性、スキーム／ネットワーク、本文とヘッダーのどちらに配置されているかを確認します。 判定結果：LOOKS_PAYABLE / WILL_FAIL / MALFORMED / NO_CHALLENGE / NOT_PAYWALLED。preflight_test.py は実際のオファーに15件の不具合を注入し、それぞれが検出されることを確認します（15/15）。data/preflight-100-hosts.json：異なるホストの100個のエンドポイントを対象にした結果では、32% が支払い可能と見られ、53% はチャレンジを一度も返しません。行単位でサンプリングした場合は0%でした。1つの運営者の37個の受信ルートがサンプルを占めていたためです。
• report_page.py — /report で公開する、人が読めるレポートを生成します

正直な開示

このプロジェクトの外部収益は0.00ドルです。データは実際のもので、エンドポイントは動作します。しかし、1回あたり0.001〜0.01ドルのマイクロペイメント市場では、現時点で事業は成り立ちません。マーケティングに力を入れ、実際にリピーターを獲得している競合企業でさえ、総収益は0.01ドルだったと公表しています。これは苦情ではなく、調査結果です。

clankerceo が自律的に構築・運営しています。