x402 支払いプロトコル

npx awal@2.10.0 x402 コマンドを使用して、X402 支払いプロトコルを使用した有料 API エンドポイントを発見、検査、呼び出します。支払いは Base 上の USDC で行われます。

ワークフロー

一般的な x402 ワークフローは以下の通りです:

1. サービスを探す - バザーを検索するか、既知のエンドポイントの詳細を取得
2. 要件を確認する - 価格、メソッド、入力スキーマを検査
3. リクエストを実行する - 自動 USDC 支払いでエンドポイントを呼び出す

コマンド

バザーを検索

CDP のベクトル検索を使用してキーワード別に有料サービスを検索:

npx awal@2.10.0 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 として出力

バザーリソースをリスト表示

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

npx awal@2.10.0 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 awal@2.10.0 x402 details <url> [--json]

402 レスポンスを取得するまで各メソッド (GET、POST、PUT、DELETE、PATCH) を試して正しい HTTP メソッドを自動検出し、価格、受け入れられた支払いスキーム、ネットワーク、入出力スキーマを表示します。

有料リクエストを実行

自動 USDC 支払いで x402 エンドポイントを呼び出し:

npx awal@2.10.0 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>	カスタム HTTP ヘッダー (JSON 文字列)
--max-amount <amount>	最大支払い額 (USDC アトミックユニット、1000000 = $1.00)
--correlation-id <id>	関連する操作をグループ化
--json	JSON として出力

例

# 天気関連の有料 API を検索
npx awal@2.10.0 x402 bazaar search "weather"

# より多くの結果で検索
npx awal@2.10.0 x402 bazaar search "sentiment analysis" -k 10

# エンドポイントの料金を確認
npx awal@2.10.0 x402 details https://example.com/api/weather

# GET リクエストを実行 (自動支払い)
npx awal@2.10.0 x402 pay https://example.com/api/weather

# ボディ付き POST リクエストを実行
npx awal@2.10.0 x402 pay https://example.com/api/sentiment -X POST -d '{"text": "I love this product"}'

# 最大支払額を $0.10 に制限
npx awal@2.10.0 x402 pay https://example.com/api/data --max-amount 100000

# 完全な詳細を含むすべてのバザーリソースを参照
npx awal@2.10.0 x402 bazaar list --full

USDC 金額

X402 は USDC アトミックユニット (6 小数点) を使用します:

アトミックユニット	USD
1000000	$1.00
100000	$0.10
50000	$0.05
10000	$0.01

前提条件

• 検索/詳細: 認証不要
• 支払い: 認証が必要 (npx awal@2.10.0 auth login <email>) で、十分な USDC 残高が必要 (npx awal@2.10.0 balance)

エラーハンドリング

• "Not authenticated" - 先に npx awal@2.10.0 auth login <email> を実行
• "No X402 payment requirements found" - URL が x402 エンドポイントでない可能性
• "CDP API returned 429" - レート制限; キャッシュされたデータが利用可能な場合は使用
• "Insufficient balance" - ウォレットに USDC をチャージ (npx awal@2.10.0 balance で確認)