API reference

The Femtos API reference: 88 REST calls, WebSocket channels and Hyperliquid-compatible endpoints by group, each with its parameters, response fields and a live call on HyperCore, HyperEVM and Elysium.

Markdown: the reference as Markdown · every page in one file.

Market data

Markets, candles, trades, order book, prices and pools, with their live streams.

Markets GET /v1/markets Elysium, HyperCore, HyperEVM
Every tradable perp, spot, HIP-3 and outcome market with 24 h stats.
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).
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.
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.
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).
Order updates WS hc.orders HyperCore
Every order status change, filterable by coin, user and status.
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 the Hyperliquid oracle, 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.
Liquidity events GET /v1/liquidity Elysium, HyperEVM
Liquidity added to and removed from one pool, newest first.
Daily token volume GET /v1/volume Elysium, HyperEVM
USD swap volume of a token per UTC day, both sides of every priced swap.

Holders & tokens

Token registry and metadata, holders, security checks, spam and token families, a token across layers.

Token registry GET /v1/coins Elysium, HyperCore, HyperEVM
HyperCore tokens with their HyperEVM contract and price.
Coin detail GET /v1/coins/{layer}/{id} Elysium, HyperCore, HyperEVM
One token: its links across layers, the markets it trades on, its 5 largest holders.
Token metadata GET /v1/tokens Elysium, HyperCore, HyperEVM
Metadata of up to 100 tokens: supply, creator, logo and socials when indexed, family, spam. Also POST with a JSON body.
Token overview GET /v1/tokens/{address} Elysium, HyperEVM
One token across all its pools: price, FDV, market cap, liquidity, windows, holders, top pools.
Token across layers GET /v1/tokens/{address}/lifecycle Elysium, HyperCore, HyperEVM
One token from its Elysium launch to its HyperEVM mirror, HyperCore spot and perps, each link proven or marked inferred.
Holders GET /v1/holders Elysium, HyperCore, HyperEVM
Spot balances of a HyperCore token, largest first.
Perp holders GET /v1/holders HyperCore
Largest open positions of a perp, long and short.
Token families GET /v1/token-families Elysium, HyperEVM
Tokens whose balance moves without Transfer logs: Aave aTokens and debt tokens, stHYPE, xStocks.
Family token holders GET /v1/token-families/{token} Elysium, HyperEVM
Holders of one family token with balanceOf at the indexed head.
Token transfers GET /v1/transfers Elysium
ERC-20 Transfer events of one token, newest first.
Token security GET /v1/tokens/{address}/security Elysium, HyperEVM
Honeypot check: a buy, a transfer and a sell simulated on our node, taxes, owner powers, holders and LP, with a verdict.
Spam tokens GET /v1/tokens/spam Elysium, HyperEVM
Tokens the indexer flags as spam, left out of every list, and the latest flag changes.

Balances

What an address holds: every token, one token, many addresses, all layers at once; now or at a past block.

Balances GET /v1/balances/{address} Elysium, HyperCore, HyperEVM
Every token an address holds on HyperCore, with USD value and the block it is read at.
Token balance GET /v1/balances/{address}/{token} Elysium, HyperCore, HyperEVM
One token of one address on HyperCore: 0 when not held, now or at a past block.
Batch balances POST /v1/balances/batch Elysium, HyperCore, HyperEVM
Up to 100 addresses on HyperCore in one call, the same answer for each.
Balances, all layers GET /v1/balances/{address} Elysium, HyperCore, HyperEVM
One address on HyperCore, HyperEVM and Elysium in one list, with totals per layer.

Bridges & wallets

One wallet across the layers, its swaps and transfers, bridge movements with both legs matched.

