Solanaウォレットのアイデンティティを検索する方法

ウォレットAPIはベータ版です。エンドポイントと応答形式が変更される可能性があります。

概要

ウォレットアイデンティティエンドポイントは、中央集権型取引所、DeFiプロトコル、機関、およびその他の認識されているエンティティを含むSolanaで既知のウォレットアドレスを識別します。コンプライアンス、分析、既知のアドレスの人間が読める名前の表示に使用します。単一のエンドポイント（GET /v1/wallet/{wallet}/identity）とバッチエンドポイント（POST /v1/wallet/batch-identity、最大100エントリ）は、SNS .solドメインおよびANSカスタムTLD（例：.bonk、.poor、.abc）も受け入れます。ドメイン解決はメインネットのみです。このエンドポイントは、OrbおよびHelius Solanaブロックエクスプローラーを支える同じアイデンティティシステムを使用します。データベースには32,500以上のラベル（人間が読める主要な名前、3,000以上のプログラムを含む）と21.5M以上のタグ（「Binance預金アドレス」や「Seeker Phone」などのカテゴリー属性）が含まれ、継続的に成長しています。単一およびバッチエンドポイント（GET /v1/wallet/{wallet}/identity、POST /v1/wallet/batch-identity）には、有料プランが必要です。無料プランのAPIキーを使用して行われたリクエストは403 Forbiddenを返します。プラン要件で完全なカバレッジテーブルを参照してください。

使用タイミング

ウォレットアイデンティティAPIを使用して、次の場合に必要があります：

取引所ウォレットを特定する: ウォレットがBinance、Coinbase、Krakenなどに属しているかどうかを判断します。
プロトコルアクティビティを追跡する: DeFiプロトコルウォレットとトレジャリーアドレスを特定します。
コンプライアンスおよびAML: 既知のエンティティが関与するトランザクションをフラグします。
分析: データパイプラインでウォレットタイプを分類します。
ユーザーエクスペリエンス: 「Binance 1に送信」などのように、生のアドレスの代わりに表示します。
バッチ処理: 数百のアドレスを効率的に検索します。

クイックスタート

単一ウォレット検索

単一のウォレットアドレスのアイデンティティ情報を検索します。

JavaScript
Python
cURL

const getWalletIdentity = async (address) => {
  const url = `https://api.helius.xyz/v1/wallet/${address}/identity?api-key=YOUR_API_KEY`;

  const response = await fetch(url);
  if (!response.ok) {
    if (response.status === 404) {
      console.log("No identity found for this address");
      return null;
    }
    throw new Error(`HTTP error! status: ${response.status}`);
  }

  const identity = await response.json();
  console.log(`Found: ${identity.name} (${identity.category})`);
  return identity;
};

// Example: Binance wallet
getWalletIdentity("HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664");

import requests

def get_wallet_identity(address: str):
    url = f"https://api.helius.xyz/v1/wallet/{address}/identity"
    headers = {"X-Api-Key": "YOUR_API_KEY"}

    response = requests.get(url, headers=headers)

    if response.status_code == 404:
        print("No identity found for this address")
        return None

    response.raise_for_status()
    identity = response.json()
    print(f"Found: {identity['name']} ({identity['category']})")
    return identity

# Example: Binance wallet
get_wallet_identity("HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664")

curl "https://api.helius.xyz/v1/wallet/HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664/identity?api-key=YOUR_API_KEY"

ドメイン名で検索する

SNS .solドメインまたはANSカスタムTLDを直接渡すことも可能で、エンドポイントはドメインを解決し、所有者アドレスのアイデンティティを返します：

JavaScript
Python
cURL

// Works identically — the endpoint resolves the domain first.
const identity = await getWalletIdentity("toly.sol");

// ANS custom TLD
await getWalletIdentity("miester.bonk");

# Works identically — the endpoint resolves the domain first.
identity = get_wallet_identity("toly.sol")

# ANS custom TLD
get_wallet_identity("miester.bonk")

