API reference, Holders & tokens

Holders stream

• Elysium: The largest holders and holder count of a Elysium token (GET /v1/holders), pushed on subscribe and in the block that moves one of its balances.
• HyperEVM: The largest holders and holder count of a HyperEVM token (GET /v1/holders), pushed on subscribe and in the block that moves one of its balances.

• Elysium
• HyperCore: not served
• HyperEVM

• Not on HyperCore: HyperCore holders are snapshots of its ledger, about every 12 minutes, that no block writes: GET /v1/holders?layer=hypercore reads the latest one

WebSocket channel elysium.holders on wss://api.femtos.xyz/v1/ws | WebSocket channel hyperevm.holders on wss://api.femtos.xyz/v1/ws

Parameters

Subscribe

Elysium

{"op":"subscribe","channel":"elysium.holders","filter":{"token":"<token>","limit":"20"}}

HyperEVM

{"op":"subscribe","channel":"hyperevm.holders","filter":{"token":"<evmToken>","limit":"20"}}

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

Response fields

Related: Holders & tokens

• Token registry GET /v1/coins Elysium, HyperCore, HyperEVM
  HyperCore tokens with their HyperEVM contract and price.
• Coin detail GET /v1/coins/{layer}/{id} Elysium, HyperCore, HyperEVM
  One token: its links across layers, the markets it trades on, its 5 largest holders.
• Token metadata GET /v1/tokens Elysium, HyperCore, HyperEVM
  Metadata of up to 100 tokens: supply, creator, logo and socials when indexed, family, spam. Also POST with a JSON body.
• Token overview GET /v1/tokens/{address} Elysium, HyperEVM
  One token across all its pools: price, FDV, market cap, liquidity, windows, holders, top pools.
• Token across layers GET /v1/tokens/{address}/lifecycle Elysium, HyperCore, HyperEVM
  One token from its Elysium launch to its HyperEVM mirror, HyperCore spot and perps, each link proven or marked inferred.
• Holders GET /v1/holders Elysium, HyperCore, HyperEVM
  Spot balances of a HyperCore token, largest first.
• Perp holders GET /v1/holders HyperCore
  Largest open positions of a perp, long and short.
• Holders history GET /v1/holders/history Elysium, HyperEVM
  Holder count of an ERC-20 per day, and now.
• Token families GET /v1/token-families Elysium, HyperEVM
  Tokens whose balance moves without Transfer logs: Aave aTokens and debt tokens, stHYPE, xStocks.
• Family token holders GET /v1/token-families/{token} Elysium, HyperEVM
  Holders of one family token with balanceOf at the indexed head.
• Token transfers GET /v1/transfers Elysium, HyperEVM
  ERC-20 Transfer events of one token, newest first.
• Token transfers stream WS elysium.transfers | hyperevm.transfers Elysium, HyperEVM
  The ERC-20 transfers of one token on HyperEVM, pushed as each block is indexed; min_usd or min_amount for whale alerts.
• Token security GET /v1/tokens/{address}/security Elysium, HyperEVM
  Honeypot check: a buy, a transfer and a sell simulated on our node, taxes, owner powers, holders and LP, with a verdict.
• Top traders GET /v1/tokens/{address}/traders Elysium, HyperEVM
  The wallets that traded a token over the last 1h, 6h or 24h, ranked by PnL or volume, with average prices and realized / unrealized PnL.
• Spam tokens GET /v1/tokens/spam Elysium, HyperEVM
  Tokens the indexer flags as spam, left out of every list, and the latest flag changes.

More

• This page as Markdown
• The whole API reference
• What Elysium serves
• What HyperEVM serves
• The whole API in one Markdown file
• OpenAPI 3.1 document

Agent guide (agents.md)llms.txtOpenAPIMCP serverGet an API keyChangelog