Get Top Holders

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

GET /coins/top-holders-and-sol-balance/{mint}

Get Top Holders

cURL

curl --request GET \
  --url https://advanced-api-v2.pump.fun/coins/top-holders-and-sol-balance/{mint}

200

{
  "mint": "<string>",
  "topHolders": [
    {
      "address": "<string>",
      "balance": "<string>",
      "percentage": 123,
      "solBalance": "<string>",
      "rank": 123
    }
  ],
  "totalHolders": 123,
  "distributionMetrics": {
    "top10Percentage": 123,
    "top50Percentage": 123,
    "giniCoefficient": 123
  }
}

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:

Authorization: Bearer <your_token>

Endpoint

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

Path Parameters

mint · string · required

The mint address of the coin to query

Response

mint · string

The mint address of the queried coin

topHolders · array

Array of top holder objects

Show Holder Object

address · string

The wallet address of the holder

balance · string

Token balance held by this address

percentage · number

Percentage of total supply held

solBalance · string

SOL balance in the holder’s wallet

rank · number

Holder rank by token balance

totalHolders · number

Total number of holders for this token

distributionMetrics · object

Token distribution analysis

Show Distribution Metrics

top10Percentage · number

Percentage held by top 10 holders

top50Percentage · number

Percentage held by top 50 holders

giniCoefficient · number

Gini coefficient indicating distribution inequality

Example Request

cURL

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"

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