API reference, Market data
Token prices stream
- Elysium: USD prices of up to 100 Elysium tokens, as GET /v1/prices answers them, pushed in each block that changes one.
- HyperEVM: USD prices of up to 100 HyperEVM tokens, as GET /v1/prices answers them, pushed in each block that changes one.
- Not on HyperCore: HyperCore prices move on its order books: hc.ctx streams every market’s mark and mid, prices.hype every HYPE source
WebSocket channel elysium.prices on wss://api.femtos.xyz/v1/ws | WebSocket channel hyperevm.prices on wss://api.femtos.xyz/v1/ws
Parameters
| Param | In | Example or values | Meaning |
|---|---|---|---|
tokens | filter | 0xedb963ed6efe231f6327c87a42ed49abe2447afa (Elysium); 0x5555555555555555555555555555555555555555,0xb88339cb7199b77e23db6e890353e22632ba630f,native (HyperEVM) | Comma list of up to 100 token addresses (`native` = HYPE, the chain's native token) |
Subscribe
Elysium
{"op":"subscribe","channel":"elysium.prices","filter":{"tokens":"0xedb963ed6efe231f6327c87a42ed49abe2447afa"}}HyperEVM
{"op":"subscribe","channel":"hyperevm.prices","filter":{"tokens":"0x5555555555555555555555555555555555555555,0xb88339cb7199b77e23db6e890353e22632ba630f,native"}}Key: Authorization: Bearer $FEMTOS_KEY. Get a free key, or with no browser through agent onboarding.
Response fields
| Field | Type | Meaning |
|---|---|---|
snapshot: true | PricePoint[] | the GET /v1/prices?layer=elysium `prices` of the tokens, in the order asked (Elysium) |
data | PricePoint[] | the rows of the tokens whose price changed in the blocks the indexer just committed (same row as GET /v1/prices; `native` stays `native`), one message per block that changes one: a pool-priced token when its reference pool trades (or another pool becomes its reference), HYPE and the HyperCore-linked tokens when their HyperCore price moved. Source of each price: `hl_mid` = HyperCore HYPE/USDC spot mid (HYPE, the native token and WHYPE; `hl_oracle` when the mid is older than 10 min), `hl_spot` = last trade of the token's USDC spot market on HyperCore (HyperCore tokens, and HyperEVM tokens linked to one by the token registry), `hl_perp` = last trade of a HyperCore perp, `unit` = USDC (the unit HyperCore prices in), `pool` = the last swap of the token's reference pool on HyperEVM / Elysium, cited by block + tx + logIndex. The reference pool of a token: among its active pools whose USD price is known (pools of a spam token left out, unless the token itself is spam), the one with the largest liquidityUsd of at least $1,000 (twice the smaller side of what the pool contract holds at the indexed head, valued at USD prices: HyperCore for HYPE, WHYPE and the Core-linked tokens); when none reaches it, the most 24 h USD volume, then the most trades, then the oldest pool. Uniswap V4 / PancakeSwap Infinity / Balancer pools keep their tokens in a shared vault: their liquidity is not measured (null), they rank by volume.: {token, symbol, priceUsd, source, t, block, tx, logIndex, pool, market, reason, spam, …} |
snapshot: true | PricePoint[] | the GET /v1/prices?layer=hyperevm `prices` of the tokens, in the order asked (HyperEVM) |
Related: Market data
- Markets GET /v1/markets Elysium, HyperCore, HyperEVM
Every tradable perp, spot, HIP-3 and outcome market with 24 h stats. - Markets stream WS elysium.markets | hc.markets | hyperevm.markets Elysium, HyperCore, HyperEVM
The GET /v1/markets list of HyperCore (prices, 24 h volume and change), pushed on subscribe and when it changes. - Token screener GET /v1/tokens/top Elysium, HyperEVM
The tokens of HyperEVM, one row each over all their pools: trending, volume, gainers, losers, new, market cap, liquidity. - Candles GET /v1/candles Elysium, HyperCore, HyperEVM
OHLCV of any HyperCore market down to 1 s, ascending, UTC-aligned. - Forming candle WS elysium.candles | hc.candles | hyperevm.candles Elysium, HyperCore, HyperEVM
The forming candle, pushed once per block where it changes. - Token candles GET /v1/candles Elysium, HyperCore, HyperEVM
OHLCV of a token through its USDC market (a perp coin: the perp). - Token candles stream WS elysium.token.candles | hc.token.candles | hyperevm.token.candles Elysium, HyperCore, HyperEVM
A token's candles by name (its USDC market; a perp coin: the perp), the forming candle pushed once per block where it changes. - Trades GET /v1/trades Elysium, HyperCore, HyperEVM
Latest fills of one market, newest first. - Trades stream WS elysium.trades | hc.trades | hyperevm.trades Elysium, HyperCore, HyperEVM
All trades of one market as they happen: raced between our node and Hyperliquid's public feed, first copy sent, the other dropped. - Swap history stream WS elysium.trades.history | hyperevm.trades.history Elysium, HyperEVM
The latest swaps of a token or pool on HyperEVM (GET /v1/trades with filters), pushed on subscribe, then each block with a new swap it shows. - Order book GET /v1/book HyperCore
L2 book of one market with order counts, from our node. - Book stream WS hc.book HyperCore
Full-depth book, then the levels each block changes. - Named wallets on the book WS hc.book.named HyperCore
Who sits on the book: the resting limit orders of the named wallets (funds, traders, KOLs), by level, live. - Walls on the book WS hc.book.walls HyperCore
Every large resting order on the book with its owner, live, and whether that owner's walls hold or are pulled when the price comes. - Wall reliability GET /v1/hypercore/walls HyperCore
Which accounts' large resting orders hold when the price comes, and which are pulled. - Walls held or pulled GET /v1/hypercore/walls/events HyperCore
One market's walls the price came to, one by one: held or pulled, when and whose. - Best bid / offer WS hc.bbo HyperCore
Top of book of one market each block: raced between Hyperliquid's public feed and our node (newest block wins, our node corrects the same block). - Asset contexts stream WS hc.ctx HyperCore
Mark, oracle, mid, funding, open interest and 24 h volume of every HyperCore market, pushed as they change: one read per second for every subscriber. - Order updates WS hc.orders HyperCore
Every order status change, filterable by coin, user and status. One frame per block with all its matching events. - Token prices GET /v1/prices Elysium, HyperCore, HyperEVM
USD price of up to 100 tokens in one call, each with its source and provenance. - Price history GET /v1/prices/history Elysium, HyperCore, HyperEVM
USD closes per unit of up to 25 tokens over a window, or the price of 100 tokens at one time (at=). - HYPE price WS prices.hype HyperCore
HYPE from HyperCore’s spot mid (each block), the Hyperliquid oracle and perp mark, and exchanges. - Pool detail GET /v1/pools/{address} Elysium, HyperEVM
One pool: dex, fee, tokens, liquidity in USD, depth, 5m to 24h activity, top LPs. - Pool stream WS elysium.pool | hyperevm.pool Elysium, HyperEVM
One pool on HyperEVM (GET /v1/pools/{address}: price, liquidity and depth, 5m to 24h activity, LPs), pushed on subscribe, then in each block that touches it: swap, liquidity added or removed, balance moved. - Liquidity events GET /v1/liquidity Elysium, HyperEVM
Liquidity added to and removed from one pool, newest first. - Liquidity events stream WS elysium.liquidity | hyperevm.liquidity Elysium, HyperEVM
Liquidity added to and removed from one pool on HyperEVM (GET /v1/liquidity), pushed on subscribe, then in each block that adds or removes some. - Daily token volume GET /v1/volume Elysium, HyperEVM
USD swap volume of a token per UTC day, both sides of every priced swap.
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