# SNS (.sol) domain
curl "https://api.helius.xyz/v1/wallet/toly.sol/identity?api-key=YOUR_API_KEY"

# ANS custom TLD
curl "https://api.helius.xyz/v1/wallet/miester.bonk/identity?api-key=YOUR_API_KEY"

単一エンドポイントの応答は、解決済みアドレスの標準的なアイデンティティオブジェクトです。入力と出力を相関させる必要がある場合（たとえば、多くのドメインを一度に検索する場合）、バッチエンドポイントを使用します。

ドメイン解決はメインネットのみです。Devnet/Testnetでは、このエンドポイントへのドメイン入力は400を返します。ポジティブな解決は最大2時間キャッシュされるため、最近転送されたドメインは一時的に以前の所有者のアイデンティティに解決される可能性があります。

バッチ検索（最大100エントリ）

性能向上のため、単一リクエストで複数のエントリを検索します。各エントリはアドレスまたはドメイン名のどちらかです。

JavaScript
Python
cURL

const batchIdentityLookup = async (addresses) => {
  const url = "https://api.helius.xyz/v1/wallet/batch-identity?api-key=YOUR_API_KEY";

  const response = await fetch(url, {
    method: "POST",
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({ addresses })
  });

  if (!response.ok) {
    throw new Error(`HTTP error! status: ${response.status}`);
  }

  const identities = await response.json();
  return identities;
};

// Example: Mix addresses and domains in a single request
const addresses = [
  "HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664", // Binance (address)
  "toly.sol",                                      // SNS domain
  "miester.bonk"                                   // ANS custom TLD
];

batchIdentityLookup(addresses).then(identities => {
  identities.forEach(identity => {
    if (identity.unresolved) {
      console.log(`${identity.inputDomain}: could not be resolved`);
      return;
    }
    const label = identity.inputDomain
      ? `${identity.inputDomain} → ${identity.address}`
      : identity.address;
    console.log(`${label}: ${identity.name}`);
  });
});

import requests

def batch_identity_lookup(addresses: list[str]):
    url = "https://api.helius.xyz/v1/wallet/batch-identity"
    headers = {
        "X-Api-Key": "YOUR_API_KEY",
        "Content-Type": "application/json"
    }

    response = requests.post(
        url,
        headers=headers,
        json={"addresses": addresses}
    )

    response.raise_for_status()
    return response.json()

# Example: Mix addresses and domains in a single request
addresses = [
    "HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664",  # Binance (address)
    "toly.sol",                                       # SNS domain
    "miester.bonk"                                    # ANS custom TLD
]

identities = batch_identity_lookup(addresses)
for identity in identities:
    if identity.get("unresolved"):
        print(f"{identity['inputDomain']}: could not be resolved")
        continue
    label = f"{identity['inputDomain']} -> {identity['address']}" if identity.get("inputDomain") else identity["address"]
    print(f"{label}: {identity['name']}")

curl -X POST "https://api.helius.xyz/v1/wallet/batch-identity?api-key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "addresses": [
      "HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664",
      "toly.sol",
      "miester.bonk"
    ]
  }'

応答形式

単一の検索が成功すると、解決済みアドレスのアイデンティティオブジェクトが返されます：

{
  "address": "HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664",
  "type": "exchange",
  "name": "Binance 1",
  "category": "Centralized Exchange",
  "tags": ["Centralized Exchange"]
}

バッチ応答では、入力がドメイン名であったエントリには追加のinputDomainフィールドがあり、応答を元のリクエストに関連付けることができます：

{
  "address": "7v91N7iZ9mNicL8WfG6cgSCKyRXydQjLh6UYBWwm6y1Q",
  "type": "wallet",
  "name": "toly",
  "category": "Key Opinion Leader",
  "tags": ["Key Opinion Leader"],
  "inputDomain": "toly.sol"
}

バッチ要求のドメインが解決できない場合、バッチは失敗しません。エントリはaddress: null、type: "unknown"、unresolved: trueと共にその場で返されます。リクエストの順序は保持されます。

