API reference · Launches

Launch timeline

The whole life of a launch as ordered events with running state.

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

Parameters

Param	In	Example or values	Meaning
`token`	path	`<token>` (Elysium); `<llToken>` (HyperEVM)	Launched token address

Elysium

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/launches/<token>/timeline"

HyperEVM

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/launches/<llToken>/timeline"

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

Field	Type	Meaning
`launch`	object	{t, block, tx, creator, supplySeeded, devBuyTokens, quote, quoteSymbol}
`events[]`	object	Chain order (block, log index): {kind, t, block, tx, logIndex, first, creator, supplySeeded, devBuyTokens, side, trader, tokens, …}
`events[].holders`	int	Unique holders after the event (Elysium)
`events[].top10Share`	number \| null	Top-10 share of supply after the event (Elysium)
`events[].mcapUsd`	decimal \| null	swap: market cap in USD (Elysium)
`events[].volumeUsd`	decimal	swap: cumulative volume since launch, USD (Elysium)
`current`	object	{priceUsd, mcapUsd, holders, top10Share, volume24hUsd, volumeSinceLaunchUsd, trades, traders, devHoldsShare}
`graduation`	object	{mirror, core} (Elysium)
`truncated`	boolean	More than 5,000 swaps or 20,000 transfers: the replay stops there
`holdersFrom`	transfers \| swaps	What the running holders are replayed from: the ERC-20 transfers, or the swaps only (LiquidLaunch: wallet-to-wallet transfers not seen, holder counts approximate) (HyperEVM)

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 holders GET /v1/launches/{token}/holders Elysium, HyperEVM
Every holder of a launched token, tagged dev or early buyer, with concentration.
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.