跳转到主要内容
GET
/
v1
/
wallet
/
{wallet}
/
balances
获取钱包余额
curl --request GET \
  --url 'https://api.helius.xyz/v1/wallet/{wallet}/balances?api-key='
{
  "balances": [
    {
      "mint": "So11111111111111111111111111111111111111112",
      "balance": 1.5,
      "decimals": 9,
      "tokenProgram": "spl-token",
      "symbol": "SOL",
      "name": "Solana",
      "pricePerToken": 145.32,
      "usdValue": 217.98,
      "logoUri": "https://example.com/sol-logo.png"
    }
  ],
  "totalUsdValue": 217.98,
  "pagination": {
    "page": 1,
    "limit": 100,
    "hasMore": true
  },
  "nfts": [
    {
      "mint": "7Xq8wXyXVqfBPPqVJjPDwG9zN5wCVxBYZ6z7vPYBzr6F",
      "compressed": false,
      "name": "Degen Ape",
      "imageUri": "https://example.com/nft.png",
      "collectionName": "Degen Ape Academy",
      "collectionAddress": "DegN1dXmU2uYa4n7U9qTh7YNYpK4u8L9qXx7XqYqJfGH"
    }
  ]
}

​
请求参数

​
wallet
string
必填
Solana钱包地址（base58编码）
​
page
number
默认值:"1"
分页页码（从1开始）
​
limit
number
默认值:"100"
每页最多代币数量
​
showZeroBalance
boolean
默认值:"false"
包括余额为零的代币
​
showNative
boolean
默认值:"true"
结果中包括原生SOL
​
showNfts
boolean
默认值:"false"
结果中包括NFT（最多100个，仅限首页）

授权

​
api-key
string
query
必填

作为查询参数传递的API密钥

路径参数

​
wallet
string
必填

Solana 钱包地址（base58 编码）

Pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$

查询参数

​
page
integer
默认值:1

分页的页码（从1开始）

必填范围: x >= 1
​
limit
integer
默认值:100

每页的最大代币数量

必填范围: 1 <= x <= 100
​
showZeroBalance
boolean
默认值:false

包含零余额的代币

​
showNative
boolean
默认值:true

在结果中包含本地SOL

​
showNfts
boolean
默认值:false

在结果中包含NFT（最多100个，仅限第一页）

响应

成功检索到钱包余额

​
balances
object[]
必填

当前页面的代币余额数组，包括本机SOL。 当showNative=true时，SOL作为第一个元素出现，铸币地址为So11111111111111111111111111111111111111112。 其他代币按美元价值排序 (降序)。

​
totalUsdValue
number
必填

本页面余额的总美元价值（不是总投资组合价值）

示例:

217.98

​
pagination
object
必填

分页元数据。用户必须使用页面参数手动请求更多页面。

​
nfts
object[]

NFT持有数组（仅在showNfts=true时包含，最多100个，仅限第一页）