Holders
GET/v1/token/{mint}/holdersPublic
Holder count and the largest token accounts, each with their share of supply.
Path parameters
| Field | Type | Description |
|---|
mintrequired | string | Token mint address (base58). |
Query parameters
| Field | Type | Description |
|---|
networkoptional | mainnet | devnet | Network to read. Devnet returns an empty payload (with a note) until its ingestor lands. default mainnet |
Response fields
| Field | Type | Description |
|---|
count | number | null | Total holders (capped crawl; a floor for mega-caps). |
top[].address | string | The largest token ACCOUNT (not the owner wallet). |
top[].uiAmount | number | Tokens held. |
top[].pct | number | null | % of total supply. |
updatedAt | string | null | When holders were last refreshed (ISO). |
top[].address is the token ACCOUNT, not the owner wallet (resolving the owner is a second hop). AMM/LP pool vaults can appear among the largest accounts.