# Femtos

> Hyperliquid data API across HyperCore, HyperEVM and Elysium: REST, WebSocket, a hosted MCP server for agents and a Hyperliquid-compatible /info, with the latency of every call measured live.

REST base `https://api.femtos.xyz/v1` with `Authorization: Bearer <key>` (or `X-API-KEY`); WebSocket `wss://api.femtos.xyz/v1/ws`; hosted MCP `https://api.femtos.xyz/mcp` (Streamable HTTP); Hyperliquid-compatible `POST https://api.femtos.xyz/info` and `wss://api.femtos.xyz/ws`. Decimals are exact strings, times Unix ms.

Get a key with no browser: `GET https://femtos.xyz/accounts/agent/challenge`, solve the SHA-256 proof of work, then `POST https://femtos.xyz/accounts/agent/signup {agent_name, salt, nonce}` → key and management secret (both shown once), free tier at once. Quotas and balance: `GET https://femtos.xyz/accounts/agent/me` with the key. Credits: `POST https://femtos.xyz/accounts/agent/checkout {amount_usd}` with the key → Stripe Checkout URL and the key's USDC deposit address on HyperCore and HyperEVM (an agent can pay itself); a `402` from the API points there. Pay with x402 (disabled until announced): a request with no key answers `402` with a credit pack to buy in USDC on Base, Arbitrum One or HyperEVM (x402 v1 / v2; the first `accepts` entry settles cheapest; packs from $0.01, `?x402_pack=<USD>` for a bigger one); the paid retry is served with a new key in `X-Femtos-Key`. Chains and ranking: `GET https://api.femtos.xyz/v1/x402/networks` (no key).

## Docs

