NestDaddy

Femtos

xyz.femtos/mcp · v1.2.1

Hyperliquid data on HyperCore, HyperEVM, Elysium: balances, prices, trades, token security, bridges

Connect Remote server

Terminal
claude mcp add --transport http mcp https://api.femtos.xyz/mcp --header "Authorization: Bearer <YOUR_API_KEY>"
~/.cursor/mcp.json
{
  "mcpServers": {
    "mcp": {
      "url": "https://api.femtos.xyz/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://api.femtos.xyz/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
Claude Desktop
Settings > Connectors > Add custom connector
URL: https://api.femtos.xyz/mcp

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools 80 found in our last check

  • get_status

    State of each layer (HyperCore, HyperEVM, Elysium): indexed head block and time, lag behind the chain, live or syncing, Elysium network (mainnet), HyperCore <> HyperEVM bridge matching coverage. Check it when an answer looks stale. Free.

  • list_markets

    Tradable markets of a layer, most traded first (24 h USD volume) unless sort says otherwise; HyperCore markets are sorted by the tool (GET /v1/markets without sort answers them in the venue's order). hypercore: perps, spot, HIP-3 dex perps (dex:COIN), outcome markets; `id` is th…

  • list_top_tokens

    The tokens of HyperEVM or Elysium with activity (a pool traded in the last 24 hours, or created in the last hour), one row per token over all its pools (not one per pool like list_markets): price, windows 5m / 1h / 6h / 24h (change, volume, trades, buys / sells, distinct traders…

  • get_candles

    OHLCV candles of one market, ascending, UTC-aligned. hypercore: market = coin (BTC, HYPE, @107 spot, xyz:TSLA), down to 1 s. hyperevm / elysium: market = pool key from list_markets; prices in quote plus `usd` and `mcap` OHLC (USD price and market cap). hypercore with includeUsd:…

  • get_trades

    Latest trades of a market, newest first. hypercore: fills of a coin (px, sz, side B = buyer aggressor / A, block time). hyperevm / elysium: DEX swaps of a pool (sender, amounts, px = pool price after the swap, USD value). Answer: an array of trades with only market / limit; one…

  • search_coins

    Tokens by symbol, name or address, with their links across layers (Elysium <-> HyperEVM <-> HyperCore), decimals, supply and USD price. Without layer: every layer. An exact address always answers its token (spam flagged).

  • get_coin

    One token: its links across layers, the markets it trades on (most traded first) and its 5 largest holders. hypercore: id = token name (HYPE), index or token id; hyperevm / elysium: id = 0x address. Price, FDV, liquidity and 5m–24h windows over all its pools: get_token_overview.

  • get_holders

    Largest holders of a token and its concentration (top-10 share…); system addresses (pools, bridges, launchpad, zero/dead) counted apart. hypercore: token = name (HYPE), kind = balances (spot) or positions (perp open interest of a coin); hyperevm / elysium: token = 0x address. Na…

  • get_holders_history

    How the number of holders of a HyperEVM or Elysium ERC-20 evolved: one point a UTC day (holders at the indexed head just after 00:00 UTC, system addresses such as pools, bridges and zero / dead left out, as get_holders totalHolders) and the count now. History from the layer's fi…

  • list_launches

    Latest token launches: Elysium (default) every launchpad, Ascend and every bonding curve inferred from its trades (launchpad name, curve progress, graduation to a DEX pool), or HyperEVM LiquidLaunch (launchpad = liquidlaunch). Each: token, the pool it trades in now (pair), creat…

  • list_launchpads

    Every launchpad of Elysium (default) or HyperEVM ranked by launches in 24 h (or by 24 h volume, graduations, all-time launches): launches 24h / 7d / all time, tokens on their curve, graduated and the graduation rate, the 24 h USD volume of its tokens, its top token, its latest l…

  • get_launchpad

    One launchpad of Elysium (default) or HyperEVM by name (ascend, obol, liquidlaunch… as list_launchpads names them) or contract: launches 24h / 7d / all time, on curve, graduated and the rate, 24 h volume, top token, and its launches and graduations per day over 30 days.

  • list_new_tokens

    Every ERC-20 created on HyperEVM or Elysium, newest first (not only launchpad launches): creation block / tx / time, creator, the contract it was deployed through, launchpad (ascend, liquidlaunch… or null = direct), first pool (dex, quote, initial liquidity) and, once a pool exi…

  • list_new_pools

    Every new pair / pool of every DEX on HyperEVM or Elysium (V2, V3, V4, PancakeSwap Infinity, LiquidLaunch curves…), newest first: dex, factory, fee tier, hooks, both tokens with symbols and whether each was just created (newToken), creation block / tx / time, initial liquidity,…

  • get_launch

    The story of one launched token: launch event, market cap, volume, holders, dev wallet and its funding, early buyers with flags, coordination signals, fees (exact from the launchpad ledger when indexed), lifecycle stage across layers and, for Ascend, progress toward the "Ascende…

  • get_launch_timeline

    Replayable life of a launch, oldest first: launch, swaps and transfers with the running holder count and market cap, graduation links (bridge to HyperEVM, HyperCore listing). Long histories are cut to fit (see `truncated`).

  • get_token_lifecycle

    One token from launch to perp across Elysium, HyperEVM and HyperCore: its address on each layer, the stages reached (Elysium launch, listing desk, HyperEVM mirror, HyperCore spot, perps) with chain evidence, and the links between them, each exact or inferred. address: an Elysium…

  • get_token_security

    Is this HyperEVM or Elysium ERC-20 safe to trade: a buy, a transfer and a sell simulated on our node through its most liquid pool (state overrides, nothing sent): canBuy, canSell, buy / sell / transfer tax, gas, revert reason; static checks of its code (owner and renounced, mint…

  • get_prices

    Current USD price of up to 100 tokens in one call, each with its source and provenance: hl_mid (HYPE / WHYPE: HyperCore spot mid; hl_oracle when no mid is recorded), hl_spot (HyperCore tokens and HyperEVM tokens linked to one: last trade of its USDC market), hl_perp, unit (USDC)…

  • get_price_history

    USD prices in the past. With at (Unix ms): the price of up to 100 tokens at that time (last observation at or before it). With from / to / interval: USD closes per unit (1m 5m 15m 1h 4h 1d) of up to 25 tokens, gap-filled. Same sources as get_prices. Windows over 30 days are bill…

  • get_tokens

    Metadata of up to 100 tokens: symbol, name, decimals, total supply, creator and creation time, logo, description and socials (website, X, Telegram, Discord, docs) with the source of each field and the X / Telegram handles in `profile` (issuer-provided, unverified text), token fa…

  • get_token_overview

    One token across all its pools on HyperEVM or Elysium (DexScreener style): USD price and source, FDV, market cap, liquidity, volume / trades / buys / sells / unique buyers, sellers and traders / price change over 5m, 1h, 6h, 24h, holders and top-10 share, pool count, the 5 best…

  • get_token_traders

    Who traded a HyperEVM or Elysium token over 1h, 6h, 24h or since launch (window=all), over all its pools or one (pool), and how they did, or one wallet's line (trader): per wallet buys / sells, amounts and USD bought / sold, average buy and sell price, current balance and supply…

  • get_bridges

    Bridge movements, newest first, with 24 h stats. route core_evm: HyperCore <> HyperEVM transfers, both legs matched (status, latency, how they were paired); route evm_elysium: HyperEVM <> Elysium (Orbit) deposits and withdrawals; route arb_core: deposits and withdrawals of the n…

  • get_wallet

    One address on HyperCore, HyperEVM and Elysium at once: HyperCore perp account (value, positions with liquidation price) and spot balances, HyperEVM and Elysium token balances and NFTs with USD values, bridge legs in flight and journeys across the layers, latest events (fills, l…

  • get_wallet_pnl

    One wallet's positions on HyperEVM or Elysium and how it did: per token balance, average cost, cost of what it holds, bought / sold amounts and USD, realized and unrealized PnL at the current price, first buy, last trade (pools=true: per pool too); totals for 1d / 7d / 30d / all…

  • get_wallet_lp_positions

    One wallet's liquidity positions on the DEXs followed position by position (HyperSwap V3 and V2 on HyperEVM): position NFTs, positions opened on a pool directly, LP tokens, and positions a vault holds for it (custody: delegated). Per position: pool, tokens, range (ticks), liquid…

  • get_wallet_value_history

    The USD value of one address on HyperEVM or Elysium over time: window 1d (5 min points), 7d (hourly), 30d or all (daily), then the head. Exact balances at each point (our archive node + the stored transfers), prices as get_price_history. Spam and unpriced tokens left out. Heavy…

  • get_balances

    What an address holds, one flat list: HyperCore spot tokens (live), HyperEVM and Elysium ERC-20s and native HYPE (indexed head), each with raw units, amount, USD price and value, largest first; spam tokens left out; HyperCore perp accounts (account value, withdrawable) apart in…

  • get_token_balance

    The balance of one token for one address: HyperCore coin name (USDC, HYPE…), or a HyperEVM / Elysium token address (`native` = HYPE; layer hyperevm unless elysium is given). 0 when not held. block / at for a past balance, verify to compare with the node.

  • get_token_volume

    Daily USD swap volume of an EVM token (both sides of every priced swap), oldest first, up to the indexed head (the last day is partial).

  • get_erc20_transfers

    ERC-20 Transfer events, newest first (from, to, amount, block, tx). address: the transfers sent / received by a wallet (direction in, out or any), optionally of one token, in a window (from / to, Unix ms) or above minUsd (amount × current token price); each row with token, symbo…

  • get_pool

    One DEX pool of HyperEVM or Elysium: dex, factory, fee tier, hooks, tokens with USD prices, creation block / tx, price, liquidity with its USD value and how it is measured (pool balances for V2 / V3; for V4 / Infinity pools what their positions hold at the current price), depth…

  • list_pool_metrics

    The pools of a DEX with their numbers (HyperSwap V3 and V2 on HyperEVM): what each pool holds and its USD value (TVL), and over 24h, 7d and 30d its swaps, volume, fees paid, the liquidity providers' and the protocol's parts, and its fee APR (LP fees over the tokens held through…

  • get_pool_metrics_history

    One pool's metrics over time (HyperSwap V3 and V2 on HyperEVM): per hour or per UTC day its swaps, volume, fees paid, the liquidity providers' and the protocol's parts (USD at each swap's own price), the tokens it held at the end of the unit (raw units: divide by 10^decimals) wi…

  • get_wallet_mev

    Every sandwich (MEV) of a wallet's Elysium swaps, newest first: the bot, its front-run and back-run transactions, the pool and tokens, what the victim paid and got, its loss in USD; with the totals (sandwiches, USD lost, USD of the swaps hit). strict = front-run in the victim's…

  • list_sandwiches

    Sandwich attacks found on Elysium, newest first, one row per victim swap: confidence (strict / probable), the victim and the bot, the pool and tokens, front-run / victim / back-run transactions and blocks, what the victim paid and lost in USD, the bot's profit, tips. Filters: vi…

  • get_mev_stats

    MEV on Elysium over 24h, 7d, 30d or all: sandwiches (count, USD taken, victims, bots, USD of the swaps hit), cyclic arbitrage (txs, profit USD), an hourly or daily series, and the top bots, pools and routers hit.

  • list_mev_bots

    The sandwich bots of Elysium over 24h, 7d, 30d or all, most USD taken first: contracts, first / last seen, sandwiches, USD taken, victims, pools, median tip (wei).

  • get_mev_bot

    One Elysium sandwich bot over all its sandwiches: its contracts, first / last seen, sandwiches, USD taken, distinct victims and pools, median tip (wei). Its sandwiches: list_sandwiches with bot.

  • get_transaction

    One transaction by hash, HyperEVM then Elysium (or layer): status, block, from / to, value, gas and fee (HYPE and USD), decoded ERC-20 transfers, swaps, liquidity events, pools created and NFT transfers, the raw logs we do not decode (from our node), and when it is a bridge leg…

  • get_gas

    HyperEVM or Elysium gas over 1h, 6h, 24h or 7d: each block's base fee, gas used and limit, transactions and priority fees (p50 / p90 tips), HyperEVM small and big blocks as two series (each has its own base fee). Stats per series (base fee min / median / p90 / p99 / max / mean,…

  • get_chain_activity

    HyperEVM or Elysium activity per bucket (1m, 15m, 1h or 1d), oldest first: user transactions, distinct wallets and new wallets, contracts created, fees in HYPE, swaps, traders, volume in USD, launches, ERC-20s created, and deposits bridged in from the parent chain (count, deposi…

  • get_block

    One HyperEVM or Elysium block (a number, or latest): hash, time, small or big block (HyperEVM), gas, base fee, tips, HYPE burnt and fees, and every transaction in order with sender, recipient (named wallets tagged), HYPE sent, function called, status, gas, tip, fee and its decod…

  • elysium_rpc

    One JSON-RPC call on our Elysium mainnet (chain 99901) node, free: eth_chainId, eth_blockNumber, net_version, net_listening, web3_clientVersion, eth_syncing, eth_getBlockByNumber, eth_getBlockByHash, eth_getBlockTransactionCountByNumber, eth_getBlockTransactionCountByHash, eth_g…

  • hyperevm_rpc

    One JSON-RPC call on our HyperEVM (chain 999) node, free: eth_chainId, eth_blockNumber, net_version, net_listening, web3_clientVersion, eth_syncing, eth_getBlockByNumber, eth_getBlockByHash, eth_getBlockTransactionCountByNumber, eth_getBlockTransactionCountByHash, eth_getTransac…

  • get_transaction_status

    Where one transaction is on HyperEVM or Elysium (layer): pending with the upstreams that accepted it, included (block, index, success or reverted), replaced (the hash that took its nonce) or dropped, for a transaction sent through hyperevm_rpc / elysium_rpc or POST /v1/<layer>/r…

  • list_sent_transactions

    The transactions this account sent through hyperevm_rpc / elysium_rpc or POST /v1/<layer>/rpc in the last 24 hours (layer; from: up to 10 sender addresses), newest first, each pending (with the upstreams that accepted it), included, replaced or dropped. Never another account's.

  • get_book

    Live L2 order book of one HyperCore market from our own node: bids and asks best first as [px, sz, n] (price, size, order count), and the block it was read at. coin: perp name (BTC), spot @index (@107) or HIP-3 dex:COIN. depth 1: the best bid and offer (BBO) only.

  • get_walls

    Which HyperCore accounts' order book walls hold: per account, its large resting orders placed away from the price (≥ $25k, ≥ 20 bps away), how many the price came to, how many held (filled) and how many were pulled as the price came, with the hold rate. A low hold rate over many…

  • get_wall_events

    One HyperCore market's large resting orders that the price came to, one by one, newest first: held (filled) or pulled (cancelled as the price came), with time, price, size, value, life and owner. A wall: a resting limit order (Gtc or Alo, not a trigger) worth at least $25k, plac…

  • get_open_interest

    Open interest of a HyperCore perp over time (bars of 1s to 1M since 2023-05-20, 1s and 15s since 2025-09-28): open / high / low / close of the open interest (size, Σ |position| of longs and shorts), its value at the last price, longs and shorts opened and closed in each bar, the…

  • list_open_interest

    Open interest of every HyperCore perp now (main dex and HIP-3): size and USD value, accounts long and short, change over 1 h, 24 h and 7 d, totals per perp dex. Sort by value, size, 24 h change or accounts. Exact, from every fill and hourly funding.

  • get_open_interest_cohorts

    Who holds a HyperCore perp's open interest, every hour since 2025-09-28: long and short size and accounts by position size tier (0 = no trade price known, 1 = under $10k, 2 = $10k–100k, 3 = $100k–1M, 4 = $1M–10M, 5 = $10M and more), and the share of the 10 largest longs and shor…

  • get_open_interest_opens

    Who opened positions on a HyperCore perp in a window of up to a day (since 2025-03-22 10:49 UTC): the orders that opened longs or shorts, largest value first, with the account and its named wallet, size and value opened, average price, taker or resting, position before and after…

  • get_liquidations

    HyperCore perp liquidations, newest first: one row per account, coin and block (side of the liquidated position, market or backstop, size, notional, average and mark price). Default window: the last 24 h; `from` older than 7 days (30 with a coin) is clamped, the answer's `from`…

  • get_liquidation_stats

    HyperCore liquidations over a window (1h, 24h, 7d, 30d), every perp or one coin: totals (notional, count, accounts, long / short, market / backstop), per coin, per time bucket, the most liquidated accounts and the largest events.

  • get_positions

    Open positions of one HyperCore perp, current to a few seconds (the node state rolled forward with every fill, funding payment, ledger update and accepted account action): account, size, side, entry price, notional, unrealized PnL at the mark, leverage, margin mode and liquidati…

  • get_position_changes

    Past HyperCore perp position changes of one coin over a notional (at least 10000), one row per account and block (opens, closes, increases, reductions, flips, with size, average price and whether a liquidation moved it): the history of the WS hc.positions channel, the rows behin…

  • get_position_flow

    Large HyperCore perp position moves and liquidations of one coin summed per bar of a unit (1m to 1d, 1w, 1M): buys, sells, longs liquidated, shorts liquidated, each with notional, count, volume-weighted price and the largest move (named wallet when known). The figures add up acr…

  • get_stop_map

    Open trigger orders (stop-loss and take-profit) of one HyperCore market bucketed by trigger price around the mark (default ±10 %, 20 round-width buckets): per bucket the count, size and notional (size × trigger price) of stops and take-profits, sell (closes longs) and buy (close…

  • get_liquidation_map

    Liquidation prices of the open perp positions of one HyperCore market, bucketed by price around the mark: per bucket the longs (liquidated by a forced sell as price falls to them) and the shorts (forced buy), count, |size| and |size| × liquidation price. Real per-position prices…

  • get_forced_flow

    Open stop-loss / take-profit orders and the liquidation prices of open positions of one HyperCore market on the same price buckets: per bucket the stops by kind and side (each at what it would execute: a reduce-only order at most what is left of its wallet's position, the rest u…

  • get_triggered_stops

    Stop-loss and take-profit orders of one HyperCore market that fired, newest first: wallet, side, trigger and limit price, size (0 = whole position), the order the trigger placed (its status in the trigger block) and its fills there (size, average price, notional). Window: since…

  • get_wallet_stops

    A wallet's open HyperCore trigger orders (stop-loss / take-profit): coin, side, trigger and limit price, size (0 = whole position), reduce-only, placed at. history: true lists instead every status event of its trigger orders over the last 3 days at most (placed, triggered, cance…

  • get_price_level

    The wallets behind one price band of a HyperCore market (a bucket of get_forced_flow / get_stop_map / get_liquidation_map: px_lo = its pxLo, px_hi = its pxHi): the open stop-loss / take-profit orders triggering in it, each with what it would execute (a reduce-only order at most…

  • get_hypercore_account

    The HyperCore account of an address (or a named wallet's handle), read from our node at most 2 s ago: perp account value, margin used and withdrawable, each position (size, entry and liquidation price, leverage, unrealized PnL, cumulative funding with Hyperliquid's sign: positiv…

  • get_wallet_open_orders

    A wallet's open HyperCore orders now (our node, at most 1 s old): resting limit orders and trigger orders (stop-loss / take-profit) on the main dex and every HIP-3 dex, each with coin, side, kind, limit and trigger price, size left and placed (0 = whole position), reduce-only, t…

  • get_wallet_fills

    A wallet's HyperCore fills, newest first: market, side, price, size, notional, direction (Open Long, Close Short…), closed PnL, fee, builder fee, oid, tid, hash, the position before the fill, and whether it is a liquidation of the wallet. coin: one market; from / to: a window in…

  • get_wallet_order_history

    A wallet's HyperCore orders that left the book (filled, canceled, rejected), newest first: market, side, kind, limit and trigger price, size placed, filled and left, average fill price, the last status with Hyperliquid's reason (marginCanceled, reduceOnlyRejected…) and its time.…

  • get_wallet_fill_bars

    A wallet's fills on one HyperCore market summed per bar of a unit (1m to 1d, 1w, 1M): per bar its buys and sells (count, size, notional, average price, closed PnL, fees), its position on the coin after the bar and whether it was liquidated in it. Only the bars with a fill. Windo…

  • get_wallet_funding

    A wallet's HyperCore funding payments, newest first: per perp and hour the amount in USDC (negative = paid by the wallet, positive = received), its position and the funding rate. coin: one perp; from / to: a window in Unix ms (default everything up to now). History from 2025-09-…

  • get_hypercore_wallet_pnl

    The HyperCore PnL curve of any address (or a named wallet's handle): per hour or day, realized PnL, fees, funding, net and cumulative net, plus the perp account value at each bucket's end and the net transfers in it, over 7d, 30d, 90d or all history. Account values are walked ba…

  • get_twaps

    Running HyperCore TWAP orders of a market (coin) and / or an account (user), every market when neither is given: side, size, executed size and notional, average price, remaining size and notional at the last trade, progress, start and scheduled end, trigger, status; and per mark…

  • get_twap_history

    HyperCore TWAP orders that ended (finished, terminated, or error with its reason) in a window, newest first, by market (coin) and / or account (user): size, executed size and notional, average price, what was left undone, start, scheduled end, when and how it ended. Window from…

  • get_predicted_funding

    Predicted hourly funding rate of the running hour for HyperCore perps, main dex and HIP-3 dexes (coin: one perp, dex: one dex, neither: every perp): the rate that will be paid at nextFundingTime if the hour ended now (Hyperliquid's own), the average premium it stands for (null w…

  • list_nft_collections

    Most active NFT collections of an EVM layer over the last 1 h or 24 h before the indexed head: transfers, mints, burns, with each collection's name, symbol, standard and logo.

  • get_nft_collection

    One NFT collection of an EVM layer: metadata, standards, token ids seen (counted up to 1,000), transfers / mints / burns over the 24 h before the indexed head.

  • get_nft_tokens

    Tokens of one collection by token id, ascending: current ERC-721 owner (null for ERC-1155), metadata URI, image URL. Next page: pass `next_cursor` as cursor.

  • get_nfts_owned

    NFTs an address holds on an EVM layer at the indexed head: ERC-721 tokens and ERC-1155 balances, counted per collection, the tokens listed up to limit.

Headers

NameDescription
Authorization
Required, secret
Bearer <your Femtos API key>. Free, no browser needed: https://femtos.xyz/agents.md#agent-onboarding

Details

Endpointhttps://api.femtos.xyz/mcp (Streamable HTTP)
First published10 Nov 2026
Last updated10 Nov 2026
Registry namexyz.femtos/mcp

More security servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.