API reference · Launches

Launch holders

Every holder of a launched token, tagged dev or early buyer, with concentration.

  • Not on HyperCore: served on Elysium and HyperEVM only
  • No data on Elysium yet: no Ascend launch on Elysium mainnet yet

GET https://api.femtos.xyz/v1/launches/{token}/holders

Parameters

ParamInExample or valuesMeaning
tokenpath<token> (Elysium); <llToken> (HyperEVM)Launched token address
limitquery20Rows
cursorquery(optional)Next page: `next_cursor` of the previous answer

Example

Elysium

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

HyperEVM

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/launches/<llToken>/holders?limit=20"

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

Response fields

FieldTypeMeaning
totalHoldersintPositive balances, system addresses excluded
concentrationobject{top1Share, top10Share, top20Share, top50Share, hhi, devShare, flaggedShare, heldShare}
systemobject{holders, amount, shareOfSupply}
holders[]object{rank, address, amount, shareOfSupply, firstSeenAt, lastActiveAt, tag, flags, entity}
next_cursorstring | nullOpaque cursor of the next page: pass it as `cursor`, unchanged. null on the last page

Next page: cursor = the next_cursor of the previous answer, the same on every list (pagination).

Related: Launches

  • Launches GET /v1/launches Elysium, HyperEVM
    Latest LiquidLaunch bonding-curve launches, newest first.
  • Launches stream WS elysium.launches · hyperevm.launches Elysium, HyperEVM
    One message per new LiquidLaunch launch, the moment its block is indexed.
  • Launch detail & signals GET /v1/launches/{token} Elysium, HyperEVM
    Metrics, dev wallet, early buyers and risk signals of one launch.
  • Launch timeline GET /v1/launches/{token}/timeline Elysium, HyperEVM
    The whole life of a launch as ordered events with running state.
  • New tokens GET /v1/tokens/new Elysium, HyperEVM
    Every ERC-20 created on HyperEVM, newest first, with its first pool and market figures.
  • New tokens stream WS elysium.tokens.new · hyperevm.tokens.new Elysium, HyperEVM
    One message per new token as its block is indexed, and another when its first pool opens.
  • New pools GET /v1/pools/new Elysium, HyperEVM
    Every new pair or pool on HyperEVM, from every discovered factory and PoolManager, newest first.
  • New pools stream WS elysium.pools.new · hyperevm.pools.new Elysium, HyperEVM
    One message per new pool, the moment its block is indexed.
  • Ascend swaps stream WS ascend.swaps Elysium
    Every swap of every Ascend pool, one message per block.
  • Ascended transitions WS ascend.status Elysium
    A message when a launch crosses your thresholds, in the block where it happens.
  • Lifecycle stage changes WS ascend.lifecycle Elysium
    A message when a launched token reaches its next stage: listing desk, HyperEVM mirror, HyperCore spot, perp.

More

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