- [Agent guide](https://femtos.xyz/agents.md): every endpoint, its parameters, fields and a ready call, in one Markdown file; onboarding, WebSocket, MCP and x402 details
- [OpenAPI](https://api.femtos.xyz/v1/openapi.json): machine-readable REST contract (OpenAPI 3.1)
- [MCP server](https://femtos.xyz/mcp.md): 27 tools over the three layers, client setup for Claude, Cursor, OpenAI
- [Overview](https://femtos.xyz/index.md): what Femtos serves, rules, layers

## Layers

- [Elysium](https://femtos.xyz/elysium.md): Kinetiq's Orbit L2 on HyperEVM: Ascend launches, PancakeSwap Infinity pools, holders, NFTs; 35 endpoints
- [HyperCore](https://femtos.xyz/hypercore.md): the Hyperliquid exchange: order book, perps, spot, HIP-3 markets, liquidations, positions; 38 endpoints
- [HyperEVM](https://femtos.xyz/hyperevm.md): the Hyperliquid EVM chain: DEX pools, swaps, tokens, holders, NFTs, LiquidLaunch launches; 31 endpoints

## Optional

- [Full guide as one text file](https://femtos.xyz/llms-full.txt): the same as agents.md
- [Launch story · Elysium API](https://femtos.xyz/elysium/lifecycle.md): One Ascend launch on Elysium told event by event from the Femtos API: launch, dev wallet, early buyers, swaps, holders, market cap over time.
- [Launch story · HyperEVM API](https://femtos.xyz/hyperevm/lifecycle.md): One LiquidLaunch launch on HyperEVM told event by event from the Femtos API: launch, dev wallet, early buyers, swaps, holders, market cap over time.
- [Elysium · New launches](https://femtos.xyz/elysium/launches.md): Latest Ascend launches, newest first, with live market figures.
- [Elysium · Launches stream](https://femtos.xyz/elysium/ws-launches.md): One message per new launch, the moment its block is indexed.
- [Elysium · Ascend swaps stream](https://femtos.xyz/elysium/ws-ascend-swaps.md): Every swap of every Ascend pool, one message per block.
- [Elysium · Ascended transitions](https://femtos.xyz/elysium/ws-ascend-status.md): A message when a launch crosses your thresholds, in the block where it happens.
- [Elysium · Lifecycle stage changes](https://femtos.xyz/elysium/ws-ascend-lifecycle.md): A message when a launched token reaches its next stage: listing desk, HyperEVM mirror, HyperCore spot, perp.
- [Elysium · Candles](https://femtos.xyz/elysium/candles.md): OHLCV of one pool in pair price, USD and market cap, ascending, UTC-aligned.
- [Elysium · Forming candle](https://femtos.xyz/elysium/ws-candles.md): The forming candle, pushed once per block where it changes.
- [Elysium · Trades](https://femtos.xyz/elysium/trades.md): Latest swaps of one pool, newest first.
- [Elysium · Trades stream](https://femtos.xyz/elysium/ws-trades.md): The swaps of one pool, one message per block that has some.
- [Elysium · Holders](https://femtos.xyz/elysium/holders.md): Current balances of a token, largest first, with concentration.
- [Elysium · Launch detail & signals](https://femtos.xyz/elysium/signals.md): Metrics, dev wallet, early buyers and risk signals of one launch.
- [Elysium · Launch holders](https://femtos.xyz/elysium/launch-holders.md): Every holder of a launched token, tagged dev or early buyer, with concentration.
- [Elysium · Launch timeline](https://femtos.xyz/elysium/timeline.md): The whole life of a launch as ordered events with running state.
- [Elysium · Token across layers](https://femtos.xyz/elysium/token-lifecycle.md): One token from its Elysium launch to its HyperEVM mirror, HyperCore spot and perps, each link proven or marked inferred.
- [Elysium · Bridge movements](https://femtos.xyz/elysium/bridge.md): HyperEVM ↔ Elysium movements with 24 h stats.
- [Elysium · Bridge stream](https://femtos.xyz/elysium/ws-bridge.md): Each state change of a HyperEVM ↔ Elysium movement, live.
- [Elysium · Cross-layer wallet](https://femtos.xyz/elysium/wallet.md): One address (or a named wallet's handle) on HyperCore, HyperEVM and Elysium, plus its latest events.
- [Elysium · Wallet stream](https://femtos.xyz/elysium/ws-wallet.md): Every event of the three layers touching one address.
- [Elysium · Token registry](https://femtos.xyz/elysium/coins.md): Links one token across Elysium, HyperEVM and HyperCore.
- [Elysium · Coin detail](https://femtos.xyz/elysium/coin.md): One token: its links across layers, the markets it trades on, its 5 largest holders.
- [Elysium · Daily token volume](https://femtos.xyz/elysium/volume.md): USD swap volume of a token per UTC day, both sides of every priced swap. Testnet pool prices.
- [Elysium · Token transfers](https://femtos.xyz/elysium/transfers.md): ERC-20 Transfer events of one token, newest first.
- [Elysium · Liquidity events](https://femtos.xyz/elysium/liquidity.md): Liquidity added to and removed from one pool, newest first.
- [Elysium · Active NFT collections](https://femtos.xyz/elysium/nft-collections.md): Collections with the most transfers over the last 1 h or 24 h.
- [Elysium · NFT collection](https://femtos.xyz/elysium/nft-collection.md): Metadata, tokens seen and 24 h activity of one collection.
- [Elysium · Collection tokens](https://femtos.xyz/elysium/nft-tokens.md): Tokens of a collection by id, with their owner and metadata URI.
- [Elysium · NFTs of a wallet](https://femtos.xyz/elysium/nft-owned.md): ERC-721 tokens owned and ERC-1155 balances of one address.
- [Elysium · NFT transfers](https://femtos.xyz/elysium/nft-transfers.md): Transfers of a collection or one token, newest first.
- [Elysium · Blocks stream](https://femtos.xyz/elysium/ws-blocks.md): Each new Elysium block header, from our node.
- [Elysium · KOL leaderboard](https://femtos.xyz/elysium/kols.md): KOLs, traders and funds ranked by their Elysium swaps, transfers, bridge legs and holdings.
- [Elysium · KOL moves](https://femtos.xyz/elysium/kol-activity.md): The latest Elysium swaps and transfers of the named wallets, with who moved.
- [Elysium · KOL stream](https://femtos.xyz/elysium/ws-kols.md): Every Elysium swap, transfer and bridge leg of a named wallet, on each indexed block.
- [HyperCore · Markets](https://femtos.xyz/hypercore/markets.md): Every tradable perp, spot, HIP-3 and outcome market with 24 h stats.
- [HyperCore · Candles](https://femtos.xyz/hypercore/candles.md): OHLCV of any HyperCore market down to 1 s, ascending, UTC-aligned.
- [HyperCore · Forming candle](https://femtos.xyz/hypercore/ws-candles.md): The forming candle, pushed once per block where it changes.
- [HyperCore · Trades](https://femtos.xyz/hypercore/trades.md): Latest fills of one market, newest first.
- [HyperCore · Trades stream](https://femtos.xyz/hypercore/ws-trades.md): All trades of one market as they happen: raced between our node and Hyperliquid's public feed, first copy sent, the other dropped.
- [HyperCore · Best bid / offer](https://femtos.xyz/hypercore/ws-bbo.md): 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 book](https://femtos.xyz/hypercore/book.md): L2 book of one market with order counts, from our node.
- [HyperCore · Book stream](https://femtos.xyz/hypercore/ws-book.md): Full-depth book, then the levels each block changes.
- [HyperCore · Order updates](https://femtos.xyz/hypercore/ws-orders.md): Every order status change, filterable by coin, user and status.
- [HyperCore · HYPE price](https://femtos.xyz/hypercore/ws-prices.md): HYPE from the Hyperliquid oracle, perp mark and exchanges.
- [HyperCore · Liquidations](https://femtos.xyz/hypercore/liquidations.md): Perp liquidations, newest first, one row per account, coin and block.
- [HyperCore · Liquidation stats](https://femtos.xyz/hypercore/liquidation-stats.md): Totals, per coin, per time bucket and the largest, over a window.
- [HyperCore · Liquidations stream](https://femtos.xyz/hypercore/ws-liquidations.md): Each liquidation fill, the block it happens.
- [HyperCore · Positions](https://femtos.xyz/hypercore/positions.md): Open positions of one perp with leverage and liquidation price.
- [HyperCore · Open interest](https://femtos.xyz/hypercore/positions-overview.md): Open interest, accounts and unrealized PnL per perp.
- [HyperCore · Liquidation map](https://femtos.xyz/hypercore/liqmap.md): Notional that would be liquidated at each price around the mark.
- [HyperCore · Position changes](https://femtos.xyz/hypercore/ws-positions.md): Each perp position change, one per block, account and coin.
- [HyperCore · Token holders](https://femtos.xyz/hypercore/holders.md): Spot balances of a HyperCore token, largest first.
- [HyperCore · Perp holders](https://femtos.xyz/hypercore/holders-positions.md): Largest open positions of a perp, long and short.
- [HyperCore · Token registry](https://femtos.xyz/hypercore/coins.md): HyperCore tokens with their HyperEVM contract and price.
- [HyperCore · Coin detail](https://femtos.xyz/hypercore/coin.md): One token: its links across layers, the markets it trades on, its 5 largest holders.
- [HyperCore · Bridge transfers](https://femtos.xyz/hypercore/bridge.md): Matched HyperCore ↔ HyperEVM transfers with 24 h stats.
- [HyperCore · Bridge coverage](https://femtos.xyz/hypercore/bridge-coverage.md): 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 · Bridge stream](https://femtos.xyz/hypercore/ws-bridge.md): Each HyperCore ↔ HyperEVM transfer, initiated then completed.
- [HyperCore · Cross-layer wallet](https://femtos.xyz/hypercore/wallet.md): One address (or a named wallet's handle) on HyperCore, HyperEVM and Elysium, plus its latest events.
- [HyperCore · Wallet stream](https://femtos.xyz/hypercore/ws-wallet.md): Every event of the three layers touching one address.
- [HyperCore · Ledger stream](https://femtos.xyz/hypercore/ws-ledger.md): Deposits, withdrawals, transfers and other non-trade balance moves.
- [HyperCore · KOL leaderboard](https://femtos.xyz/hypercore/kols.md): KOLs, traders and funds ranked by their HyperCore PnL, volume and open positions.
- [HyperCore · KOL trades](https://femtos.xyz/hypercore/kol-activity.md): The latest fills of the named wallets, newest first, with who traded.
- [HyperCore · KOL stream](https://femtos.xyz/hypercore/ws-kols.md): Every fill, liquidation, EVM swap, transfer and bridge leg of a named wallet, live.
- [HyperCore · Named wallets](https://femtos.xyz/hypercore/entities.md): Every named entity, its X account, kinds, sources and wallets.
- [HyperCore · One entity](https://femtos.xyz/hypercore/entity.md): One named entity: its wallets on the three layers and 30 days of HyperCore trading.
- [HyperCore · POST /info](https://femtos.xyz/hypercore/info.md): Hyperliquid’s /info request bodies, answered from our node.
- [HyperCore · Hyperliquid WS](https://femtos.xyz/hypercore/hl-ws.md): Hyperliquid’s WebSocket subscriptions, served from our node.
- [HyperCore · Freshness](https://femtos.xyz/hypercore/status.md): Head and lag of each layer, measured now.
- [HyperCore · Stream stats](https://femtos.xyz/hypercore/ws-stats.md): Our HyperCore stream health, once a second.
- [HyperCore · Check your key](https://femtos.xyz/hypercore/whoami.md): Answers the name your key is registered under, its tier, billing state and the limits in force.
- [HyperCore · OpenAPI document](https://femtos.xyz/hypercore/openapi.md): The OpenAPI 3.1 contract of every REST call, public.
- [HyperEVM · LiquidLaunch launches](https://femtos.xyz/hyperevm/launches.md): Latest LiquidLaunch bonding-curve launches, newest first.
- [HyperEVM · Launches stream](https://femtos.xyz/hyperevm/ws-launches.md): One message per new LiquidLaunch launch, the moment its block is indexed.
- [HyperEVM · Launch detail & signals](https://femtos.xyz/hyperevm/signals.md): Metrics, dev wallet, early buyers and risk signals of one launch.
- [HyperEVM · Launch timeline](https://femtos.xyz/hyperevm/timeline.md): The whole life of a launch as ordered events with running state.
- [HyperEVM · Markets](https://femtos.xyz/hyperevm/markets.md): Active HyperEVM pools with 24 h stats.
- [HyperEVM · Candles](https://femtos.xyz/hyperevm/candles.md): OHLCV of one pool in pair price, USD and market cap, ascending, UTC-aligned.
- [HyperEVM · Forming candle](https://femtos.xyz/hyperevm/ws-candles.md): The forming candle, pushed once per block where it changes.
- [HyperEVM · Trades](https://femtos.xyz/hyperevm/trades.md): Latest swaps of one pool, newest first.
- [HyperEVM · Trades stream](https://femtos.xyz/hyperevm/ws-trades.md): The swaps of one pool, one message per block that has some.
- [HyperEVM · Holders](https://femtos.xyz/hyperevm/holders.md): Current balances of an ERC-20, largest first, with concentration.
- [HyperEVM · Token registry](https://femtos.xyz/hyperevm/coins.md): HyperEVM tokens with their HyperCore spot link and price.
- [HyperEVM · Coin detail](https://femtos.xyz/hyperevm/coin.md): One token: its links across layers, the markets it trades on, its 5 largest holders.
- [HyperEVM · Daily token volume](https://femtos.xyz/hyperevm/volume.md): USD swap volume of a token per UTC day, both sides of every priced swap.
- [HyperEVM · Token families](https://femtos.xyz/hyperevm/token-families.md): Tokens whose balance moves without Transfer logs: Aave aTokens and debt tokens, stHYPE, xStocks.
- [HyperEVM · Family token holders](https://femtos.xyz/hyperevm/token-family.md): Holders of one family token with balanceOf at the indexed head.
- [HyperEVM · Spam tokens](https://femtos.xyz/hyperevm/spam-tokens.md): Tokens the indexer flags as spam, left out of every list, and the latest flag changes.
- [HyperEVM · Active NFT collections](https://femtos.xyz/hyperevm/nft-collections.md): Collections with the most transfers over the last 1 h or 24 h.
- [HyperEVM · NFT collection](https://femtos.xyz/hyperevm/nft-collection.md): Metadata, tokens seen and 24 h activity of one collection.
- [HyperEVM · Collection tokens](https://femtos.xyz/hyperevm/nft-tokens.md): Tokens of a collection by id, with their owner and metadata URI.
- [HyperEVM · NFTs of a wallet](https://femtos.xyz/hyperevm/nft-owned.md): ERC-721 tokens owned and ERC-1155 balances of one address.
- [HyperEVM · NFT transfers](https://femtos.xyz/hyperevm/nft-transfers.md): Transfers of a collection or one token, newest first. While HyperEVM syncs: the last 24 h or 7 d of indexed blocks.
- [HyperEVM · Bridge transfers](https://femtos.xyz/hyperevm/bridge.md): HyperCore ↔ HyperEVM transfers (core_evm) or HyperEVM ↔ Elysium movements (evm_elysium), with 24 h stats.
- [HyperEVM · Bridge coverage](https://femtos.xyz/hyperevm/bridge-coverage.md): 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.
- [HyperEVM · Bridge stream](https://femtos.xyz/hyperevm/ws-bridge.md): Each HyperCore ↔ HyperEVM transfer, initiated then completed.
- [HyperEVM · Cross-layer wallet](https://femtos.xyz/hyperevm/wallet.md): One address (or a named wallet's handle) on HyperCore, HyperEVM and Elysium, plus its latest events.
- [HyperEVM · KOL leaderboard](https://femtos.xyz/hyperevm/kols.md): KOLs, traders and funds ranked by their HyperEVM swaps, transfers, bridge legs and holdings.
- [HyperEVM · KOL moves](https://femtos.xyz/hyperevm/kol-activity.md): The latest HyperEVM swaps and transfers of the named wallets, with who moved.
- [HyperEVM · KOL stream](https://femtos.xyz/hyperevm/ws-kols.md): Every HyperEVM swap, transfer and bridge leg of a named wallet, on each indexed block.