{
  "address": null,
  "type": "unknown",
  "inputDomain": "nonexistent-xyz.sol",
  "unresolved": true
}

単一エンドポイントでは、ウォレットにアイデンティティエントリがない場合、またはドメイン入力が解決されない場合は404が返されます：

{
  "error": "No identity information available for this address",
  "code": 404
}

{
  "error": "Domain 'nonexistent-xyz.sol' could not be resolved",
  "code": 404
}

アイデンティティカテゴリー

ウォレットやプログラムは、Orbアイデンティティデータベースによってカテゴリ化されています。アカウントとプログラムは別々のカテゴリーセットを使用します。以下の表はサポートされているすべてのカテゴリをリストしています。

アカウントタグタイプ

カテゴリ	説明	例
中央集権型取引所	CEXウォレットおよびホットウォレット	Binance 1, Coinbase 1, Kraken, OKX Exchange 1, Bybit Hot Wallet
クロスチェーンブリッジ	ブリッジプロトコルアドレス	Wormhole Bridge, AllBridge, Portal Bridge, deBridge
DeFi	DeFiプロトコルアドレス	Jupiter, Raydium, Orca, Marinade Finance, Kamino
キーオピニオンリーダー	著名な個人やインフルエンサー	Anatoly Yakovenko, Raj Gokal
マーケットメイカー	マーケットメイキングファーム	Jump Trading, Wintermute, GSR Markets
トレーディングファーム	プロプライエタリトレーディングファーム	Alameda Research, DRW Trading
バリデーター	バリデーターとステークプールのアドレス	Coinbase Validator, Jito Validator, Figment Validator
トレジャリー	プロジェクトやプロトコルトレジャリー	Marinade Treasury, Helium Treasury, Solana Foundation Treasury
DAO	自律分散型組織	Mango DAO, Grape DAO, MonkeDAO Treasury
NFT	NFTマーケットプレイスとプロジェクト	Magic Eden, Tensor, OpenSea Solana, DeGods Treasury
ステークプール	リキッドステーキングプールアドレス	Marinade Stake Pool, Jito Stake Pool, BlazeStake
マルチシグ	マルチシグネチャウォレット	Squads Multisig, Solana Foundation Multisig
オラクル	プライスフィードとオラクルプロバイダー	Pyth Network, Switchboard Oracle, Chainlink Solana
ゲーム	ゲーミングとGameFiプロジェクト	Star Atlas, Aurory, Genopets Treasury
支払い	支払いプロセッサー	Solana Pay, Sphere, Helio Pay
ツール	開発者ツールとユーティリティ	Phantom Wallet, Backpack, Solflare Wallet
エアドロップ	エアドロップ配布アドレス	Jupiter Airdrop, Pyth Airdrop Distributor
ガバナンス	ガバナンスプログラムのアドレス	Realms Governance, SPL Governance
権限	プログラムの権限と管理者	Token Program Authority, Metaplex Authority
Jito	Jito 特定のアドレス	Jito Tip 1, Jito Tip 2, Jito MEV Payment
メムコイン	メムコインプロジェクト	Bonk Treasury, Dogwifhat, Book of Meme
カジノ＆ギャンブル	ギャンブルとカジノdApps	Stake.com Hot Wallet, Rollbit, DexSport
DePIN	分散型物理インフラストラクチャ	Helium Network, Render Network, Hivemapper
プロプライエタリAMM	カスタムAMM実装	Phoenix DEX, GooseFX
リステーク	リステーキングプロトコル	Solayer, Fragmetric
ボールト	ボールトとカストディアドレス	Solend Vault, Tulip Vault, Francium Vault
手数料	手数料徴収アドレス	Jupiter Fee Collector, Raydium Fees
資金調達	資金調達およびICOアドレス	Token Sale Wallet, Fundraise Multisig
ジェネシスブロック配布	ジェネシス配布アドレス	Solana Genesis Distribution
非流通供給	非流通トークンアドレス	Team Vesting Wallet, Foundation Reserve
トランザクション送信	トランザクション送信サービス	Jito Tip 1, Jito Tip 2, Helius Sender Tip 1
システム	Solanaシステムプログラム	System Program, Config Program
X402	X402プロトコルアドレス	X402 Protocol
その他	カテゴリ化されていない既知のアドレス	Various known wallets

