femtos

HyperEVM · Holders & tokens

Holders

Current balances of an ERC-20, largest first, with concentration.

GET https://api.femtos.xyz/v1/holders

Parameters

ParamInExample or values
layerqueryhyperevm
tokenquery<evmToken>
limitquery20

Example

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/holders?layer=hyperevm&token=<evmToken>&limit=20"

Key: Authorization: Bearer $FEMTOS_KEY or X-API-KEY. Get a free key, or with no browser through agent onboarding.

Response fields

FieldTypeMeaning
totalHoldersintpositive balances, system excluded
top10Sharenumber | null10 largest shares, 0–1
holders[]object{address, amount, share, usd?, side?, label?}
system[]objectbridge, pools, fee collector… (excludeSystem=0 to count them)
asOf · heightinttime and block of the balances
spam · spamReasonboolean · string | nullthe token is flagged spam; its holders still answer

Related: Holders & tokens

  • 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.
  • Family token holders GET /v1/token-families/{token}
    Holders of one family token with balanceOf at the indexed head.
  • Spam tokens GET /v1/tokens/spam
    Tokens the indexer flags as spam, left out of every list, and the latest flag changes.

More