API リファレンス

REST APIでChainAnalyzerをシステムに統合

APIアクセスにはStarter以上のプランが必要です。

認証

すべてのAPIリクエストにはAPIキーが必要です。 ダッシュボードの「設定」→「APIキー」から取得できます。

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.chain-analyzer.com/v1/scan

ベースURL

https://api.chain-analyzer.com/v1

エンドポイント

POST /scan

単一アドレスをスキャン

リクエスト

{
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "chain": "ethereum"  // "ethereum" | "bitcoin"
}

レスポンス

{
  "address": "0x1234...5678",
  "chain": "ethereum",
  "risk_level": "HIGH",
  "risk_score": 75,
  "detections": [
    {
      "type": "MIXER_CONTACT",
      "service": "Tornado Cash",
      "transaction": "0xabc...def",
      "timestamp": "2024-01-15T10:30:00Z"
    }
  ],
  "scanned_at": "2024-02-01T12:00:00Z"
}
POST /scan/batch

複数アドレスを一括スキャン（Pro以上）

リクエスト

{
  "addresses": [
    "0x1234...",
    "0x5678..."
  ],
  "chain": "ethereum"
}
GET /scan/:id

過去のスキャン結果を取得

GET /scans

スキャン履歴一覧を取得

クエリパラメータ

パラメータ型説明
limitnumber取得件数（デフォルト: 20, 最大: 100）
offsetnumberオフセット
chainstringチェーンでフィルタ
risk_levelstringリスクレベルでフィルタ

レート制限

プランリクエスト/分リクエスト/日
Starter10500
Pro605,000
Enterprise300無制限
レート制限超過時は429エラーが返されます。Retry-Afterヘッダーを確認してください。

エラーコード

コード説明
400不正なリクエスト（パラメータエラー）
401認証エラー（APIキーが無効または未設定）
403アクセス拒否（プランの機能制限）
404リソースが見つからない
429レート制限超過
500サーバーエラー

SDK（予定）

Python、JavaScript、Go用のSDKを準備中です。

Python JavaScript Go
検知機能 対応チェーン