API reference, Market data
Walls on the book
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.
- Elysium: not served
- HyperCore
- HyperEVM: not served
- Not on Elysium or HyperEVM: the EVM layers trade on AMM pools, with no order book: pool detail and liquidity events cover a pool
WebSocket channel hc.book.walls on wss://api.femtos.xyz/v1/ws
Parameters
| Param | In | Example or values | Meaning |
|---|---|---|---|
coin | filter | BTC | HyperCore market: BTC, @107 (spot), xyz:TSLA (HIP-3) |
Subscribe
{"op":"subscribe","channel":"hc.book.walls","filter":{"coin":"BTC"}}Key: Authorization: Bearer $FEMTOS_KEY. Get a free key, or with no browser through agent onboarding.
Response fields
| Field | Type | Meaning |
|---|---|---|
snapshot: true | HcWallBook | every resting limit order worth $100k or more at placement, whoever placed it, with its `entity` when named and its owner's wall record on the market (`walls`) |
data | HcWallBookDelta | the large orders each block placed, changed or removed (sz "0"), same block as hc.book: {height, prevHeight, orders} |
data.orders[] | object | Orders placed, changed or gone (sz "0"); one stays until it leaves the book, a fill taking it under $100k included: {oid, user, side, px, sz, entity, walls, position} |
data.prevHeight | int | Height of the previous frame of this subscription: must equal yours, else resubscribe |
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. - 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. - Token prices stream WS elysium.prices | hyperevm.prices Elysium, HyperEVM
USD prices of up to 100 HyperEVM tokens, as GET /v1/prices answers them, pushed in each block that changes one. - 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 HyperCore serves
- The whole API in one Markdown file
- OpenAPI 3.1 document
Agent guide (agents.md)llms.txtOpenAPIMCP serverGet an API keyChangelog