パートナー投稿API

このAPIについて

Contribute APIは、取引所ウォレット・詐欺アドレス・発行体ウォレットなど「既知アドレスのラベル」を投稿するためのエンドポイントです。VASP / AMLパートナーのチーム向けに設計されており、管理者アカウントを持たずに自組織の知見をレジストリへ持ち込めます。

投稿されたエントリはstatus="pending" で保存され、ChainAnalyzerのアナリストがレビューします。承認されるとstatus="active" となり、スキャン・スクリーニング・ScamDB照合に反映されます。

対象: 取引所・カストディアン・発行体・AMLベンダーなど、自組織で検証済みのアドレス情報を持つチーム。

認証

すべてのリクエストにX-Contributor-API-Keyヘッダーが必要です。キーはcak_ プレフィックスで、ChainAnalyzerが組織ごとに発行します(自己発行はできません)。

curl -H "X-Contributor-API-Key: cak_your_key_here" \

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

キーは組織単位でスコープ(カテゴリ / チェーン)を持ち、いつでも一時停止・失効できます。スコープ外のチェーンやカテゴリを投稿すると403が返ります。

キーの発行はお問い合わせから依頼してください。発行時に平文キーが1度だけ共有されます(再取得不可)。

キーはサーバー側にのみ保管し、ブラウザやモバイルアプリに埋め込まないでください。漏洩が疑われる場合はご連絡いただければ即時に失効させます。

エンドポイント

POST https://chain-analyzer.com/api/v1/contribute/known-entity

リクエストボディ

有効なenum

registry_type

chain

アドレスの正規化

EVM系チェーン(ethereum / polygon / bsc / base / arbitrum / optimism / avalanche / kaia / evm)のアドレスは小文字に正規化されます。btc / solana / tron / xrpはbase58系で大文字小文字が意味を持つため、送信された文字列をそのまま保存します。これらのチェーンでは大文字小文字を変換せずに送信してください。

リクエスト例

取引所のホットウォレットをTRONで投稿する例です。

curl -X POST https://chain-analyzer.com/api/v1/contribute/known-entity \
  -H "X-Contributor-API-Key: cak_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "registry_type": "exchange",
    "chain": "tron",
    "address": "TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "label": "ExampleExchange Hot 1",
    "category": "exchange_hot_wallet",
    "metadata": {
      "exchange_name": "ExampleExchange",
      "wallet_type": "hot"
    },
    "verification_source": "internal treasury records",
    "notes": "Primary TRC-20 settlement wallet, active since 2025-11."
  }'

レスポンス

成功時は201 Createdと、pending状態のエントリIDが返ります。

HTTP/1.1 201 Created

{
  "ok": true,
  "id": "3d1f0c6e-5a2b-4f19-8f7a-0c9d2e6b41aa",
  "status": "pending",
  "message": "Submission queued for admin review. You will be notified when reviewed."
}

エラー

レビューの流れ

1. 投稿がstatus="pending" で保存され、ChainAnalyzerのレビュー担当に通知されます。
2. アナリストが証跡を確認します。verification_sourceがあるエントリから優先的に処理されます。
3. 承認されるとstatus="active" になり、スキャン結果・スクリーニング・レジストリ照合に反映されます。証跡が不十分な場合はdisputedとして保留されます。

キーの疎通確認

投稿の前に /contribute/whoamiでキーと有効なスコープを確認できます(レジストリには何も書き込みません)。

curl -H "X-Contributor-API-Key: cak_your_key_here" \
  https://chain-analyzer.com/api/v1/contribute/whoami

投稿のガイドライン

• 自組織で検証できるアドレスだけを投稿してください。伝聞や推測に基づく投稿はレビューで落ちます。
• ラベルは英語で、「運営者名 + 用途」の形に揃えてください(例: "ExampleExchange Hot 1"、"ExampleExchange Deposit Sweep")。
• 取引所ウォレットはmetadataにexchange_nameとwallet_type (hot / cold / deposit / withdrawal)を入れてください。
• 不正アドレスには、事件・手口が特定できる証跡(公開レポート・事件番号・内部調査ID)を必ず添えてください。
• 1アドレス1リクエストです。まとめて投稿する場合はクライアント側で反復してください。
• 推測に基づくラベルは投稿しないでください。誤ったラベルは調査全体の信頼を損ないます。