跳转到主要内容
Wallet API处于Beta阶段。端点和响应格式可能会更改。

​
什么是钱包 API？

钱包 API 提供用于查询完整 Solana 钱包数据的高级 REST 端点——余额、交易历史、代币转账、身份解析、历史余额和资金来源。无需进行多次 RPC 调用和解析原始区块链数据，只需一次请求即可获取结构化、可读的信息以及美元定价。 它专为钱包、投资组合跟踪器、浏览器、支付处理器、税务工具和合规与反洗钱系统构建。所有端点共享基础 URL https://api.helius.xyz，并返回可读单位（无需 lamport 转换）。

​
为什么选择 Helius 的钱包数据？

一个REST调用

结构化余额、历史和转账，无需拼接原始RPC响应。

内置USD定价

令牌余额包括USD值和投资组合总额，来源于DAS。

身份解析

超过32,500个标记账户和程序，以及超过21.5M个交易所、协议和机构的类别标签。

人类可读的输出

清晰的、经过小数调整的数据，而非原始lamports和指令。

​
关键端点

钱包身份

通过地址或SNS/ANS域识别已知钱包——交易所、协议、机构。

钱包余额

所有令牌和NFT余额，包含USD值、标识和元数据。

历史余额

过去时间戳、日期时间或插槽的令牌或SOL余额。

钱包历史

完整的交易历史，每笔交易的余额变化。

令牌转账

所有进出转账，包含发送者/接收者信息。

资金来源

追踪钱包的原始资金来源到其首笔SOL收入。

​
我应该使用哪个端点？

基础路由的快速参考（基本 URL https://api.helius.xyz）：
  • GET /v1/wallet/{wallet}/identity — 通过地址或SNS/ANS域获取钱包身份
  • POST /v1/wallet/batch-identity — 批量身份查找（最多100个地址和/或域）
  • GET /v1/wallet/{wallet}/balances — 获取所有代币和NFT余额
  • GET /v1/wallet/{wallet}/balance-at — 获取过去时间戳、日期时间或插槽的代币或SOL余额
  • GET /v1/wallet/{wallet}/history — 获取带余额变化的交易历史
  • GET /v1/wallet/{wallet}/transfers — 获取所有代币转账活动
  • GET /v1/wallet/{wallet}/funded-by — 找到原始资金来源

​
认证

所有钱包API请求都需要API密钥。您可以将其作为查询参数或头传递：

​
计划要求

身份和资金来源端点需要付费计划。在免费计划中，对这些端点的请求将返回 403 Forbidden。所有其他端点在所有计划中都是开放的，包括免费计划。 任何付费层都可以解锁受限端点 —— 开发者、商业和更高级别（如企业）。要启用身份和资金来源查询，请在仪表板中升级您的计划。

​
金额和单位

Wallet API 是对原始 Solana 数据的高级抽象。响应中的所有 amount 字段都是可读的 —— 已除以令牌的 decimals —— 因此您可以直接显示它们而无需任何转换。原始 Solana RPC 调用返回的值是 lamports（最小单位，10⁻⁹ SOL）；而 Wallet API 不是。"amount": 1.5 表示 1.5 SOL，而不是 1.5 lamports。 在需要精确算术的情况下，一些端点也会暴露 amountRaw：与原始整数相同的值，作为字符串序列化以避免浮点精度丢失。转换公式为： amount = parseInt(amountRaw) / 10**decimals 使用 amount 进行显示。当将值传递给链上指令或需要精确整数算术的其他系统时，使用 amountRaw。

​
入门

1

获取您的 API 密钥

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

选择您的端点

使用上表选择匹配您使用案例的端点。
3

发起您的第一个请求

从一个简单的余额查询开始：
4

处理响应

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

​
下一步

获取数据

探索在 Helius 上查询 Solana 数据的每种方式。

API 参考

所有 Wallet API 端点的请求和响应模式。

联系支持

通过 Discord、聊天或电子邮件获得帮助。