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

> Retrieve top token holders and their SOL balances for a specific coin

## Overview

The Top Holders endpoint provides detailed information about the largest holders of a specific token, including their SOL balances. This data is useful for analyzing token distribution and holder profiles.

## Authentication

This endpoint requires JWT authentication via the `Authorization` header:

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

## Endpoint

```http theme={null}
GET https://advanced-api-v2.pump.fun/coins/top-holders-and-sol-balance/{mint}
```

## Path Parameters

<ParamField path="mint" type="string" required>
  The mint address of the coin to query
</ParamField>

## Response

<ResponseField name="mint" type="string">
  The mint address of the queried coin
</ResponseField>

<ResponseField name="topHolders" type="array">
  Array of top holder objects

  <Expandable title="Holder Object">
    <ResponseField name="address" type="string">
      The wallet address of the holder
    </ResponseField>

    <ResponseField name="balance" type="string">
      Token balance held by this address
    </ResponseField>

    <ResponseField name="percentage" type="number">
      Percentage of total supply held
    </ResponseField>

    <ResponseField name="solBalance" type="string">
      SOL balance in the holder's wallet
    </ResponseField>

    <ResponseField name="rank" type="number">
      Holder rank by token balance
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="totalHolders" type="number">
  Total number of holders for this token
</ResponseField>

<ResponseField name="distributionMetrics" type="object">
  Token distribution analysis

  <Expandable title="Distribution Metrics">
    <ResponseField name="top10Percentage" type="number">
      Percentage held by top 10 holders
    </ResponseField>

    <ResponseField name="top50Percentage" type="number">
      Percentage held by top 50 holders
    </ResponseField>

    <ResponseField name="giniCoefficient" type="number">
      Gini coefficient indicating distribution inequality
    </ResponseField>
  </Expandable>
</ResponseField>

## Example Request

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://advanced-api-v2.pump.fun/coins/top-holders-and-sol-balance/7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr" \
    -H "Authorization: Bearer <your_token>" \
    -H "Accept: application/json"
  ```

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

  mint = "7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr"
  url = f"https://advanced-api-v2.pump.fun/coins/top-holders-and-sol-balance/{mint}"
  headers = {
      "Authorization": "Bearer <your_token>",
      "Accept": "application/json"
  }

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

  ```javascript JavaScript theme={null}
  const mint = '7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr';

  fetch(`https://advanced-api-v2.pump.fun/coins/top-holders-and-sol-balance/${mint}`, {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer <your_token>',
      'Accept': 'application/json'
    }
  })
  .then(response => response.json())
  .then(data => console.log(data));
  ```

  ```typescript TypeScript theme={null}
  const mint = '7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr';

  const response = await fetch(
    `https://advanced-api-v2.pump.fun/coins/top-holders-and-sol-balance/${mint}`,
    {
      method: 'GET',
      headers: {
        'Authorization': 'Bearer <your_token>',
        'Accept': 'application/json'
      }
    }
  );

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

## Use Cases

* Analyze token distribution and concentration
* Identify whale holders and their activity
* Assess holder financial capability via SOL balances
* Monitor changes in holder composition over time
* Calculate distribution fairness metrics

## Notes

* Replace `<your_token>` with your actual JWT token
* Replace `{mint}` with the actual coin mint address
* SOL balance data helps understand holder profiles
* This endpoint is essential for token economics analysis