Cross-layer wallet GET /v1/wallet/{address} Elysium, HyperCore, HyperEVM
One address (or a named wallet's handle) on HyperCore, HyperEVM and Elysium, plus its latest events.
Wallet stream WS wallet Elysium, HyperCore, HyperEVM
Every event of the three layers touching one address.
Swaps by wallet GET /v1/trades Elysium, HyperEVM
Every swap a wallet sent (or a pool’s, a token’s), newest first, filterable by token, side, size and time.
Transfers by wallet GET /v1/transfers Elysium, HyperEVM
ERC-20 transfers sent and received by a wallet, newest first, filterable by token, direction, size and time.
Ledger stream WS hc.ledger HyperCore
Deposits, withdrawals, transfers and other non-trade balance moves.
Bridge movements GET /v1/bridges Elysium, HyperCore, HyperEVM
Matched HyperCore ↔ HyperEVM transfers with 24 h stats.
Bridge stream WS elysium.bridge · bridge.transfers Elysium, HyperCore, HyperEVM
Each HyperCore ↔ HyperEVM transfer, initiated then completed.
Bridge coverage GET /v1/bridges/coverage HyperCore, HyperEVM
Every HyperCore ↔ HyperEVM leg since our data starts, paired with its other leg: matched share per direction and token, why the others are not, latency.

Launches

Launchpad launches (Ascend, LiquidLaunch) with their signals, holders and timeline; every new token and pool.

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.
Ascended transitions WS ascend.status Elysium
A message when a launch crosses your thresholds, in the block where it happens.
Lifecycle stage changes WS ascend.lifecycle Elysium
A message when a launched token reaches its next stage: listing desk, HyperEVM mirror, HyperCore spot, perp.

Named wallets

KOLs, traders and funds: entities, their wallets and proofs, leaderboards and latest moves.

Named wallets GET /v1/entities Elysium, HyperCore, HyperEVM
Every named entity, its X account, kinds, sources and wallets.
One entity GET /v1/entities/{id} Elysium, HyperCore, HyperEVM
One named entity: its wallets on the three layers and 30 days of HyperCore trading.
Entity proofs GET /v1/entities/{id}/graph Elysium, HyperCore, HyperEVM
How each wallet of an entity was found: the path of links back to a public source and their proofs.
KOL leaderboard GET /v1/kols/leaderboard Elysium, HyperCore, HyperEVM
KOLs, traders and funds ranked by their HyperCore PnL, volume and open positions.
KOL moves GET /v1/kols/activity Elysium, HyperCore, HyperEVM
The latest fills of the named wallets, newest first, with who traded.
KOL stream WS kol.activity Elysium, HyperCore, HyperEVM
Every fill, liquidation, EVM swap, transfer and bridge leg of a named wallet, live.

NFTs

ERC-721 and ERC-1155 collections, tokens, holdings and transfers.

Active NFT collections GET /v1/nfts/collections Elysium, HyperEVM
Collections with the most transfers over the last 1 h or 24 h.
NFT collection GET /v1/nfts/collections/{address} Elysium, HyperEVM
Metadata, tokens seen and 24 h activity of one collection.
Collection tokens GET /v1/nfts/tokens Elysium, HyperEVM
Tokens of a collection by id, with their owner and metadata URI.
NFTs of a wallet GET /v1/nfts/owned Elysium, HyperEVM
ERC-721 tokens owned and ERC-1155 balances of one address.
NFT transfers GET /v1/nfts/transfers Elysium, HyperEVM
Transfers of a collection or one token, newest first. While HyperEVM syncs: the last 24 h or 7 d of indexed blocks.

Liquidations & positions

Perp liquidations, open positions, open interest and the liquidation map.

Liquidations GET /v1/liquidations HyperCore
Perp liquidations, newest first, one row per account, coin and block.
Liquidations stream WS hc.liquidations HyperCore
Each liquidation fill, the block it happens.
Liquidation stats GET /v1/liquidations/stats HyperCore
Totals, per coin, per time bucket and the largest, over a window.
Positions GET /v1/positions HyperCore
Open positions of one perp with leverage and liquidation price.
Position changes WS hc.positions HyperCore
Each perp position change, one per block, account and coin.
Open interest GET /v1/positions/overview HyperCore
Open interest, accounts and unrealized PnL per perp.
Liquidation map GET /v1/positions/liqmap HyperCore
Notional that would be liquidated at each price around the mark.

Stops & take-profits

Trigger orders: the stop map, stops that fired, one wallet’s stops.

Stop map GET /v1/hypercore/stops HyperCore
Open stop-loss and take-profit orders of one coin, bucketed by trigger price around the mark.
Stops stream WS hc.stops HyperCore
Every trigger order event: placed, triggered, canceled, and the order a trigger placed.
Triggered stops GET /v1/hypercore/stops/triggered HyperCore
Stop-loss and take-profit orders that fired, newest first, with the fill they got.
Wallet stops GET /v1/hypercore/wallet/{address}/stops HyperCore
One wallet's open trigger orders, or with history=1 every status event of them.

Price-level maps

Stops, liquidation prices and forced flow on one price grid, over REST and live.

Liquidation price map GET /v1/hypercore/liquidation-map HyperCore
Liquidation prices of every open position, from Hyperliquid's formula on each account's state, bucketed like the stop map.
Liquidation map stream WS hc.liquidations.map HyperCore
The GET /api/hypercore/liquidation-map map, pushed whole on subscribe and every 5 s when it changes.
Forced flow GET /v1/hypercore/forced-flow HyperCore
Stop-loss / take-profit orders and liquidations on the same buckets: the cascade (stops + liquidations, with the move) and the take-profits (against it) at each price.
Forced flow stream WS hc.forced_flow.map HyperCore
The GET /api/hypercore/forced-flow map, pushed whole on subscribe and every 5 s when it changes.
Stop map stream WS hc.stops.map HyperCore
The GET /api/hypercore/stops map, pushed whole on subscribe and every 5 s when it changes.

Hyperliquid-compatible

Hyperliquid’s own POST /info and /ws, answered from our node: switch the host, add your key.

POST /info POST /info HyperCore
Hyperliquid’s /info request bodies, answered from our node.
Hyperliquid WS WS /ws HyperCore
Hyperliquid’s WebSocket subscriptions, served from our node.

Chain & reference

Each layer’s freshness, blocks and transactions, our Elysium RPC, your key, the OpenAPI document.

Freshness GET /v1/status Elysium, HyperCore, HyperEVM
Head and lag of each layer, measured now.
Blocks stream WS elysium.blocks · hyperevm.blocks Elysium, HyperEVM
Each new HyperEVM block header, small and big blocks, from our node.
Transaction GET /v1/tx/{hash} Elysium, HyperEVM
One transaction: status, gas, decoded transfers, swaps and liquidity, bridge legs and journey.
Elysium RPC POST /v1/elysium/rpc Elysium
Free public Elysium mainnet RPC by Femtos (chain 99901), no key, read only (no transaction sending), for wallets and dapps, not for indexing (use the Femtos API for history): per IP 5 requests a second and 60 a minute, batches of 5, eth_getLogs over 1,000 blocks at most, state of the last 128 blocks only.
Stream stats WS stats HyperCore
Our HyperCore stream health, once a second.
Check your key GET /v1/whoami Elysium, HyperCore, HyperEVM
Answers the name your key is registered under, its tier, billing state and the limits in force.
OpenAPI document GET /v1/openapi.json Elysium, HyperCore, HyperEVM
The OpenAPI 3.1 contract of every REST call, public.

Agent guide (agents.md)llms.txt OpenAPI MCP server Get an API key Changelog