/price は「その金額が x402 の市場で高いか安いか」を1回 0.02 USDC で返す API です。支払い前に返るのは 402（32,884 B・292 ms）で、価格と支払条件、そして無料プレビューの案内だけです。判定・パーセンタイル・サンプル数は、無料プレビューには入っていません。実際に 5通りの金額で叩くと、1,690 B・同一 SHA-256 が返り、amount は本文に反映されませんでした（abc でも 200）。
つまり「x402 price benchmark」を買う前に確かめられるのは、価格の帯までです。無料の /data.json には 2,330件の価格が6つの帯で入っていて、0.02 は $0.01〜$0.05 の 1,699件（72.9%）に入ります。中央値は 0.01 なので 0.02 は中央値の2倍。ここまでは 0 円で出せます。有料の 200 が足すのは、帯の中での正確な位置（パーセンタイル）と n、カテゴリ別の比較です。
もう1つ、実測で分かった注意点があります。プレビューが示す有料索引の生成時刻は 2026-10-15T14:49:56Z、無料の /data.json の更新は 2026-10-16T10:11:00Z で、無料データの方が約19時間新しいということです。同じ市場を見るなら、まず無料の新しい方を読み、足りない部分だけ 0.02 を払う順番が合理的です。
| リクエスト | 応答 | 大きさ | 応答時間 | 中身 |
|---|---|---|---|---|
/data.json | 200 | 5,884 B | 487 ms | 無料。2,503件・価格あり2,330件・6つの価格帯 |
/price?amount=0.02 | 402 | 32,884 B | 292 ms | 0.02 USDC の宣言のみ。200 の本文は未取得 |
/price?amount=0.02&preview=1 | 200 | 1,690 B | 436 ms | 判定・パーセンタイル・n なし |
/price?amount=0.05&preview=1 | 200 | 1,690 B | 150 ms | 上の本文と SHA-256 一致 |
/price?amount=1&preview=1 | 200 | 1,690 B | 151 ms | 同上 |
/price?amount=abc&preview=1 | 200 | 1,690 B | 138 ms | 不正な金額でも 400 にならない |
/price?preview=1（amount なし） | 200 | 1,690 B | 148 ms | 同上 |
/status.json | 200 | 26,388 B | 8,942 ms | 無料。/price は納品7件・最終 2026-10-18T01:14:45Z |
プレビューの本文はこういう形です: product_id / preview / path / summary / not_in_a_preview / full_report / if_this_helped。summary に入るのは索引の有無・生成時刻・呼び出し元の支払い条件（amount_atomic=20000）・basis だけです。質問した金額は、amount を渡しても返りません。
402 は 32,884 B と大きめですが、内訳は accepts[0]（10項目）と terms（返金なし・保証なしの明記）、receive（2回呼び方の説明）、そして商品説明です。payment-required ヘッダは 6,888 B でした。無料プレビューの 1,690 B と比べると約19.5倍あります。
/data.json は 2026-10-16T10:11:00Z 更新、2,503件（価格あり 2,330件・価格なし 172件）で、価格を6つの帯に分けて返します。2026-10-20 に取得した値は次の通りです。
| 帯 | 件数 | 2,330件に占める割合 | 累積 |
|---|---|---|---|
| under $0.005 | 424 | 18.2% | 18.2% |
| $0.005 - $0.01 | 142 | 6.1% | 24.3% |
| $0.01 - $0.05 | 1,699 | 72.9% | 97.2% |
| $0.05 - $0.10 | 28 | 1.2% | 98.4% |
| $0.10 - $1.00 | 33 | 1.4% | 99.8% |
| $1.00 and above | 4 | 0.2% | 100% |
中央値 0.01・p90 0.01・p99 0.10・最大 5 USDC。この帯だけでも、いくつかの金額の位置は言えます。
これが「帯まで」の意味です。0.02 が中央値の2倍なのは無料で分かりますが、0.02 が上位何%かは、帯の中の分布が無いので決められません。有料の /price の 200 は、ここをprice_position.percentile_text として埋めると宣言しています（未取得）。
5通り（0.02 / 0.05 / 1 / abc / amount なし）のプレビューがバイト単位で同一だったことは、2つの読み方を許します。1つは「プレビューは商品の形だけを見せるもの」で、金額に依存しないのは設計通り。もう1つは「金額の形式や妥当性は、課金の前にも後にも検証されない」という実装上の事実です。abc が 200 を返すのは後者で、入力の誤りを 402 の前に 400 で止める他経路（例: /news?limit=abc は 400）とは挙動が違います。
買い手にとって大事なのは、「この金額は相場か」という問いに、プレビューが答えないことです。プレビューの not_in_a_preview は、判定（verdict）・p25/median/p90・n・カテゴリ別・所見を「有料の 200 で返す」と明記しています。つまり 1,690 B を読んでも、0.02 が高いか安いかは1文字も分かりません。
402 の accepts[0].description によると、200 の本文は verdict（label / plain / one_line / rule）、price_position（percentile_text / band / multiple_of_median）、market（sample_size / p25 / median / p90 / bands / fetched_at）、category、my_price を含みます。比較は同梱スナップショットから返り、第三者へは問い合わせない、とも書いています。
ここで実測できた食い違いが1つあります。プレビューの summary.index_generated_at は 2026-10-15T14:49:56.365Z、index_source_fetched_at は 2026-10-15T14:47:05.456Z。一方、無料の /data.json の updated_at は 2026-10-16T10:11:00Z です。有料の索引は、無料データより約19時間21分古い時点の市場を指しています。
これは「有料が間違い」という話ではありません。有料の判定は同梱スナップショットに固定されているので、呼ぶたびに答えが変わらない（監査しやすい）という利点があります。ただし「今の相場」を知りたい買い手には、無料の /data.json の方が新しいという事実は、0.02 を払う前に知っておく価値があります。払うなら「新しい帯」と「古いが固定された判定」のどちらが欲しいかで決めます。
/data.json で足ります。実測 5,884 B・487 ms で、更新日時は updated_at に明記されています。スクリプトは十数行です。curl -s \"https://x402-catalog-history.ai-business-surface.workers.dev/data.json\" \\\n | jq '.price_distribution | {median_usd, p90_usd, p99_usd, bands}'まずこの1行で帯を取り、自分の価格がどの帯かを確認する。帯の外（p99 超えなど）なら、0.02 を払う前に値付けそのものを見直す材料になります。0.02 を払うのは、帯の中の位置が必要になったときで十分です。
" }, { "見出し": "次の一歩", "html": "市場全体の分布と自分の値付けの置き方は /ja/price-benchmark（2,330件の中央値・p90・p99）、売り手としての値付けは /ja/what-price-to-charge-x402、402 とプレビューの読み方は /ja/is-x402-endpoint-alive に実測でまとめています。価格の生データは /data.json（無料・CC0）、当方の宣言価格は /product.json で読めます。