ドキュメントに戻る

x402 USDC マイクロペイメント API

ChainAnalyzer の AML 機能を、API キー不要・サブスクリプション不要で、 1 リクエスト単位の USDC 決済(Base または Solana)から呼び出せます。 AI エージェントが自律的に決済・分析を実行するワークフローに最適です。

x402 とは

x402 は HTTP ステータスコード 402 Payment Required を活用した 暗号資産ネイティブのマイクロペイメント プロトコルです。 クライアントは API を叩く → サーバーは 402 と支払い要件を返す → クライアントは USDC で署名 → 再送 → サーバーはファシリテータ経由で決済確認後レスポンス、という流れで動作します。 支払いは Coinbase x402 Facilitator によって検証・確定されます。

エンドポイントと価格

エンドポイントメソッド価格内容
/x402/api/address/{address}/sanctionsGET$0.003OFAC / FATF / JFSA / ScamDB 制裁リスト照合
/x402/api/address/{address}/risk-scoreGET$0.008AML リスク スコア(76+ 検知・ML 異常スコア・5 チェーン)
/x402/api/tx/{tx_hash}/coinjoinGET$0.01CoinJoin / ミキシング / タンブリング パターン検出
/x402/api/tx/{tx_hash}/traceGET$0.015トランザクション フロー追跡 + ML 異常検知
/x402/api/wallet/{address}/clusterGET$0.02Neo4j グラフ クラスタリングによる関連アドレス特定
/x402/api/batch/screeningPOST$0.05最大 50 アドレスの一括 AML スクリーニング

決済ネットワーク

  • Base(EVM)eip155:8453 上の USDC
  • Solana — メインネット上の USDC

どちらのネットワークでも 1 回の決済は数十ミリ秒〜数秒で確定します。 エージェントのウォレットに少額の USDC を入れておくだけで継続利用できます。

MCP サーバー経由(推奨)

Claude Desktop / Claude Code / Cursor / Windsurf / ChatGPT / Gemini など、 Model Context Protocol 対応の AI クライアントからは chainanalyzer-mcp npm パッケージ経由で 6 ツール全てを自然言語で呼び出せます。 Claude Desktop の claude_desktop_config.json に以下を追加するだけ:

{
  "mcpServers": {
    "chainanalyzer": {
      "command": "npx",
      "args": ["-y", "chainanalyzer-mcp"],
      "env": {
        "X402_WALLET_PRIVATE_KEY": "0x..."
      }
    }
  }
}

MCP サーバー公開のお知らせ も参照してください。

HTTP 直接呼び出し

自前のエージェント フレームワークから直接叩く場合:

# 1. First request — server returns HTTP 402 with payment requirements
curl -si "https://chain-analyzer.com/x402/api/address/bc1q.../risk-score"

# 2. Sign the x402 payment header with your wallet, then retry
curl -si \
  -H "X-PAYMENT: <signed-payment-header>" \
  "https://chain-analyzer.com/x402/api/address/bc1q.../risk-score"

x402 SDK(x402-axiosx402-fetch 等)を使えば、 署名・再送処理は自動化されます。

サービス ディスカバリー

サービスのメタデータと全エンドポイント・価格は、2 つの公開 URL から取得できます。

  • GET /.well-known/x402.json — 静的 x402 マニフェスト(x402 プロトコル標準)
  • GET /x402/api/discover — 動的ディスカバリー エンドポイント(サービス情報・エンドポイント一覧・決済ネットワーク)

サブスクリプション プランとの使い分け

既存の Pro / Enterprise プランを利用している場合は、 環境変数 CHAINANALYZER_API_KEY を設定すれば x402 の代わりに サブスクリプション枠から消費されます。 まとまった量を継続利用する場合はサブスクリプションが有利、 単発・自律エージェント・ワークフロー向けには x402 が最適です。

関連リンク

© 2026 ChainAnalyzer. All rights reserved.