HyperEVM · Holders & tokens
Family token holders
Holders of one family token with balanceOf at the indexed head.
GET https://api.femtos.xyz/v1/token-families/{token}
Parameters
| Param | In | Example or values |
|---|---|---|
token | path | 0xffaa4a3d97fe9107cef8a3f48c069f577ff76cc1 |
layer | query | hyperevm |
limit | query | 20 |
Example
curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/token-families/0xffaa4a3d97fe9107cef8a3f48c069f577ff76cc1?layer=hyperevm&limit=20"Key: Authorization: Bearer $FEMTOS_KEY or X-API-KEY. Get a free key, or with no browser through agent onboarding.
Response fields
| Field | Type | Meaning |
|---|---|---|
holders | int | holders with a positive base |
top[] | object | {address, base, balance, lastBlock} |
base · balance | decimal | what the contract keeps (raw), balanceOf in token units |
state · stateBlock | object · int | token state the formula reads |
Related: Holders & tokens
- Holders GET /v1/holders
Current balances of an ERC-20, largest first, with concentration. - Token registry GET /v1/coins
HyperEVM tokens with their HyperCore spot link and price. - Coin detail GET /v1/coins/{layer}/{id}
One token: its links across layers, the markets it trades on, its 5 largest holders. - Daily token volume GET /v1/volume
USD swap volume of a token per UTC day, both sides of every priced swap. - Token families GET /v1/token-families
Tokens whose balance moves without Transfer logs: Aave aTokens and debt tokens, stHYPE, xStocks. - Spam tokens GET /v1/tokens/spam
Tokens the indexer flags as spam, left out of every list, and the latest flag changes.