API reference · Launches

Ascended transitions

A message when a launch crosses your thresholds, in the block where it happens.

  • Elysium
  • HyperCore: not served
  • HyperEVM: not served
  • Not on HyperCore: a channel of Elysium only
  • Not on HyperEVM: Ascend is an Elysium launchpad; HyperEVM launches (LiquidLaunch): hyperevm.launches

WebSocket channel ascend.status on wss://api.femtos.xyz/v1/ws

Parameters

ParamInExample or valuesMeaning
tokenfilter(optional)Launched token: 0x address
launchpadfilter(optional)Launchpad name
min_mcap_usdfilter50000Threshold: minimum market cap, USD
min_holdersfilter20Threshold: minimum holders
min_volume_usdfilter(optional)Threshold: minimum volume since launch, USD
max_top10_sharefilter(optional)Threshold: maximum top-10 share of the supply

Subscribe

{"op":"subscribe","channel":"ascend.status","filter":{"min_mcap_usd":"50000","min_holders":"20"}}

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

Response fields

FieldTypeMeaning
snapshot: trueAscendStatusRow[]{token, symbol, pair, launchpad, status, ascend} of the last 50 launches (or of `token`), chronological
data.kindascended | lost | criterionascended: the derived status became ascended; lost: it left it; criterion: one criterion flipped
data.crossed[]objectThe criteria that flipped: {criterion, met}
data.ascendobjectprogress after the block: {status, thresholds, met, of, criteria}

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

Agent guide (agents.md)llms.txtOpenAPIMCP serverGet an API keyChangelog