パートナー投稿 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 リクエストです。まとめて投稿する場合はクライアント側で反復してください。
• 推測に基づくラベルは投稿しないでください。誤ったラベルは調査全体の信頼を損ないます。