新消息:Helius 收购 Light Protocol
Wallet API(Beta)

轻松获取 Solana 钱包数据

通过一个 REST API 获取 Solana 钱包余额、历史记录、身份和资金来源。无需记忆 Solana JSON-RPC 方法,也无需进行 lamport 换算。

主视觉图片
身份

了解钱包归属

将 Solana 地址或域名解析为身份。支持 32,500 多个标签和 2,150 多万个标记。

GET /v1/wallet/{wallet}/identity
          
{ "address": "HXsKP7wrBWaQ8T2Vtjry3Nj3oUgwYcqq9vrHDM12G664", "type": "exchange", "name": "Binance 1", "category": "Centralized Exchange", "tags": ["Centralized Exchange"] }
  • 支持单次查询或批量查询最多 100 个地址
  • 可在主网上解析 SNS 和 ANS 自定义 TLD
  • 支持交易所地址、协议钱包、机构和已标记地址的标签
资金来源

追踪钱包的出资方

获取钱包最初的资金来源:谁发送了第一笔 SOL、金额多少以及发送时间。出资方名称和类型来自同一身份系统。

GET /v1/wallet/{wallet}/funded-by
          
{ "funder": "26MAyPNpK4At8LgRECMMbgiKQuJyg3oACtw1Q9FRyuba", "funderName": null, "funderType": null, "mint": "So11111111111111111111111111111111111111111", "symbol": "SOL", "amount": 0.09811972, "amountRaw": "98119720", "decimals": 9, "date": "2022-01-19T20:46:34.000Z", "signature": "5WX9C5kCQNULGGrSHJBR1WDFyetVyekbUpe1KQ45p3zEBe6jVgSsJuMqLWijjTDcnaAK2518ZriktRMCNycnsNAG", "timestamp": 1642625194, "slot": 116984883, "explorerUrl": "https://orbmarkets.io/tx/5WX9C5kCQNULGGrSHJBR1WDFyetVyekbUpe1KQ45p3zEBe6jVgSsJuMqLWijjTDcnaAK2518ZriktRMCNycnsNAG?tab=summary" }
  • 直接出资方的地址、金额、slot 和签名
  • 交易所、协议或未知来源;如果我们掌握相关信息,就会添加标签
  • 永久缓存。钱包的首个出资方永远不会改变
历史记录

完整解析钱包活动

以易读语言呈现交易历史,以及每笔交易的余额变化。

GET /v1/wallet/{wallet}/history
          
{ "data": [ { "signature": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE", "timestamp": 1704067200, "slot": 250000000, "fee": 0.000005, "feePayer": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY", "error": null, "balanceChanges": [ { "mint": "So11111111111111111111111111111111111111111", "amount": -0.05, "decimals": 9 } ] } ], "pagination": { "hasMore": true, "nextCursor": "5wHu1qwD7Jsj3xqWjdSEJmYr3Q5f5RjXqjqQJ7jqEj7jqEj7jqEj7jqEj7jqEj7jqE" } }
  • 最新交易优先,每页最多 100 笔交易
  • 使用 tokenAccounts=balanceChanged 仅获取更新
  • amount 已完成小数位调整,无需进行 lamport 换算
HELIUS 钱包即服务

同时交付钱包和数据层

通过 helius-wallet-kit 将非托管嵌入式钱包添加到你的应用,并支持使用通行密钥、电子邮件和现有钱包登录

Wallet API 使用场景

钱包仪表盘

一次 REST 调用即可获取余额、美元价值和元数据。无需拼接 DAS 数据或进行 lamport 换算

投资组合追踪器

使用历史记录和 balance-at 重建持仓,并计算不同时期的盈亏

支付处理服务

记录交易和转账,包括交易对手、金额、mint 和方向

税务与会计

获取易读的历史记录,包括每笔交易的余额持仓和变化

合规与反洗钱

查询已知交易所和资金库钱包,并了解钱包的资金来源

浏览器与分析工具

获取超过 2,100 万个钱包的标记,在你的应用中添加账户标签

工作原理

一个 REST API,获取所有 Solana 钱包数据

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

  const response = await fetch(url);
  if (!response.ok) {
    throw new Error(`HTTP error! status: ${response.status}`);
  }

  const data = await response.json();

  const solBalance = data.balances[0]; // SOL is always first when showNative=true
  console.log(`SOL Balance: ${solBalance.balance} SOL ($${solBalance.usdValue})`);
  console.log(`Page ${data.pagination.page} Total Value: $${data.totalUsdValue}`);
  console.log(`Token Count (this page): ${data.balances.length}`);

  // Display top holdings
  data.balances.slice(0, 5).forEach(token => {
    console.log(`${token.symbol}: ${token.balance} ($${token.usdValue || 'N/A'})`);
  });

  return data;
};

getWalletBalances("86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY");

1. 获取 API 密钥

注册并获取 Helius API 密钥,然后通过查询字符串传递 api-key,或将其作为 X-Api-Key 请求头传递

2. 请求一个 REST 路径

调用 GET /v1/wallet/{wallet}/balances、identity、history 或任何其他 Wallet API 端点

3. 集成到你的应用

金额已完成小数位调整,身份已添加标签,数据格式也已正确处理;无需额外步骤

常见问题

查看常见问题的答案。需要帮助或定制方案?联系我们的团队。

体验不同

轻松获取钱包数据

无需使用原始 Solana JSON-RPC 方法,几分钟内即可开始查询链上钱包数据