Skip to main content
GET
/
v1
/
wallet
/
{wallet}
/
balances
Get 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"
    }
  ]
}

​
Request Parameters

​
wallet
string
required
Solana wallet address (base58 encoded)
​
page
number
default:"1"
Page number for pagination (1-indexed)
​
limit
number
default:"100"
Maximum number of tokens per page
​
showZeroBalance
boolean
default:"false"
Include tokens with zero balance
​
showNative
boolean
default:"true"
Include native SOL in results
​
showNfts
boolean
default:"false"
Include NFTs in results (max 100, first page only)

Authorizations

​
api-key
string
query
required

API key passed as query parameter

Path Parameters

​
wallet
string
required

Solana wallet address (base58 encoded)

Query Parameters

​
page
integer
default:1

Page number for pagination (1-indexed)

Required range: x >= 1
​
limit
integer
default:100

Maximum number of tokens per page

Required range: 1 <= x <= 100
​
showZeroBalance
boolean
default:false

Include tokens with zero balance

​
showNative
boolean
default:true

Include native SOL in results

​
showNfts
boolean
default:false

Include NFTs in results (max 100, first page only)

Response

Wallet balances retrieved successfully

​
balances
object[]
required

Array of token balances for the current page, including native SOL. When showNative=true, SOL appears as the first element with mint address So11111111111111111111111111111111111111112. Other tokens are sorted by USD value (descending).

​
totalUsdValue
number
required

Total USD value of balances on this page (not total portfolio value)

Example:

217.98

​
pagination
object
required

Pagination metadata. Users must manually request additional pages using the page parameter.

​
nfts
object[]

Array of NFT holdings (only included if showNfts=true, max 100, first page only)