# Femtos | Launchpads ranked | API reference

> Every HyperEVM launchpad ranked by launches, graduations or 24 h volume, with its top token. GET /v1/launchpads on Elysium and HyperEVM: parameters, response fields and a live call per layer.

- Base URL: `https://api.femtos.xyz/v1` (REST) · `wss://api.femtos.xyz/v1/ws` (WebSocket) · MCP: `https://api.femtos.xyz/mcp`
- Auth: `Authorization: Bearer $FEMTOS_KEY`. Free key: https://dashboard.femtos.xyz/signup (browser), or with
  no browser: `GET https://femtos.xyz/accounts/agent/challenge`, solve its proof of work, then `POST https://femtos.xyz/accounts/agent/signup`
  (https://femtos.xyz/agents.md#agent-onboarding)
- Decimals are exact strings, times Unix milliseconds, addresses lowercase `0x`
- Whole API in one file: https://femtos.xyz/agents.md · OpenAPI: https://api.femtos.xyz/v1/openapi.json · Index: https://femtos.xyz/llms.txt
- Page with live calls: https://femtos.xyz/reference/launchpad-ranking

## Launchpads ranked — GET `/v1/launchpads`

- Elysium: Every Elysium launchpad ranked by launches, graduations or 24 h volume, with its top token.
- HyperEVM: Every HyperEVM launchpad ranked by launches, graduations or 24 h volume, with its top token.

Layers: Elysium, HyperEVM. Not on HyperCore: served on Elysium and HyperEVM only.
Page with live calls: https://femtos.xyz/reference/launchpad-ranking?layer=<elysium|hyperevm>

| Param | In | Example or values | Meaning |
|---|---|---|---|
| `layer` | query | `elysium` (Elysium); `hyperevm` (HyperEVM) | EVM layer |
| `sort` | query | `(empty)`, `launches24h`, `volume24h`, `graduated`, `launches` | launches24h (default), volume24h, graduated or launches (all time), most first; `unknown` always last |

Elysium:

```bash
curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/launchpads?layer=elysium&sort=launches24h"
```

HyperEVM:

```bash
curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/launchpads?layer=hyperevm&sort=launches24h"
```

| Field | Type | Meaning |
|---|---|---|
| `asOf` | ms | When the figures were built |
| `launchpads[]` | object | Ranked by `sort`: {name, label, known, nameBasis, kit, contracts, launches24h, launches7d, launches, curveLaunches, onCurve, graduated, …} |
| `launchpads[].name` | string | Launchpad name: the `launchpad` filter of GET /v1/launches. `unknown`: the launches no launchpad we know of names (tokens launched by a contract we cannot name yet, or by their creator directly) |
| `launchpads[].label` | string \| null | Its display name (as the launchpad writes it); null for `unknown` or when none is held |
| `launchpads[].known` | boolean | false for `unknown` only: not a launchpad, the bucket of the launches nothing names. It is listed last |
| `launchpads[].launches24h` | int | Launches in the last 24 hours |
| `launchpads[].graduated` | int \| null | Curve launches that graduated to a DEX pool; null when none of its launches is on a curve (a launch straight into a pool has nothing to graduate from; an Ascend pool's escrow graduation is `ascendGraduation` of its launch row) |
| `launchpads[].graduationRate` | number \| null | graduated / curveLaunches, 0 to 1; null as `graduated` |
| `launchpads[].volume24hUsd` | decimal | 24 h volume in USD of its tokens, each in the pool it trades in now (exact sum of the markets list's volume24hUsd) |
| `launchpads[].top` | object \| null | Its token with the most 24 h volume; null when none traded in 24 hours: {token, symbol, market, volume24hUsd, mcapUsd} |

## Related (Launches)

- [One launchpad](https://femtos.xyz/reference/launchpad.md) `GET /v1/launchpads/{name}`: One HyperEVM launchpad's figures and its launches and graduations per day over 30 days. (Elysium, HyperEVM)
- [Launches](https://femtos.xyz/reference/launches.md) `GET /v1/launches`: Latest LiquidLaunch bonding-curve launches, newest first. (Elysium, HyperEVM)
- [Launches stream](https://femtos.xyz/reference/ws/launches.md) `WS elysium.launches | hyperevm.launches`: One message per new launch of a HyperEVM launchpad (LiquidLaunch by default; Signal, Alt.fun or every launchpad with the launchpad filter), the moment its block is indexed; with updates, one more each time a launch trades on its curve, trades for the first time or graduates. (Elysium, HyperEVM)
- [Launch detail & signals](https://femtos.xyz/reference/signals.md) `GET /v1/launches/{token}`: Metrics, dev wallet, early buyers and risk signals of one launch. (Elysium, HyperEVM)
- [Launch holders](https://femtos.xyz/reference/launch-holders.md) `GET /v1/launches/{token}/holders`: Every holder of a launched token, tagged dev or early buyer, with concentration. (Elysium, HyperEVM)
- [Launch timeline](https://femtos.xyz/reference/timeline.md) `GET /v1/launches/{token}/timeline`: The whole life of a launch as ordered events with running state. (Elysium, HyperEVM)
- [New tokens](https://femtos.xyz/reference/new-tokens.md) `GET /v1/tokens/new`: Every ERC-20 created on HyperEVM, newest first, with its first pool and market figures. (Elysium, HyperEVM)
- [New tokens stream](https://femtos.xyz/reference/ws/new-tokens.md) `WS elysium.tokens.new | hyperevm.tokens.new`: One message per new token as its block is indexed, and another when its first pool opens; with updates, one more each time a new token trades. (Elysium, HyperEVM)
- [New pools](https://femtos.xyz/reference/new-pools.md) `GET /v1/pools/new`: Every new pair or pool on HyperEVM, from every discovered factory and PoolManager, newest first. (Elysium, HyperEVM)
- [New pools stream](https://femtos.xyz/reference/ws/new-pools.md) `WS elysium.pools.new | hyperevm.pools.new`: One message per new pool, the moment its block is indexed. (Elysium, HyperEVM)
- [Creator sells stream](https://femtos.xyz/reference/ws/creator-sells.md) `WS elysium.creator.sells | hyperevm.creator.sells`: A token's creator selling it on HyperEVM: amount, USD, the share of its holding sold and what it still holds, one message per block. (Elysium, HyperEVM)
- [Ascend swaps stream](https://femtos.xyz/reference/ws/ascend-swaps.md) `WS ascend.swaps`: Every swap of every Ascend pool, one message per block. (Elysium)
- [Ascended transitions](https://femtos.xyz/reference/ws/ascend-status.md) `WS ascend.status`: A message when a launch crosses your thresholds, in the block where it happens. (Elysium)
- [Lifecycle stage changes](https://femtos.xyz/reference/ws/ascend-lifecycle.md) `WS ascend.lifecycle`: A message when a launched token reaches its next stage: listing desk, HyperEVM mirror, HyperCore spot, perp. (Elysium)

Every page: https://femtos.xyz/reference.md