x402

x402 決済プロトコル

X402 決済プロトコルを使用して、有料 API エンドポイントを検索、確認、呼び出すには、npx [email protected] x402 コマンドを使用します。決済には Base 上の USDC を使用します。

ワークフロー

一般的な x402 ワークフローは次のとおりです。

1. サービスを検索する - bazaar を検索するか、既知のエンドポイントの詳細を取得します
2. 要件を確認する - 価格、メソッド、入力スキーマを確認します
3. リクエストを実行する - USDC による自動決済でエンドポイントを呼び出します

コマンド

Bazaar を検索する

CDP のベクトル検索を使用して、キーワードで有料サービスを検索します。

npx [email protected] x402 bazaar search <query> [-k <n>] [--network <network>] [--scheme <scheme>] [--max-price <price>] [--json]

オプション	説明
-k, --top <n>	検索結果の数。1～20（デフォルト：20）
--network <name>	チェーンで絞り込みます（base、base-sepolia、polygon、solana、solana-devnet）
--scheme <scheme>	決済スキームで絞り込みます：exact または upto
--max-price <price>	価格の上限（USD）（例：0.01）
--asset <address>	決済アセットのアドレスで絞り込みます
--pay-to <address>	受取人のウォレットアドレスで絞り込みます
--extensions <type>	拡張機能の種類で絞り込みます（例：outputSchema、bazaar）
--json	JSON 形式で出力します

Bazaar のリソースを一覧表示する

利用可能なすべてのリソースを参照します。

npx [email protected] x402 bazaar list [--network <network>] [--full] [--refresh] [--json]

オプション	説明
--network <name>	チェーンで絞り込みます（base、base-sepolia、polygon、solana、solana-devnet）
--full	スキーマを含む詳細情報をすべて表示します
--refresh	CDP API からリソースインデックスを再取得します
--json	JSON 形式で出力します

決済要件を確認する

決済を行わずに、エンドポイントの x402 決済要件を確認します。

npx [email protected] x402 details <url> [--json]

402 応答が返されるまで各 HTTP メソッド（GET、POST、PUT、DELETE、PATCH）を試して正しいメソッドを自動検出し、価格、利用可能な決済スキーム、ネットワーク、入出力スキーマを表示します。

有料リクエストを実行する

USDC による自動決済で x402 エンドポイントを呼び出します。

npx [email protected] x402 pay <url> [-X <method>] [-d <json>] [-q <params>] [-h <json>] [--max-amount <n>] [--json]

オプション	説明
-X, --method <method>	HTTP メソッド（デフォルト：GET）
-d, --data <json>	JSON 文字列形式のリクエストボディ
-q, --query <params>	JSON 文字列形式のクエリパラメーター
-h, --headers <json>	JSON 文字列形式のカスタム HTTP ヘッダー
--max-amount <amount>	USDC の最小単位で指定する決済上限（1000000 = $1.00）
--correlation-id <id>	関連する操作をグループ化します
--json	JSON 形式で出力します

例

# Search for weather-related paid APIs
npx [email protected] x402 bazaar search "weather"

# Search with more results
npx [email protected] x402 bazaar search "sentiment analysis" -k 10

# Check what an endpoint costs
npx [email protected] x402 details https://example.com/api/weather

# Make a GET request (auto-pays)
npx [email protected] x402 pay https://example.com/api/weather

# Make a POST request with body
npx [email protected] x402 pay https://example.com/api/sentiment -X POST -d '{"text": "I love this product"}'

# Limit max payment to $0.10
npx [email protected] x402 pay https://example.com/api/data --max-amount 100000

# Browse all bazaar resources with full details
npx [email protected] x402 bazaar list --full

USDC の金額

X402 では USDC の最小単位（小数点以下 6 桁）を使用します。

最小単位	USD
1000000	$1.00
100000	$0.10
50000	$0.05
10000	$0.01

前提条件

• 検索／詳細：認証は不要です
• 決済：十分な USDC 残高（npx [email protected] balance）があり、認証済みである必要があります（npx [email protected] auth login <email>）

エラー処理

• 「認証されていません」 - まず npx [email protected] auth login <email> を実行してください
• 「X402 の支払い要件が見つかりません」 - URL が x402 エンドポイントではない可能性があります
• 「CDP API が 429 を返しました」 - レート制限されています。利用可能な場合はキャッシュされたデータが使用されます
• 「残高が不足しています」 - ウォレットに USDC を入金してください（確認するには npx [email protected] balance を実行してください）