Get Wallet Balances

Retrieve token balances for a specific wallet address

GET /balances/{address}

Get Wallet Balances

cURL

curl --request GET \
  --url https://frontend-api-v3.pump.fun/balances/{address}

200

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

Show Balance Object

mint · string

The mint address of the token

balance · string

Token balance amount

decimals · number

Number of decimal places for the token

uiAmount · number

Human-readable balance amount

symbol · string

Token symbol (if available)

name · string

Token name (if available)

total · number

Total number of token balances (for pagination)

Example Request

cURL

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