API reference · Launches

New tokens

Elysium: Every ERC-20 created on Elysium, newest first, with its first pool and market figures.
HyperEVM: Every ERC-20 created on HyperEVM, newest first, with its first pool and market figures.

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

Parameters

Param	In	Example or values	Meaning
`layer`	query	`elysium` (Elysium); `hyperevm` (HyperEVM)	EVM layer
`limit`	query	`20`	Rows
`hasPool`	query	`(empty)`, `true`, `false`	true: tokens with a pool; false: without
`minLiquidityUsd`	query	(optional)	Minimum liquidityUsd
`minHolders`	query	(optional)	Minimum holders
`launchpad`	query	`(empty)`, `any`, `none`, `ascend` (Elysium); `(empty)`, `any`, `none`, `liquidlaunch` (HyperEVM)	ascend, liquidlaunch (a launchpad name), none (no launchpad), any (a launchpad), or a launchpad 0x address
`creator`	query	(optional)	Created by this wallet (0x)
`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
`security`	query	`(empty)`, `summary`	summary: each row gets `security` = {verdict, reasons (3), asOf, height} of GET /api/tokens/{address}/security when a report is cached (< 10 min), else null (then computed in the background: ask again)
`cursor`	query	(optional)	Next page: `next_cursor` of the previous answer

Elysium

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

HyperEVM

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/tokens/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
`tokens[]`	object	Newest first: {seq, address, symbol, name, decimals, totalSupply, createdAt, block, tx, logIndex, creationBasis, creator, …}
`next_cursor`	string \| null	Opaque cursor of the next page: pass it as `cursor`, unchanged. null on the last page
`scanned`	int	Tokens 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 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.