API reference · Launches

New pools

Elysium: Every new pair or pool on Elysium, from every discovered factory and PoolManager, newest first.
HyperEVM: Every new pair or pool on HyperEVM, from every discovered factory and PoolManager, newest first.

GET https://api.femtos.xyz/v1/pools/new

Parameters

Param	In	Example or values	Meaning
`layer`	query	`elysium` (Elysium); `hyperevm` (HyperEVM)	EVM layer
`limit`	query	`20`	Rows
`newTokenOnly`	query	`(empty)`, `true`, `false`	Only pools with a new token (newToken not null)
`minLiquidityUsd`	query	(optional)	Minimum liquidity.usd
`dex`	query	(optional)	Protocol (hyperswap_v3, projectx_v3, uniswap_v4, pancake_infinity_cl, liquidlaunch…)
`token`	query	(optional)	Pools of this token, either side (0x)
`quote`	query	(optional)	Pools quoted in this token (0x), e.g. WHYPE
`includeSpam`	query	`(empty)`, `true`	Show spam tokens (tokens.spam: homoglyph, impostor, phishing name, fake transfers…) flagged spam / spamReason; left out of the list by default
`cursor`	query	(optional)	Next page: `next_cursor` of the previous answer

Elysium

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/pools/new?layer=elysium&limit=20"

HyperEVM

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/pools/new?layer=hyperevm&limit=20"

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

Field	Type	Meaning
`layer`	string	Layer
`pools[]`	object	Newest first: {seq, address, dex, factory, feeTier, tickSpacing, hooks, token0, token1, base, quote, newToken, …}
`next_cursor`	string \| null	Opaque cursor of the next page: pass it as `cursor`, unchanged. null on the last page
`scanned`	int	Pools examined for this page
`asOf`	ms	Time of `height`
`height`	int	Head block of the layer the answer is cut at: every event up to it is counted
`syncing`	true	Present while the layer syncs: data only up to dataUntil
`dataUntil`	ms	Indexed head time while the layer syncs

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

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.
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 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.