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
| Param | In | Example or values | Meaning |
|---|---|---|---|
token | path | <token> (Elysium); <llToken> (HyperEVM) | Launched token address |
limit | query | 20 | Rows |
cursor | query | (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
| Field | Type | Meaning |
|---|---|---|
totalHolders | int | Positive balances, system addresses excluded |
concentration | object | {top1Share, top10Share, top20Share, top50Share, hhi, devShare, flaggedShare, heldShare} |
system | object | {holders, amount, shareOfSupply} |
holders[] | object | {rank, address, amount, shareOfSupply, firstSeenAt, lastActiveAt, tag, flags, entity} |
next_cursor | string | null | Opaque 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
- 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