API reference · Launches
Launch detail & signals
Metrics, dev wallet, early buyers and risk signals of one launch.
- 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}
Parameters
| Param | In | Example or values | Meaning |
|---|---|---|---|
token | path | <token> (Elysium); <llToken> (HyperEVM) | Launched token address |
earlyWindowSec | query | 60 | Early-buyer window after the launch block |
Example
Elysium
curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/launches/<token>?earlyWindowSec=60"HyperEVM
curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/launches/<llToken>?earlyWindowSec=60"Key: Authorization: Bearer $FEMTOS_KEY. Get a free key, or with no browser through agent onboarding.
Response fields
| Field | Type | Meaning |
|---|---|---|
launch | object | One launch (GET /api/launches, WS elysium.launches / hyperevm.launches). Elysium = Ascend; HyperEVM = LiquidLaunch (layer, bondedAt, bondingProgress, curvePair, dexPair, imageUri): {token, symbol, name, decimals, launchpad, launchpadName, pair, poolId, creator, quote, quoteSymbol, launchedAt, …} |
metrics | object | Raw "Ascended" metrics: Ascend's thresholds are not published, nothing is declared qualified: {priceUsd, priceQuote, mcapUsd, athMcapUsd, holders, top10Share, devHoldsShare, volume24hUsd, trades24h, volumeSinceLaunchUsd, tradesSinceLaunch, traders, …} |
dev | object | {address, devBuyTokens, balance, holdsShare, buys, sells, sold, transfersOut} |
holders | object | {total, top} |
earlyBuyers | object | {windowSec, fundingLookbackSec, list} (Elysium) |
signals[] | object | {rule, severity, addresses, detail, block, funder, evidence} |
fees | object | null | Estimated fees (1 % of volume; creator 25 %, approved creator 50 %), with `exact` (ExactFees, Elysium): the launchpad's own fee events (null without the indexer's ascend_ledger). null for LiquidLaunch (fees not published): {estimate, rate, volumeUsd, totalUsd, creatorUsd, creatorUsdIfApproved, creatorShare, creatorShareApproved, exact} (Elysium) |
ascend | object | Elysium: progress toward "Ascended", plus coordination = {flaggedWallets, flaggedHoldShare (their balances / supply), highSignals}: the evidence of the coordinated-accumulation check, not a criterion: {status, thresholds, met, of, criteria, coordination} (Elysium) |
partial | funding | devTransfersOut[] | HyperEVM: reads skipped (no address indexes yet): no funding signals, no dev transfers out (HyperEVM) |
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 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.
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