API reference · Launches

Launches stream

Elysium: One message per new launch, the moment its block is indexed.
HyperEVM: One message per new LiquidLaunch launch, the moment its block is indexed.

WebSocket channel elysium.launches on wss://api.femtos.xyz/v1/ws · WebSocket channel hyperevm.launches on wss://api.femtos.xyz/v1/ws

Parameters

Param	In	Example or values	Meaning
`launchpad`	filter	(optional)	Launchpad name or address, e.g. ascend (Elysium)
`include_spam`	filter	`(empty)`, `true`	true: also the rows of spam tokens (flagged `spam`), left out by default

Elysium

{"op":"subscribe","channel":"elysium.launches","filter":{}}

HyperEVM

{"op":"subscribe","channel":"hyperevm.launches","filter":{}}

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

Field	Type	Meaning
`snapshot: true`	LaunchRow[]	last 50 launches at subscribe, chronological (Elysium)
`data`	LaunchRow	one new launch (same shape as GET /api/launches), as soon as its block is indexed: {token, symbol, name, decimals, launchpad, launchpadName, pair, poolId, creator, quote, quoteSymbol, launchedAt, …} (Elysium)
`ts.source`	int	block time of the launch (ms) (Elysium)
`snapshot: true`	LaunchRow[]	last 50 LiquidLaunch launches at subscribe, chronological (HyperEVM)
`data`	LaunchRow	one new launch (same shape as GET /api/launches): {token, symbol, name, decimals, launchpad, launchpadName, pair, poolId, creator, quote, quoteSymbol, launchedAt, …} (HyperEVM)

Launches GET /v1/launches Elysium, HyperEVM
Latest LiquidLaunch bonding-curve launches, newest first.
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.
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.