エージェント価格パリティチェック
有料APIでは価格ドリフトが発生します。ドキュメントには$0.005と書かれているのに、実際の請求は$0.01、ディスカバリマニフェストには先月の$0.001がキャッシュされていることがあります。購入者は異議を申し立て、ディレクトリは「価格の不誠実さ」をフラグし、収益が漏れます。この5分で実行できるチェックは、それらを発見します。400以上のルートを持つ有料エッジを運用し、上記3つすべてが実際に発生した経験から抽出されました。
一致すべき3つの価格
- 宣伝価格 —
openapi.jsonのx-payment-info.price（+ 価格ページ） - チャレンジ価格 — 実際の402レスポンスの
accepts[].amount（原子単位）およびmaxAmountRequired - 決済価格 — ファシリテーターが実際に移動した金額（レシート/トランザクション値）
手順
- チャレンジを取得:
curl -s -i -X POST <url> -H 'content-type: application/json' -d '{}'→PAYMENT-REQUIRED（base64 JSON）をパース →accepts[0].amount（原子単位; USDCは6桁なので10000= $0.01） - 宣伝価格を取得:
openapi.json→ ルートごとのx-payment-info.price.amount - 差分比較: ルートごとに宣伝価格とチャレンジ価格を比較。不一致は方向を持った発見として記録（過請求 = 信頼低下 + 返金リスク; 過少請求 = 収益漏れ）
- マニフェスト確認:
/.well-known/x402を公開している場合、その金額が実際のチャレンジと一致するか確認。ディレクトリは古い金額をキャッシュし、古い価格を表示します。 - 1行修正ルール: チャレンジはランタイムの価格設定から生成されます。最初にランタイムソースを修正し、同じコミット内でドキュメント/マニフェストを再生成してください。ドキュメントだけの修正はすぐに古くなります。
発見結果スキーマ
{"routes_checked": N, "parity_ok": N, "overcharge": [{"path": "...", "advertised": "0.005", "charged": "0.01"}], "undercharge": [...], "stale_manifest": [...], "verdict": "PARITY|DRIFT"}
ルール
- localhostではなく、パブリックオリジンでチェックすること。プロキシ/WAFが書き換える可能性があります。
- 原子単位の計算: USDCは6桁。
50000は$50,000ではなく、$0.05です。 - 価格変更の前後に実行し、変更前の差分を記録として保持すること。
対象外
- 税金/VAT/手数料の加算計算（定価ではなく、決済コスト）
- コール単位ではない課金（サブスクリプション、メータードトークン課金）
例
質問: 「deep-auditを$0.05に値上げしましたが、世界と整合していますか？」
変更前: pricing.jsonは0.05、openapiは0.01、マニフェストは0.01、実際のチャレンジは0.01。誰も何週間も気づきませんでした。
変更後: {"overcharge": [], "undercharge": [{"path": "/v1/security-audit/deep", "advertised": "0.01", "charged": "0.05"}], "verdict": "DRIFT"} — 1つのコミットで3つの表面すべてを修正。ディレクトリキャッシュは次の決済時にリフレッシュされます。
バージョン
1.0.0 — DDGスターターシリーズ。