如何查找Solana钱包身份

Beta: 钱包API目前处于测试阶段。API和响应格式可能会改变。

概述

钱包身份端点识别Solana上的已知钱包地址，包括中心化交易所、DeFi协议、机构和其他公认的实体。这对于合规、分析和显示已知地址的人类可读名称非常有用。单个和批量端点都接受SNS .sol域以及ANS自定义TLD（例如.bonk，.poor，.abc），除原始Solana地址以外。域解析仅限主网。

API参考

查看钱包身份查找的详细API文档

该端点使用同样的身份系统，支持Orb，我们的Solana区块浏览器。我们的数据库包括12500多个标签（人类可读的主要名称，包括2250多个程序）和1070万个标签（分类属性如“Binance存款地址”或“Seeker Phone”），并在不断增长。

使用此功能的时机

当您需要使用钱包身份API时：

识别交易所钱包：确定钱包是否属于Binance、Coinbase、Kraken等。
跟踪协议活动：识别DeFi协议钱包和资金地址
合规与反洗钱：标记涉及已知实体的交易
分析：在您的数据管道中分类钱包类型
用户体验：显示“发送到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"

单一终端响应是解析地址的标准身份对象——无inputDomain标记。如果需要将输入与输出相关联（例如，同时查询多个域名时），请使用批量终端。

域名解析仅限主网。在开发网/测试网上，如果将域名输入到此终端，则返回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 响应（未知钱包或无法解析的域名）

在单个端点上，如果钱包没有身份条目或域名输入无法解析，将返回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
赌场和赌博	赌博和赌场dApp	Stake.com Hot Wallet, Rollbit, DexSport
DePIN	去中心化物理基础设施	Helium Network, Render Network, Hivemapper
专有AMM	定制AMM实现	Phoenix DEX, GooseFX
Re-staking	重权益协议	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 掠夺者钱包, SagaDAO 黑客钱包, Mango 掠夺者
黑客	已确认的黑客地址	Solana Hack 2022, DeFi 协议黑客
拉盘者	拉高出货的实施者	Squid Game Token 拉盘者, 已知拉盘钱包
诈骗者	已确认的诈骗地址	假空投诈骗者, 网络钓鱼诈骗钱包
垃圾信息	垃圾代币创建者	垃圾代币创建者, 空投垃圾邮件者

程序类别

程序（智能合约）独立分类：

类别	描述	示例
交换	代币交换协议	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 应用	各种
原生	Solana 原生程序	System Program
专有 AMM	自定义 AMM 设计	Phoenix
交易狙击手	交易机器人	MEV bots
套利或三明治机器人	MEV 和套利机器人	Jito bundles
垃圾	垃圾程序	垃圾代币
其他	未分类程序	各种

用例

标记交易所存款

识别资金何时被发送到中心化交易所：

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;
};

显示人类可读名称

在您的用户界面中以友好的名称显示而不是地址：

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响应

不是所有的钱包都会有身份信息。设计您的应用程序以处理404响应，并回退到显示原始地址。

缓存结果

身份数据不经常变化。缓存结果以减少API调用并提高性能。

批量大小限制

批量端点每次请求最多支持100个地址。对于更大的数据集，请相应地分块您的请求。

常见错误

Error Code	描述	解决方案
400	无效的钱包地址或域格式，或在非主网提供域输入	验证输入是否为有效的 base58 Solana 地址或格式正确的域（例如 `toly.sol`），并确保您定位的是主网
401	缺少或无效的API密钥	检查您的API密钥是否包含在请求中
404	未找到身份，或无法解析域	单点端点仅—钱包没有身份条目，或域不存在。在批量请求中，无法解析的域将返回为 `unresolved: true` 条目而不是404
429	超出速率限制	减少请求频率或升级您的计划

如何查找Solana钱包身份

概述

API参考

使用此功能的时机

快速入门

单一钱包查询

根据域名查询

批量查询（最多100个条目）

响应格式

成功响应

批处理：已解析域名条目

批处理：未解析域名条目

404 响应（未知钱包或无法解析的域名）

身份类别

账户标签类型

恶意类别

程序类别

用例

标记交易所存款

显示人类可读名称

批量处理交易对手方

最佳实践

常见错误

需要帮助吗？

API 参考

联系支持

Documentation Index

​概述

API参考

​使用此功能的时机

​快速入门

​单一钱包查询

​根据域名查询

​批量查询（最多100个条目）

​响应格式

​成功响应

​批处理：已解析域名条目

​批处理：未解析域名条目

​404 响应（未知钱包或无法解析的域名）

​身份类别

​账户标签类型

​恶意类别

​程序类别

​用例

​标记交易所存款

​显示人类可读名称

​批量处理交易对手方

​最佳实践

​常见错误

​需要帮助吗？

API 参考

联系支持

概述

使用此功能的时机

快速入门

单一钱包查询

根据域名查询

批量查询（最多100个条目）

响应格式

成功响应

批处理：已解析域名条目

批处理：未解析域名条目

404 响应（未知钱包或无法解析的域名）

身份类别

账户标签类型

恶意类别

程序类别

用例

标记交易所存款

显示人类可读名称

批量处理交易对手方

最佳实践

常见错误

需要帮助吗？