API リファレンス

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

Scan APIアクセスにはPro以上のプランが必要です。ScamDB読み取りは無料です。

認証

Scan APIリクエストにはtfk_プレフィックスのAPIキーが必要です。ダッシュボードの「設定」→「API Keys」から作成できます。

X-API-Keyヘッダーで送信:

curl -H "X-API-Key: tfk_your_key_here" \

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

ベースURL

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

Scan API

メソッド	パス	認証	説明
POST	`/public/scan`	`tfk_`	アドレスをスキャン（Bitcoin・Ethereum・Avalanche・Polygon・Solana対応）。結果は30分キャッシュされます。
POST	`/public/scan/batch`	`tfk_`	バッチスキャンジョブを投入（Pro: 100件/回）
GET	`/public/scan/{job_id}`	`tfk_`	バッチジョブの進捗を確認
GET	`/public/scan/{job_id}/results`	`tfk_`	バッチジョブの結果を取得
GET	`/public/health`	不要	APIヘルスチェック（認証不要）

POST /public/scan

リクエスト

{
  "address": "347QFbejDBdMZFTxpmn6evvvqyXiqZTCd7",
  "chain": "bitcoin"
}

レスポンス

{
  "success": true,
  "address": "347QFbejDBdMZFTxpmn6evvvqyXiqZTCd7",
  "chain": "bitcoin",
  "address_type": "wallet",
  "risk_level": "CRITICAL",
  "risk_score": 0,
  "detection_count": 4,
  "detections": [
    {
      "detector_id": "B2",
      "detector_name": "OFAC_SANCTIONED",
      "severity": "CRITICAL",
      "description": "Address is on OFAC SDN sanctions list",
      "details": { "category": "OFAC_SANCTIONED" }
    }
  ],
  "metadata": {
    "btc_balance": 0.0,
    "total_transactions": 69,
    "is_sanctioned": true
  },
  "ml_anomaly_score": 0.3431,
  "scan_duration_ms": 19045,
  "cached": false
}

POST /public/scan/batch

バッチスキャンジョブを投入（Pro: 100件/回）

リクエスト

{
  "addresses": [
    {"address": "DezXAZ8z...", "chain": "solana"},
    {"address": "0x1234...", "chain": "ethereum"}
  ],
  "include_ai_analysis": true,
  "notify_email": "user@example.com"
}

レスポンス

{
  "success": true,
  "job_id": "550e8400-e29b-41d4-a716-446655440000"
}

ScamDB API

認証不要の公開OSINT API。IPベースレート制限あり。

メソッド	パス	認証	説明
GET	`/scamdb/lookup/{address}`	不要	アドレスがScamDBに登録されているか照合（無料・認証不要）
GET	`/scamdb/entries`	不要	検証済みScamDBエントリー一覧（ページネーション対応）
GET	`/scamdb/entries/{scam_id}`	不要	個別ScamDBエントリーを取得
GET	`/scamdb/stats`	不要	ScamDB統計情報
GET	`/scamdb/search?q=...`	`tfk_`	ScamDB全文検索（tfk_キー必要）
POST	`/scamdb/report`	`tfk_`	スキャム報告を送信（tfk_キー必要）

GET /scamdb/lookup/{address}

curl https://chain-analyzer.com/api/v1/scamdb/lookup/7kMpieh2THdaC5eUvxFJDL3TdsQWVQCwdhsEjLj1eL26

レスポンス

{
  "found": true,
  "entry": {
    "id": "SCAM-001",
    "address": "7kMpieh2THdaC5eUvxFJDL3TdsQWVQCwdhsEjLj1eL26",
    "type": "drainer",
    "severity": "danger",
    "domains": ["solland.cc", "hibit.app"],
    "method": "FCFS airdrop phishing",
    "total_stolen_usd": 3700,
    "verified": true
  },
  "match_type": "exact"
}

レート制限

プラン	リクエスト/分	説明
Pro	60	Scan API
Enterprise	300	Scan API
Any (IP-based)	30	ScamDB reads

ScamDB読み取り: IPベース30 req/min。レート制限超過時は429エラーが返されます。

エラーコード

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

SDK（予定）

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

Python JavaScript Go

検知機能対応ネットワーク