Get Wallet Balances

Retrieve token balances and SOL holdings for a Solana wallet address.

GET /v1/wallet/{wallet}/balances

Get wallet balances

cURL

curl --request GET \
  --url 'https://api.helius.xyz/v1/wallet/{wallet}/balances?api-key='

200

{
  "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

ApiKeyQueryApiKeyHeader

api-key · string · query · required

API key passed as query parameter

Path Parameters

wallet · string · required

Solana wallet address (base58 encoded)

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

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

200

application/json

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).

Show child attributes

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.

Show child attributes

nfts · object[]

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

Show child attributes