Skip to main content
GET
/
coins
/
top-holders-and-sol-balance
/
{mint}
Get Top Holders
curl --request GET \
  --url https://advanced-api-v2.pump.fun/coins/top-holders-and-sol-balance/{mint}
{
  "mint": "<string>",
  "topHolders": [
    {
      "address": "<string>",
      "balance": "<string>",
      "percentage": 123,
      "solBalance": "<string>",
      "rank": 123
    }
  ],
  "totalHolders": 123,
  "distributionMetrics": {
    "top10Percentage": 123,
    "top50Percentage": 123,
    "giniCoefficient": 123
  }
}

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.

​
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
​
totalHolders
number
Total number of holders for this token
​
distributionMetrics
object
Token distribution analysis

​
Example Request

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

Build docs developers (and LLMs) love

Get started for freeTalk to us