Skip to main content
GET
/
balances
/
{address}
Get Wallet Balances
curl --request GET \
  --url https://frontend-api-v3.pump.fun/balances/{address}
{
  "address": "<string>",
  "balances": [
    {
      "mint": "<string>",
      "balance": "<string>",
      "decimals": 123,
      "uiAmount": 123,
      "symbol": "<string>",
      "name": "<string>"
    }
  ],
  "total": 123
}

​
Overview

The Balances endpoint returns all token holdings for a given wallet address, with options to filter by minimum balance and paginate results.

​
Authentication

This endpoint requires JWT authentication via the Authorization header: 
Authorization: Bearer <your_token>

​
Endpoint

GET https://frontend-api-v3.pump.fun/balances/{address}

​
Path Parameters

​
address
string
required
The Solana wallet address to query balances for

​
Query Parameters

​
offset
number
required
Number of records to skip for pagination
​
limit
number
required
Maximum number of records to return (pagination size)
​
minBalance
number
required
Minimum token balance to include in results (filters out dust)

​
Response

​
address
string
The queried wallet address
​
balances
array
Array of token balance objects
​
total
number
Total number of token balances (for pagination)

​
Example Request

curl -X GET "https://frontend-api-v3.pump.fun/balances/7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr?offset=0&limit=50&minBalance=0.001" \
  -H "Authorization: Bearer <your_token>" \
  -H "Accept: application/json"

​
Use Cases

  • Display user portfolio and token holdings
  • Track wallet composition over time
  • Filter out dust balances with minBalance parameter
  • Build wallet analytics dashboards
  • Monitor specific wallet addresses

​
Notes

  • Replace <your_token> with your actual JWT token
  • Use minBalance to filter out negligible token amounts
  • Implement pagination for wallets with many tokens
  • Balance amounts are returned as strings to preserve precision

Build docs developers (and LLMs) love

Get started for freeTalk to us