# New pools stream · HyperEVM API · Femtos

> One message per new pool, the moment its block is indexed.

- 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://femtos.xyz/accounts/ (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/hyperevm/ws-new-pools

WebSocket: get a ticket (`POST https://api.femtos.xyz/v1/ws-ticket` with your key), connect to `wss://api.femtos.xyz/v1/ws?ticket=$TICKET`, send the frame below; the first message has `"snapshot": true`. Details: https://femtos.xyz/agents.md#websocket

## New pools stream — WS `hyperevm.pools.new`

One message per new pool, the moment its block is indexed.

| Param | In | Example or values | Meaning |
|---|---|---|---|
| `include_spam` | filter | `(empty)`, `true` | true: also the rows of spam tokens (flagged `spam`), left out by default |
| `dex` | filter | (optional) | Protocol, e.g. hyperswap_v3 |
| `token` | filter | (optional) | Token on either side: 0x address |
| `quote` | filter | (optional) | Quote token: 0x address |
| `new_token_only` | filter | `(empty)`, `true` | true: pools with a side created at most 60 min before it only |

```json
{"op":"subscribe","channel":"hyperevm.pools.new","filter":{}}
```

| Field | Type | Meaning |
|---|---|---|
| `snapshot: true` | PoolNew[] | last 50 pools at subscribe, oldest first |
| `data` | PoolNew | one new pool (the GET /api/pools/new row), pushed when the indexer commits the block: {seq, address, dex, factory, feeTier, tickSpacing, hooks, token0, token1, base, quote, newToken, …} |

## Related (Launches)

- [LiquidLaunch launches](https://femtos.xyz/hyperevm/launches.md): Latest LiquidLaunch bonding-curve launches, newest first.
- [Launches stream](https://femtos.xyz/hyperevm/ws-launches.md): One message per new LiquidLaunch launch, the moment its block is indexed.
- [New tokens](https://femtos.xyz/hyperevm/new-tokens.md): Every ERC-20 created on HyperEVM, newest first, with its first pool and market figures.
- [New pools](https://femtos.xyz/hyperevm/new-pools.md): Every new pair or pool on HyperEVM, from every discovered factory and PoolManager, newest first.
- [New tokens stream](https://femtos.xyz/hyperevm/ws-new-tokens.md): One message per new token as its block is indexed, and another when its first pool opens.
- [Launch detail & signals](https://femtos.xyz/hyperevm/signals.md): Metrics, dev wallet, early buyers and risk signals of one launch.
- [Launch timeline](https://femtos.xyz/hyperevm/timeline.md): The whole life of a launch as ordered events with running state.

All HyperEVM endpoints: https://femtos.xyz/hyperevm.md