跳转到主要内容
测试版:钱包API目前处于测试阶段。API和响应格式可能会更改。这是一个实验性API,我们正在积极改进覆盖范围并添加新功能。

指南和教程

钱包身份

查找钱包身份和已知地址

钱包余额

获取代币和NFT余额及美元价值

钱包历史

获取完整的交易历史和余额变化

代币转账

查看所有代币转账及发送/接收方信息

资金来源

发现钱包的最初资助者
快速参考
  • GET /v1/wallet/{wallet}/identity - 获取钱包身份信息
  • POST /v1/wallet/batch-identity - 批量身份查询(最多100个地址)
  • GET /v1/wallet/{wallet}/balances - 获取所有代币和NFT余额
  • GET /v1/wallet/{wallet}/history - 获取带余额变化的交易历史
  • GET /v1/wallet/{wallet}/transfers - 获取所有代币转账活动
  • GET /v1/wallet/{wallet}/funded-by - 找到最初的资金来源
  • 基础URL: https://api.helius.xyz

什么是 Wallet API?

Wallet API 提供高性能的 REST 端点,用于查询完整的 Solana 钱包数据——余额、交易历史、代币转账、身份解析和资金来源。无需进行多次 RPC 调用和解析原始区块链数据,只需一个请求即可获取结构化的、可读的信息以及美元定价。非常适合钱包、投资组合追踪器、浏览器和合规工具使用。

关键功能

完整的钱包资料

获取关于钱包的所有信息:余额、历史、转账和身份的结构化格式

美元定价

代币余额包括美元价值(通过DAS每小时更新)和投资组合总额

身份解析

识别已知钱包,拥有5100多个标记账户和1900多个程序(交易所、协议、机构)

快速高效

优化查询可在毫秒内返回数据,而非秒级

分页支持

通过基于游标的分页高效获取大型数据集

人类可读

获取清晰、结构化的数据,而非原始区块链指令

您将获得的内容

Wallet API 提供:
  • 代币余额:所有 SPL 代币和 Token-2022 的 USD 值、标志和元数据
  • NFT 持有量:压缩和未压缩的 NFT 及其集合信息
  • 交易历史:每笔交易的完整历史及余额变化
  • 转账活动:所有进出转账及对方信息
  • 身份数据:已知钱包(交易所、协议等)的名称和类别
  • 资金分析:钱包归因的原始资金来源和金额

数量和单位

Wallet API 是对原始 Solana 数据的高级抽象。响应中的所有字段都是人类可读的 ——已经除以代币的单位,所以可以直接显示,无需任何转换。
无需 lamport 转换。 原始 Solana RPC 调用返回的值以 lamports(最小单位,10⁻⁹ SOL)表示。Wallet API 不会 ——这里表示 1.5 SOL,而不是 1.5 lamports。
在需要进行精确算术计算的地方,某些端点也提供:作为原始整数序列化为字符串,以避免浮点精度丢失。转换公式为: amount = parseInt(amountRaw) / 10**decimals
端点人类可读字段原始字符串
余额人类可读字段不可用
资助来源人类可读字段原始字符串
转账人类可读字段原始字符串
历史人类可读字段不可用
用于显示。用于在链上指令或其他需要精确整数算术的系统中传递值。

用例

Wallet API 非常适合:
  • 钱包应用:向用户显示投资组合余额和交易历史
  • 支付处理器:跟踪支付历史并验证商家交易
  • 投资组合跟踪器:显示当前持有量及其美元价值
  • 税务和会计:生成完整的交易报告以进行纳税申报
  • 合规和反洗钱(AML):监控钱包活动并识别交易所资金来源
  • 分析平台:跟踪巨鲸钱包、聪明资金和链上行为
  • 交易机器人:分析钱包持有量和活动模式
  • DeFi 仪表板:显示用户在各协议中的头寸

身份验证

所有钱包 API 请求都需要一个 API 密钥。您可以通过两种方式传递它:
curl "https://api.helius.xyz/v1/wallet/{wallet}/balances?api-key=YOUR_API_KEY"

快速入门

1

获取您的 API 密钥

dashboard.helius.dev 注册以获取您的 API 密钥。
2

选择您的端点

选择与您的用例相匹配的端点:
  • 身份:识别已知钱包(交易所、协议)
  • 余额:获取投资组合持有量及其美元价值
  • 历史:获取完整的交易历史
  • 转账:跟踪所有代币移动
  • 资金:找到最初的资金来源
3

发出您的第一个请求

从简单的余额查询开始:
curl "https://api.helius.xyz/v1/wallet/86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY/balances?api-key=YOUR_API_KEY"
4

处理响应

解析 JSON 响应并在您的应用中显示数据。

需要帮助?

API 参考

查看详细的 API 文档以及请求/响应模式

联系支持

通过 Discord、聊天或电子邮件向我们的团队寻求帮助