跳转到主要内容
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个,仅限第一页)