List top holders of a token
Holder concentration tells you how much supply sits in a few hands. The holders endpoint returns ranked addresses and balances so you can compute distribution metrics directly. It is a C2 read.
- A live API key with a positive credit balance
- The token id you want to analyze
1Request the ranked holder list
Pass the token id and a limit. Holders is a C2 read, heavier than spot but still a single call.
curl "https://api.1st-node.com/v1/market/token/eth/holders?limit=50" \ -H "Authorization: Bearer sk_live_..."
2Read balances and share of supply
Each entry is an address with its balance and share of supply, ordered largest first. Sum the top N to quantify concentration.
> { "holders": [
> { "address": "0x...", "balance": "4200000", "share": 0.035 } ] }3Derive concentration metrics
Combine the shares with supply from the metadata endpoint to compute top-10 concentration or a Gini-style spread. Cache the list — the ranking moves slowly.
Preguntas frecuentes
How many holders can I page through?
Set limit to request the top N; page with offset for deeper ranks. The list is ordered by balance descending.
What tier is a holders read?
Holders is a C2 read — heavier than a C1 spot or metadata call, but a single request that you can cache.
Sigue leyendo
Recarga, obtén tu clave y publica.
Autoservicio. Paga en cripto o con tarjeta. Medido por créditos: las primitivas pesadas cuestan más, las simples son baratas.
Obtener clave API