Skip to main content
GET
/
token
/
{network}
/
holders
/
{address}
Get the summary of holders for a given token token.
curl --request GET \
  --url https://solana-gateway.moralis.io/token/{network}/holders/{address} \
  --header 'X-Api-Key: <api-key>'
{
  "totalHolders": 5000,
  "holdersByAcquisition": {
    "swap": 150,
    "transfer": 50,
    "airdrop": 20
  },
  "holderChange": {
    "5min": {
      "change": 50,
      "changePercent": 2.5
    },
    "1h": {
      "change": 50,
      "changePercent": 2.5
    },
    "6h": {
      "change": 50,
      "changePercent": 2.5
    },
    "24h": {
      "change": 50,
      "changePercent": 2.5
    },
    "3d": {
      "change": 50,
      "changePercent": 2.5
    },
    "7d": {
      "change": 50,
      "changePercent": 2.5
    },
    "30d": {
      "change": 50,
      "changePercent": 2.5
    }
  },
  "holderDistribution": {
    "whales": 150,
    "sharks": 150,
    "dolphins": 150,
    "fish": 150,
    "octopus": 150,
    "crabs": 150,
    "shrimps": 150
  },
  "holderSupply": {
    "top10": {
      "supply": "1000000.123456",
      "supplyPercent": 12.5
    },
    "top25": {
      "supply": "1000000.123456",
      "supplyPercent": 12.5
    },
    "top50": {
      "supply": "1000000.123456",
      "supplyPercent": 12.5
    },
    "top100": {
      "supply": "1000000.123456",
      "supplyPercent": 12.5
    },
    "top250": {
      "supply": "1000000.123456",
      "supplyPercent": 12.5
    },
    "top500": {
      "supply": "1000000.123456",
      "supplyPercent": 12.5
    }
  }
}
Endpoint cost: CUs. Learn more about compute units.

Authorizations

X-Api-Key
string
header
required

Path Parameters

network
enum<string>
required

The network to query

Available options:
mainnet,
devnet
address
string
required

The address to query

Example:

"6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"

Response

200 - application/json
totalHolders
number
required
Example:

5000

holdersByAcquisition
object
required
holderChange
object
required
holderDistribution
object
required
holderSupply
object
required