悪意のあるカテゴリ

カテゴリ	説明	例
エクスプロイター、ハッカー＆詐欺	既知のエクスプロイトとハックアドレス	Wormhole Exploiter Wallet, SagaDAO Hacker Wallet, Mango Exploiter
ハッカー	確認されたハッカーアドレス	Solana Hack 2022, DeFi Protocol Hacker
ラガー	ラグプル実行者	Squid Game Token Rugger, Known Rug Pull Wallet
詐欺師	確認された詐欺アドレス	Fake Airdrop Scammer, Phishing Scam Wallet
スパム	スパムトークン作成者	Spam Token Creator, Airdrop Spammer

プログラムカテゴリ

プログラム（スマートコントラクト）は個別に分類されます：

カテゴリ	説明	例
スワップ	トークンスワッププロトコル	Jupiter, Raydium, Orca
DeFi	一般的なDeFiプロトコル	Drift, Mango
借入貸出	貸出プロトコル	Solend, MarginFi
NFT	NFTマーケットプレイス	Magic Eden, Tensor
ステーキング	ステーキングプログラム	Marinade, Jito
ブリッジ	クロスチェーンブリッジ	Wormhole, AllBridge
アグリゲーター	DEXアグリゲーター	Jupiter Aggregator
パーペチュアル	パーペチュアルフューチャーズ	Drift, Mango
オラクル	オラクルプロバイダー	Pyth, Switchboard
ランチパッド	トークンランチパッド	Raydium Launchpad
ガバナンス	ガバナンスプログラム	SPL Governance
ゲームまたはカジノ	ゲーミングプログラム	Star Atlas
予測市場	予測市場	Drift Predictions
支払い	支払いプロトコル	Solana Pay
プライバシー	プライバシープロトコル	Elusiv
圧縮	状態圧縮	Bubblegum
インフラストラクチャ	コアインフラストラクチャ	Metaplex
ツール	開発者ツール	Clockwork
RWA	実世界の資産	Ondo Finance
DePIN	分散型インフラストラクチャ	Helium, Render
DeSci	分散型科学	VitaDAO
エアドロップ	エアドロッププログラム	Merkle distributors
Web3	Web3アプリケーション	Various
ネイティブ	Solanaネイティブプログラム	System Program
プロプライエタリAMM	カスタムAMM設計	Phoenix
トレーディングスナイパー	トレーディングボット	MEV bots
アービトラージまたはサンドイッチボット	MEVおよびアーブボット	Jito bundles
スパム	スパムプログラム	Spam tokens
その他	カテゴリ化されていないプログラム	Various

使用例

取引所入金をフラグする

資金が中央集権型取引所に送金されたときに特定します：

const checkIfExchange = async (address) => {
  try {
    const identity = await getWalletIdentity(address);
    if (identity && identity.category === "Centralized Exchange") {
      console.log(`Funds sent to ${identity.name}`);
      return true;
    }
  } catch (error) {
    // Not a known exchange
  }
  return false;
};

人間が読める名前を表示する

UIでアドレスの代わりにフレンドリーネームを表示します：

const getDisplayName = async (address) => {
  try {
    const identity = await getWalletIdentity(address);
    return identity ? identity.name : shortenAddress(address);
  } catch (error) {
    return shortenAddress(address);
  }
};

// Usage in UI
const displayName = await getDisplayName("HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664");
// Returns: "Binance 1" instead of "HXsKP...G664"

トランザクションの相手先をバッチ処理する

トランザクションのリストで全ての相手先を効率的に特定します：

