Get Top Holders

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}

const options = {method: 'GET'};

fetch('https://advanced-api-v2.pump.fun/coins/top-holders-and-sol-balance/{mint}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://advanced-api-v2.pump.fun/coins/top-holders-and-sol-balance/{mint}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://advanced-api-v2.pump.fun/coins/top-holders-and-sol-balance/{mint}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

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

string

required

The mint address of the coin to query

Response

string

The mint address of the queried coin

array

Array of top holder objects

Show Holder Object

string

The wallet address of the holder

string

Token balance held by this address

number

Percentage of total supply held

string

SOL balance in the holder’s wallet

number

Holder rank by token balance

number

Total number of holders for this token

object

Token distribution analysis

Show Distribution Metrics

number

Percentage held by top 10 holders

number

Percentage held by top 50 holders

number

Gini coefficient indicating distribution inequality

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"

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())

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));

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);

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

⌘I

Get Top Holders

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

const options = {method: 'GET'};

fetch('https://advanced-api-v2.pump.fun/coins/top-holders-and-sol-balance/{mint}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://advanced-api-v2.pump.fun/coins/top-holders-and-sol-balance/{mint}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://advanced-api-v2.pump.fun/coins/top-holders-and-sol-balance/{mint}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

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

Coins

Trades

Users & Authentication

Social Features

Livestreams

Moderation

Advanced Analytics

Utilities

Overview

Authentication

Endpoint

Path Parameters

Response

Example Request

Use Cases

Notes

​Overview

​Authentication

​Endpoint

​Path Parameters

​Response

​Example Request

​Use Cases

​Notes

Overview

Authentication

Endpoint

Path Parameters

Response

Example Request

Use Cases

Notes