Get Wallet Balances

GET

wallet

{wallet}

balances

Get wallet balances

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

const options = {method: 'GET'};

fetch('https://api.helius.xyz/v1/wallet/{wallet}/balances?api-key=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.helius.xyz/v1/wallet/{wallet}/balances?api-key=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.helius.xyz/v1/wallet/{wallet}/balances?api-key="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.helius.xyz/v1/wallet/{wallet}/balances?api-key=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

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

{
  "error": "Invalid wallet address",
  "code": 400,
  "details": "'invalid-address' is not a valid Solana address"
}

{
  "error": "API key required. Pass via ?api-key=xxx or X-Api-Key header",
  "code": 401
}

{
  "error": "RATE_LIMIT_EXCEEDED",
  "code": 429,
  "details": "Too many requests. Retry after 2 seconds."
}

{
  "error": "INTERNAL_ERROR",
  "code": 500,
  "details": "An unexpected error occurred. Please retry."
}

Each request costs 100 credits.

Request Parameters

string

default:"GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz"

required

Solana wallet address (base58 encoded)

number

default:"1"

Page number for pagination (1-indexed)

number

default:"100"

Maximum number of tokens per page

boolean

default:"false"

Include tokens with zero balance

boolean

default:"true"

Include native SOL in results

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

default:GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz

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

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

⌘I

Get wallet balances

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

const options = {method: 'GET'};

fetch('https://api.helius.xyz/v1/wallet/{wallet}/balances?api-key=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.helius.xyz/v1/wallet/{wallet}/balances?api-key=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.helius.xyz/v1/wallet/{wallet}/balances?api-key="

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.helius.xyz/v1/wallet/{wallet}/balances?api-key=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

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

{
  "error": "Invalid wallet address",
  "code": 400,
  "details": "'invalid-address' is not a valid Solana address"
}

{
  "error": "API key required. Pass via ?api-key=xxx or X-Api-Key header",
  "code": 401
}

{
  "error": "RATE_LIMIT_EXCEEDED",
  "code": 429,
  "details": "Too many requests. Retry after 2 seconds."
}

{
  "error": "INTERNAL_ERROR",
  "code": 500,
  "details": "An unexpected error occurred. Please retry."
}

Get Started

Data Streaming & Event Listening

Data APIs & RPCs

Trading

Sending Transactions

Account Management

Request Parameters

Authorizations

Path Parameters

Query Parameters

Response

​Request Parameters

Authorizations

Path Parameters

Query Parameters

Response

Request Parameters