const identifyTransactionCounterparties = async (transactions) => {
  // Extract all unique addresses
  const addresses = [...new Set(
    transactions.map(tx => tx.counterparty)
  )];

  // Batch lookup (up to 100 at a time)
  const allIdentities = [];
  for (let i = 0; i < addresses.length; i += 100) {
    const chunk = addresses.slice(i, i + 100);
    const identities = await batchIdentityLookup(chunk);
    allIdentities.push(...identities);
  }

  // Create a map for quick lookup
  const identityMap = new Map(
    allIdentities.map(id => [id.address, id])
  );

  // Enrich transactions with identity info
  return transactions.map(tx => ({
    ...tx,
    counterpartyName: identityMap.get(tx.counterparty)?.name || "Unknown"
  }));
};

ベストプラクティス

複数のルックアップにはバッチエンドポイントを使用します。 複数のアドレスを検索する場合、POST /v1/wallet/batch-identityは個々のリクエストを行うよりもはるかに高速です。
404応答を適切に処理します。 全てのウォレットにアイデンティティ情報があるわけではありません。生のアドレスを表示することを代替とします。
結果をキャッシュします。 アイデンティティデータは頻繁に変わるものではありません。ローカルにキャッシュしてAPIコールを減らします。
バッチサイズ制限を尊重します。 バッチエンドポイントは1リクエストあたり最大100エントリをサポートしています。大規模なデータセットは適宜分割します。

よくあるエラー

エラーコード	説明	解決策
400	無効なウォレットアドレスまたはドメイン形式、または非メインネットでのドメイン入力	入力が有効なbase58 Solanaアドレスまたは適切に形成されたドメイン（例：`toly.sol`）であることを確認し、メインネットをターゲットにしていることを確認します
401	APIキーが不足しているか無効です	リクエストにAPIキーが含まれていることを確認します
403	エンドポイントには有料プランが必要です	アイデンティティ検索は無料プランでは利用できません。プランをアップグレードして有料ティアにしてください
404	アイデンティティが見つからなかった、またはドメインを解決できなかった	単一エンドポイントのみ — ウォレットにアイデンティティエントリがない、またはドメインが存在しない。バッチリクエストでは、解決不可能なドメインは`unresolved: true`エントリとして返され、404では返されません
429	レートリミットを超過しました	リクエスト頻度を減らすか、プランをアップグレードします

次のステップ

資金提供源

ウォレットに最初に資金を提供したのが誰かを追跡します — 資金提供者タイプはこれらのアイデンティティカテゴリを再利用します。

ウォレットAPI概要

すべてのウォレットAPIエンドポイントと共有規約。

APIリファレンス

アイデンティティ検索のリクエストと応答スキーマ。

はじめに

データストリーミングとイベントリスニング

データ API & RPC

トレーディング

トランザクションの送信

ウォレット・アズ・ア・サービス

ガイド

リソース

Solanaウォレットのアイデンティティを検索する方法

概要

使用タイミング

クイックスタート

単一ウォレット検索

ドメイン名で検索する

バッチ検索（最大100エントリ）

応答形式

アイデンティティカテゴリー

使用例

取引所入金をフラグする

人間が読める名前を表示する

トランザクションの相手先をバッチ処理する

ベストプラクティス

よくあるエラー

次のステップ

資金提供源

ウォレットAPI概要

APIリファレンス

​概要

​使用タイミング

​クイックスタート

​単一ウォレット検索

​ドメイン名で検索する

​バッチ検索（最大100エントリ）

​応答形式

​アイデンティティカテゴリー

​使用例

​取引所入金をフラグする

​人間が読める名前を表示する

​トランザクションの相手先をバッチ処理する

​ベストプラクティス

​よくあるエラー

​次のステップ

資金提供源

ウォレットAPI概要

APIリファレンス

概要

使用タイミング

クイックスタート

単一ウォレット検索

ドメイン名で検索する

バッチ検索（最大100エントリ）

応答形式

アイデンティティカテゴリー

使用例

取引所入金をフラグする

人間が読める名前を表示する

トランザクションの相手先をバッチ処理する

ベストプラクティス

よくあるエラー

次のステップ