# API reference · Femtos > 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. - 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/account/new (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 ## Market data Markets, candles, trades, order book, prices and pools, with their live streams. - [Markets](https://femtos.xyz/reference/markets.md) `GET /v1/markets`: Every tradable perp, spot, HIP-3 and outcome market with 24 h stats. (Elysium, HyperCore, HyperEVM) - [Candles](https://femtos.xyz/reference/candles.md) `GET /v1/candles`: OHLCV of any HyperCore market down to 1 s, ascending, UTC-aligned. (Elysium, HyperCore, HyperEVM) - [Forming candle](https://femtos.xyz/reference/ws/candles.md) `WS elysium.candles · hc.candles · hyperevm.candles`: The forming candle, pushed once per block where it changes. (Elysium, HyperCore, HyperEVM) - [Token candles](https://femtos.xyz/reference/token-candles.md) `GET /v1/candles`: OHLCV of a token through its USDC market (a perp coin: the perp). (Elysium, HyperCore, HyperEVM) - [Trades](https://femtos.xyz/reference/trades.md) `GET /v1/trades`: Latest fills of one market, newest first. (Elysium, HyperCore, HyperEVM) - [Trades stream](https://femtos.xyz/reference/ws/trades.md) `WS elysium.trades · hc.trades · hyperevm.trades`: All trades of one market as they happen: raced between our node and Hyperliquid's public feed, first copy sent, the other dropped. (Elysium, HyperCore, HyperEVM) - [Order book](https://femtos.xyz/reference/book.md) `GET /v1/book`: L2 book of one market with order counts, from our node. (HyperCore) - [Book stream](https://femtos.xyz/reference/ws/book.md) `WS hc.book`: Full-depth book, then the levels each block changes. (HyperCore) - [Best bid / offer](https://femtos.xyz/reference/ws/bbo.md) `WS hc.bbo`: 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). (HyperCore) - [Order updates](https://femtos.xyz/reference/ws/orders.md) `WS hc.orders`: Every order status change, filterable by coin, user and status. (HyperCore) - [Token prices](https://femtos.xyz/reference/prices.md) `GET /v1/prices`: USD price of up to 100 tokens in one call, each with its source and provenance. (Elysium, HyperCore, HyperEVM) - [Price history](https://femtos.xyz/reference/price-history.md) `GET /v1/prices/history`: USD closes per unit of up to 25 tokens over a window, or the price of 100 tokens at one time (at=). (Elysium, HyperCore, HyperEVM) - [HYPE price](https://femtos.xyz/reference/ws/prices.md) `WS prices.hype`: HYPE from the Hyperliquid oracle, perp mark and exchanges. (HyperCore) - [Pool detail](https://femtos.xyz/reference/pool.md) `GET /v1/pools/{address}`: One pool: dex, fee, tokens, liquidity in USD, depth, 5m to 24h activity, top LPs. (Elysium, HyperEVM) - [Liquidity events](https://femtos.xyz/reference/liquidity.md) `GET /v1/liquidity`: Liquidity added to and removed from one pool, newest first. (Elysium, HyperEVM) - [Daily token volume](https://femtos.xyz/reference/volume.md) `GET /v1/volume`: USD swap volume of a token per UTC day, both sides of every priced swap. (Elysium, HyperEVM) ## Holders & tokens Token registry and metadata, holders, security checks, spam and token families, a token across layers. - [Token registry](https://femtos.xyz/reference/coins.md) `GET /v1/coins`: HyperCore tokens with their HyperEVM contract and price. (Elysium, HyperCore, HyperEVM) - [Coin detail](https://femtos.xyz/reference/coin.md) `GET /v1/coins/{layer}/{id}`: One token: its links across layers, the markets it trades on, its 5 largest holders. (Elysium, HyperCore, HyperEVM) - [Token metadata](https://femtos.xyz/reference/tokens-batch.md) `GET /v1/tokens`: Metadata of up to 100 tokens: supply, creator, logo and socials when indexed, family, spam. Also POST with a JSON body. (Elysium, HyperCore, HyperEVM) - [Token overview](https://femtos.xyz/reference/token-overview.md) `GET /v1/tokens/{address}`: One token across all its pools: price, FDV, market cap, liquidity, windows, holders, top pools. (Elysium, HyperEVM) - [Token across layers](https://femtos.xyz/reference/token-lifecycle.md) `GET /v1/tokens/{address}/lifecycle`: One token from its Elysium launch to its HyperEVM mirror, HyperCore spot and perps, each link proven or marked inferred. (Elysium, HyperCore, HyperEVM) - [Holders](https://femtos.xyz/reference/holders.md) `GET /v1/holders`: Spot balances of a HyperCore token, largest first. (Elysium, HyperCore, HyperEVM) - [Perp holders](https://femtos.xyz/reference/holders-positions.md) `GET /v1/holders`: Largest open positions of a perp, long and short. (HyperCore) - [Token families](https://femtos.xyz/reference/token-families.md) `GET /v1/token-families`: Tokens whose balance moves without Transfer logs: Aave aTokens and debt tokens, stHYPE, xStocks. (Elysium, HyperEVM) - [Family token holders](https://femtos.xyz/reference/token-family.md) `GET /v1/token-families/{token}`: Holders of one family token with balanceOf at the indexed head. (Elysium, HyperEVM) - [Token transfers](https://femtos.xyz/reference/transfers.md) `GET /v1/transfers`: ERC-20 Transfer events of one token, newest first. (Elysium) - [Token security](https://femtos.xyz/reference/token-security.md) `GET /v1/tokens/{address}/security`: Honeypot check: a buy, a transfer and a sell simulated on our node, taxes, owner powers, holders and LP, with a verdict. (Elysium, HyperEVM) - [Spam tokens](https://femtos.xyz/reference/spam-tokens.md) `GET /v1/tokens/spam`: Tokens the indexer flags as spam, left out of every list, and the latest flag changes. (Elysium, HyperEVM) ## Balances What an address holds: every token, one token, many addresses, all layers at once; now or at a past block. - [Balances](https://femtos.xyz/reference/balances.md) `GET /v1/balances/{address}`: Every token an address holds on HyperCore, with USD value and the block it is read at. (Elysium, HyperCore, HyperEVM) - [Token balance](https://femtos.xyz/reference/token-balance.md) `GET /v1/balances/{address}/{token}`: One token of one address on HyperCore: 0 when not held, now or at a past block. (Elysium, HyperCore, HyperEVM) - [Batch balances](https://femtos.xyz/reference/batch-balances.md) `POST /v1/balances/batch`: Up to 100 addresses on HyperCore in one call, the same answer for each. (Elysium, HyperCore, HyperEVM) - [Balances, all layers](https://femtos.xyz/reference/balances-all.md) `GET /v1/balances/{address}`: One address on HyperCore, HyperEVM and Elysium in one list, with totals per layer. (Elysium, HyperCore, HyperEVM) ## Bridges & wallets One wallet across the layers, its swaps and transfers, bridge movements with both legs matched. - [Cross-layer wallet](https://femtos.xyz/reference/wallet.md) `GET /v1/wallet/{address}`: One address (or a named wallet's handle) on HyperCore, HyperEVM and Elysium, plus its latest events. (Elysium, HyperCore, HyperEVM) - [Wallet stream](https://femtos.xyz/reference/ws/wallet.md) `WS wallet`: Every event of the three layers touching one address. (Elysium, HyperCore, HyperEVM) - [Swaps by wallet](https://femtos.xyz/reference/wallet-trades.md) `GET /v1/trades`: Every swap a wallet sent (or a pool’s, a token’s), newest first, filterable by token, side, size and time. (Elysium, HyperEVM) - [Transfers by wallet](https://femtos.xyz/reference/wallet-transfers.md) `GET /v1/transfers`: ERC-20 transfers sent and received by a wallet, newest first, filterable by token, direction, size and time. (Elysium, HyperEVM) - [Ledger stream](https://femtos.xyz/reference/ws/ledger.md) `WS hc.ledger`: Deposits, withdrawals, transfers and other non-trade balance moves. (HyperCore) - [Bridge movements](https://femtos.xyz/reference/bridge.md) `GET /v1/bridges`: Matched HyperCore ↔ HyperEVM transfers with 24 h stats. (Elysium, HyperCore, HyperEVM) - [Bridge stream](https://femtos.xyz/reference/ws/bridge.md) `WS elysium.bridge · bridge.transfers`: Each HyperCore ↔ HyperEVM transfer, initiated then completed. (Elysium, HyperCore, HyperEVM) - [Bridge coverage](https://femtos.xyz/reference/bridge-coverage.md) `GET /v1/bridges/coverage`: 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. (HyperCore, HyperEVM) ## Launches Launchpad launches (Ascend, LiquidLaunch) with their signals, holders and timeline; every new token and pool. - [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 LiquidLaunch launch, the moment its block is indexed. (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. (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) - [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) ## Named wallets KOLs, traders and funds: entities, their wallets and proofs, leaderboards and latest moves. - [Named wallets](https://femtos.xyz/reference/entities.md) `GET /v1/entities`: Every named entity, its X account, kinds, sources and wallets. (Elysium, HyperCore, HyperEVM) - [One entity](https://femtos.xyz/reference/entity.md) `GET /v1/entities/{id}`: One named entity: its wallets on the three layers and 30 days of HyperCore trading. (Elysium, HyperCore, HyperEVM) - [Entity proofs](https://femtos.xyz/reference/entity-graph.md) `GET /v1/entities/{id}/graph`: How each wallet of an entity was found: the path of links back to a public source and their proofs. (Elysium, HyperCore, HyperEVM) - [KOL leaderboard](https://femtos.xyz/reference/kols.md) `GET /v1/kols/leaderboard`: KOLs, traders and funds ranked by their HyperCore PnL, volume and open positions. (Elysium, HyperCore, HyperEVM) - [KOL moves](https://femtos.xyz/reference/kol-activity.md) `GET /v1/kols/activity`: The latest fills of the named wallets, newest first, with who traded. (Elysium, HyperCore, HyperEVM) - [KOL stream](https://femtos.xyz/reference/ws/kols.md) `WS kol.activity`: Every fill, liquidation, EVM swap, transfer and bridge leg of a named wallet, live. (Elysium, HyperCore, HyperEVM) ## NFTs ERC-721 and ERC-1155 collections, tokens, holdings and transfers. - [Active NFT collections](https://femtos.xyz/reference/nft-collections.md) `GET /v1/nfts/collections`: Collections with the most transfers over the last 1 h or 24 h. (Elysium, HyperEVM) - [NFT collection](https://femtos.xyz/reference/nft-collection.md) `GET /v1/nfts/collections/{address}`: Metadata, tokens seen and 24 h activity of one collection. (Elysium, HyperEVM) - [Collection tokens](https://femtos.xyz/reference/nft-tokens.md) `GET /v1/nfts/tokens`: Tokens of a collection by id, with their owner and metadata URI. (Elysium, HyperEVM) - [NFTs of a wallet](https://femtos.xyz/reference/nft-owned.md) `GET /v1/nfts/owned`: ERC-721 tokens owned and ERC-1155 balances of one address. (Elysium, HyperEVM) - [NFT transfers](https://femtos.xyz/reference/nft-transfers.md) `GET /v1/nfts/transfers`: Transfers of a collection or one token, newest first. While HyperEVM syncs: the last 24 h or 7 d of indexed blocks. (Elysium, HyperEVM) ## Liquidations & positions Perp liquidations, open positions, open interest and the liquidation map. - [Liquidations](https://femtos.xyz/reference/liquidations.md) `GET /v1/liquidations`: Perp liquidations, newest first, one row per account, coin and block. (HyperCore) - [Liquidations stream](https://femtos.xyz/reference/ws/liquidations.md) `WS hc.liquidations`: Each liquidation fill, the block it happens. (HyperCore) - [Liquidation stats](https://femtos.xyz/reference/liquidation-stats.md) `GET /v1/liquidations/stats`: Totals, per coin, per time bucket and the largest, over a window. (HyperCore) - [Positions](https://femtos.xyz/reference/positions.md) `GET /v1/positions`: Open positions of one perp with leverage and liquidation price. (HyperCore) - [Position changes](https://femtos.xyz/reference/ws/positions.md) `WS hc.positions`: Each perp position change, one per block, account and coin. (HyperCore) - [Open interest](https://femtos.xyz/reference/positions-overview.md) `GET /v1/positions/overview`: Open interest, accounts and unrealized PnL per perp. (HyperCore) - [Liquidation map](https://femtos.xyz/reference/liqmap.md) `GET /v1/positions/liqmap`: Notional that would be liquidated at each price around the mark. (HyperCore) ## Stops & take-profits Trigger orders: the stop map, stops that fired, one wallet’s stops. - [Stop map](https://femtos.xyz/reference/stops.md) `GET /v1/hypercore/stops`: Open stop-loss and take-profit orders of one coin, bucketed by trigger price around the mark. (HyperCore) - [Stops stream](https://femtos.xyz/reference/ws/stops.md) `WS hc.stops`: Every trigger order event: placed, triggered, canceled, and the order a trigger placed. (HyperCore) - [Triggered stops](https://femtos.xyz/reference/stops-triggered.md) `GET /v1/hypercore/stops/triggered`: Stop-loss and take-profit orders that fired, newest first, with the fill they got. (HyperCore) - [Wallet stops](https://femtos.xyz/reference/wallet-stops.md) `GET /v1/hypercore/wallet/{address}/stops`: One wallet's open trigger orders, or with history=1 every status event of them. (HyperCore) ## Price-level maps Stops, liquidation prices and forced flow on one price grid, over REST and live. - [Liquidation price map](https://femtos.xyz/reference/liquidation-map.md) `GET /v1/hypercore/liquidation-map`: Liquidation prices of every open position, from Hyperliquid's formula on each account's state, bucketed like the stop map. (HyperCore) - [Liquidation map stream](https://femtos.xyz/reference/ws/liquidations-map.md) `WS hc.liquidations.map`: The GET /api/hypercore/liquidation-map map, pushed whole on subscribe and every 5 s when it changes. (HyperCore) - [Forced flow](https://femtos.xyz/reference/forced-flow.md) `GET /v1/hypercore/forced-flow`: 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. (HyperCore) - [Forced flow stream](https://femtos.xyz/reference/ws/forced-flow.md) `WS hc.forced_flow.map`: The GET /api/hypercore/forced-flow map, pushed whole on subscribe and every 5 s when it changes. (HyperCore) - [Stop map stream](https://femtos.xyz/reference/ws/stops-map.md) `WS hc.stops.map`: The GET /api/hypercore/stops map, pushed whole on subscribe and every 5 s when it changes. (HyperCore) ## Hyperliquid-compatible Hyperliquid’s own POST /info and /ws, answered from our node: switch the host, add your key. - [POST /info](https://femtos.xyz/reference/hl/info.md) `POST /info`: Hyperliquid’s /info request bodies, answered from our node. (HyperCore) - [Hyperliquid WS](https://femtos.xyz/reference/hl/ws.md) `WS /ws`: Hyperliquid’s WebSocket subscriptions, served from our node. (HyperCore) ## Chain & reference Each layer’s freshness, blocks and transactions, our Elysium RPC, your key, the OpenAPI document. - [Freshness](https://femtos.xyz/reference/status.md) `GET /v1/status`: Head and lag of each layer, measured now. (Elysium, HyperCore, HyperEVM) - [Blocks stream](https://femtos.xyz/reference/ws/blocks.md) `WS elysium.blocks · hyperevm.blocks`: Each new HyperEVM block header, small and big blocks, from our node. (Elysium, HyperEVM) - [Transaction](https://femtos.xyz/reference/tx.md) `GET /v1/tx/{hash}`: One transaction: status, gas, decoded transfers, swaps and liquidity, bridge legs and journey. (Elysium, HyperEVM) - [Elysium RPC](https://femtos.xyz/reference/rpc.md) `POST /v1/elysium/rpc`: 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. (Elysium) - [Stream stats](https://femtos.xyz/reference/ws/stats.md) `WS stats`: Our HyperCore stream health, once a second. (HyperCore) - [Check your key](https://femtos.xyz/reference/whoami.md) `GET /v1/whoami`: Answers the name your key is registered under, its tier, billing state and the limits in force. (Elysium, HyperCore, HyperEVM) - [OpenAPI document](https://femtos.xyz/reference/openapi.md) `GET /v1/openapi.json`: The OpenAPI 3.1 contract of every REST call, public. (Elysium, HyperCore, HyperEVM)