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.
よくある質問
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.
続けて読む
チャージして、キーを取得し、リリース。
セルフサーブ。暗号資産またはカードで支払い。クレジットで従量課金——重いプリミティブは高く、単純なものは安価。
APIキーを取得