x402 の使い方は4段です。① 無料の入口を読む → ② 一番安い経路の 402 を読む → ③ 形式だけ無料で試す → ④ 1回だけ買う。当方の公開URLで 2026-10-19 に実測すると、無料で読めるのは価格・引数・失敗時の宣言までで、返ってくる中身は 200 を買うまで分かりません。
実測の中心は /gas の 0.001 USDC です。未払いの GET は 402・21,429 B、payment-required ヘッダは 5,464 B、応答は 170〜528 ms。壊れた引数は 400・377 B・168 ms で課金前に返り、無料サンプルの /gas/sample は 404・3,200 B でした。
この記事で支払いは1回も実行していません（支払い・SMS・KYC を伴う操作はしない制約）。したがって 200 の本文、失敗時の 502、返金の有無は未確認です。数字はすべて「402 が返るところ、無料の 200 が返るところ」までの実測です。
" }, { "見出し": "実測", "html": "| 面 | 条件 | 応答 | 本文 | 応答時間 | 読み取れること |
|---|---|---|---|---|---|
/ja | 無料（HTML） | 200 | 25,377 B | 680 ms | 日本語の入口 |
/ja | 無料（JSON） | 200 | 61,826 B | — | 同じ入口の機械向け表現 |
/openapi.json | 無料 | 200 | 148,467 B | 177 ms | 50 paths |
/product.json | 無料 | 200 | 573,800 B | 320 ms | 有料41経路と価格 |
/data.json | 無料 | 200 | 5,884 B | 122 ms | 市場データ |
/gas?chains=base,eth | 未払い | 402 | 21,429 B | 296 / 528 / 170 ms | 0.001 USDC |
/gas?chains=nope | 形式エラー | 400 | 377 B | 168 ms | 課金前に拒否 |
/gas/sample | 無料サンプル | 404 | 3,200 B | 155 ms | サンプルは無い |
/ja は Accept で表現が変わります。HTML を要求すると 25,377 B、何も付けない（または JSON を要求する）と 61,826 B の JSON が返りました。同じ入口でも、クライアントが読む形式でサイズが約2.4倍違うので、エージェントに読ませるなら JSON、人に見せるなら HTML を選びます。
/gas の 402 は3回とも同じ 21,429 B・同じヘッダ 5,464 B で、応答は 296・528・170 ms でした。本文の大きさは価格に比例せず、宣言と説明の量で決まります。
/ja（HTML 25,377 B）：日本語の記事一覧です。人に読ませる入口。/openapi.json（200・148,467 B・50 paths・177 ms）：引数と戻り値の形。買う前の実装確認はここで済みます。/product.json（200・573,800 B・320 ms）：有料 41 経路の価格宣言。0.001〜3 USDC で、価格は 9 種類（0.001 / 0.002 / 0.003 / 0.005 / 0.01 / 0.02 / 0.05 / 0.25 / 3）でした。/product.json は 41 経路を全部返すため 573,800 B あり、/openapi.json より大きい。全部を LLM に読ませず、JSON をパースして安い順・用途で絞るのが使い方です。代表的な価格は次の通り（/product.json の宣言値）。
| 経路 | 価格（USDC） | 何に使うか |
|---|---|---|
/gas | 0.001 | 5チェーンのガス価格 |
/price | 0.02 | 価格の相場 |
/compat-check | 0.02 | 仕様変更の検出 |
/check | 0.05 | 相手の生存確認 |
/changes/bundle | 0.25 | 差分のまとめ買い |
価格は1回ごとで、アカウントもサブスクもありません。まず 0.001 の経路で1回だけ試すのが、最も小さい確認単位です。
" }, { "見出し": "手順2: 402 の本文とヘッダを読む", "html": "未払いの GET は 402 Payment Required を返します。ここで読むべきは本文と payment-required ヘッダの両方です。当方の /gas では、同じ価格が違うキー名と違う network 表記で2回宣言されていました。
| 場所 | x402Version | network | 価格のキー | 値 |
|---|---|---|---|---|
| 本文（JSON） | 1 | base | maxAmountRequired | 1000 |
| ヘッダ（base64 JSON） | 2 | eip155:8453 | amount | 1000 |
金額は最小単位で、USDC は小数6桁なので 1000 は 0.001 USDC。本文の accepts[0] は scheme / network / maxAmountRequired / resource / description / mimeType / payTo / maxTimeoutSeconds / asset / extra の 10項目でした。ヘッダの accepts[0] は scheme=exact・asset=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913・maxTimeoutSeconds=60・extra={\"name\":\"USD Coin\",\"version\":\"2\"} です。
maxTimeoutSeconds=60 は支払いの期限で、応答が60秒で切れるという意味ではありません。本文だけを読むクライアント、ヘッダだけを読むクライアントがあるため、両方を読み、価格と受取先が一致することを確かめてから署名します。片方だけを前提に実装すると、キー名（maxAmountRequired / amount）か network（base / eip155:8453）の違いで読めないクライアントが出ます。
形式の検査は課金の前に済みます。/gas?chains=nope は 400・377 B・168 ms で、本文は invalid_chains と許可された連鎖名（base, eth, arbitrum, optimism, polygon）を返しました。402（21,429 B）と比べて約57分の1の返答で、課金も上流の RPC 呼び出しも起きません。
無料サンプルは期待できません。/gas/sample は 404・3,200 B・155 ms でした。当方の 402 にはサンプルを返す URL の宣言が無く、無料で見られるのは 402 の宣言までです。同じ 402 でも、売り手によっては try_before_you_pay やサンプル経路を持つことがあります。402 を読んで「無料で試せる場所」を探し、無ければ形式検査だけで止めるのが安全です。
無料の機械可読な入口も同じ時刻に測りました。/openapi.json 200・50 paths・148,467 B・177 ms、/data.json 200・5,884 B・122 ms、/product.json 200・573,800 B・320 ms です。引数の制約は /openapi.json、価格は /product.json で、どちらも支払い前に読めます。
買い手の流れは、402 を読む → 同じ URL に PAYMENT-SIGNATURE を付けて再送 → 200 を受ける、の1回です。当方はこの記事で支払いを実行していないため、200 の本文と形は未確認です。以下は 402 の宣言から言えることだけです。
1000 最小単位）。/gas は5チェーン（base / eth / arbitrum / optimism / polygon）を1回で返す宣言です。/failure/sample 実測で refund は未宣言）。失敗しても USDC は戻らない前提で、1回分の上限を決めてから署名します。エージェントに買わせるなら、「402 の本文とヘッダを読み、価格・受取先・期限を照合し、1回分の上限を超えたら署名しない」を実装の入口に置きます。残高や秘密鍵の扱いはこの記事の範囲外です。
" }, { "見出し": "売る側の x402 課金 実装（AIエージェント 決済の注意）", "html": "売る側も同じ 402 を返します。/product.json は有料 41 経路と価格を宣言し、0.001〜3 USDC の9種類の価格がありました。ただし宣言だけではカタログに載りません。2026-10-17 の実測では、掲載は成功した署名つき /verify が一度でもあった経路だけで決まり、無料ページ（402 を返さない面）は対象外でした。
カタログにキーワード検索はありません（2026-10-17 実測で ?search= ?q= ?tag= のいずれでも件数は不変）。買い手の LLM は返却された serviceName / description / tags を読んで選ぶため、検索語をメタデータにそのまま置くことが効きます。日本語で届けたいなら、日本語の語を説明かタグに literal に置く必要があります。
AIエージェント 決済では、未宣言を「無い」と読み替えないのが原則です。返金・再試行・失敗時の形が 402 に書かれていなければ、「読めない」であって「無い」ではありません。売る側は、失敗時に何を返すかを 402 に宣言しておくと、買い手のエージェントが判断できます。
" }, { "見出し": "未確認と次の一歩", "html": "200 の本文は取得していません（支払い・SMS・KYC は行わない制約）。したがって、ガス価格の鮮度、失敗時の 502、返金の有無、購入後の応答時間は未確認です。数字はすべて「402 が返るところ、無料の 200 が返るところ」までの実測です。
/ja の HTML が 25,377 B・JSON が 61,826 B と約2.4倍違うことは今回測りましたが、以前の計測（55,065 B）との差が記事追加によるものか計測条件の差かは特定していません。/product.json の 41 経路と価格は宣言値で、1本ずつ 402 を叩いて一致を確認したわけではありません。
買う前の確認手順は /ja/check-before-paying、価格の相場は /ja/price-benchmark、実装例は /ja/x402-implementation-example に実測でまとめています。仕様の全体は無料の /openapi.json（50 paths）で読めます。