> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/BankkRoll/pumpfun-apis/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Wallet Balances

> Retrieve token balances for a specific wallet address

## 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:

```bash theme={null}
Authorization: Bearer <your_token>
```

## Endpoint

```http theme={null}
GET https://frontend-api-v3.pump.fun/balances/{address}
```

## Path Parameters

<ParamField path="address" type="string" required>
  The Solana wallet address to query balances for
</ParamField>

## Query Parameters

<ParamField query="offset" type="number" required>
  Number of records to skip for pagination
</ParamField>

<ParamField query="limit" type="number" required>
  Maximum number of records to return (pagination size)
</ParamField>

<ParamField query="minBalance" type="number" required>
  Minimum token balance to include in results (filters out dust)
</ParamField>

## Response

<ResponseField name="address" type="string">
  The queried wallet address
</ResponseField>

<ResponseField name="balances" type="array">
  Array of token balance objects

  <Expandable title="Balance Object">
    <ResponseField name="mint" type="string">
      The mint address of the token
    </ResponseField>

    <ResponseField name="balance" type="string">
      Token balance amount
    </ResponseField>

    <ResponseField name="decimals" type="number">
      Number of decimal places for the token
    </ResponseField>

    <ResponseField name="uiAmount" type="number">
      Human-readable balance amount
    </ResponseField>

    <ResponseField name="symbol" type="string">
      Token symbol (if available)
    </ResponseField>

    <ResponseField name="name" type="string">
      Token name (if available)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="number">
  Total number of token balances (for pagination)
</ResponseField>

## Example Request

<CodeGroup>
  ```bash cURL theme={null}
  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"
  ```

  ```python Python theme={null}
  import requests

  address = "7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr"
  url = f"https://frontend-api-v3.pump.fun/balances/{address}"
  params = {
      "offset": 0,
      "limit": 50,
      "minBalance": 0.001
  }
  headers = {
      "Authorization": "Bearer <your_token>",
      "Accept": "application/json"
  }

  response = requests.get(url, headers=headers, params=params)
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const address = '7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr';
  const params = new URLSearchParams({
    offset: '0',
    limit: '50',
    minBalance: '0.001'
  });

  fetch(`https://frontend-api-v3.pump.fun/balances/${address}?${params}`, {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer <your_token>',
      'Accept': 'application/json'
    }
  })
  .then(response => response.json())
  .then(data => console.log(data));
  ```

  ```typescript TypeScript theme={null}
  const address = '7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr';
  const params = new URLSearchParams({
    offset: '0',
    limit: '50',
    minBalance: '0.001'
  });

  const response = await fetch(
    `https://frontend-api-v3.pump.fun/balances/${address}?${params}`,
    {
      method: 'GET',
      headers: {
        'Authorization': 'Bearer <your_token>',
        'Accept': 'application/json'
      }
    }
  );

  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

## 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