API reference, Market data

MEV stats

What bots took on Elysium over a window: sandwiches, victims, arbitrage, top bots, pools and routers.

  • Elysium
  • HyperCore: not served
  • HyperEVM: not served
  • Not on HyperCore: HyperCore trades on its order book, not on pools: no pool swap to sandwich there
  • Not on HyperEVM: MEV is detected on Elysium first: HyperEVM next, with the same answers

GET https://api.femtos.xyz/v1/mev/stats

Parameters

ParamInExample or valuesMeaning
layerqueryelysiumLayer (elysium; hyperevm later)
windowquery(empty), 24h, 7d, 30d, all24h, 7d, 30d, or all (from block 1)
confidencequery(empty), strict, probable, surestrict or probable: that shape only; sure: strict, or by a known sandwich bot (the `sure` rows); absent: all

Example

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/mev/stats?layer=elysium&window=7d"

Key: Authorization: Bearer $FEMTOS_KEY. Get a free key, or with no browser through agent onboarding.

Response fields

FieldTypeMeaning
totalobjectSandwiches of the window: {sandwiches, takenUsd, victims, bots, victimUsd, medianLossPct}
arbitrageobjectCyclic arbitrage of the window: {txs, profitUsd}
series[]objectHourly up to 7d, daily beyond; oldest first: {t, sandwiches, takenUsd, arbitrageUsd}
bots[]objectTop 10 by USD taken: {bot, entity, sandwiches, takenUsd, victims}
pools[]objectTop 10 by USD taken: {pool, protocol, token0, token1, sandwiches, takenUsd}
routers[]objectTop 10 by sandwiches: {router, entity, sandwiches, takenUsd, victims}

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.
  • Walls on the book WS hc.book.walls HyperCore
    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.
  • 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.
  • Sandwiches GET /v1/mev/sandwiches Elysium
    Every sandwich on Elysium, newest first: the victim, the bot, the pool, the USD lost.
  • Sandwich stream WS elysium.mev Elysium
    Each sandwich (MEV) on Elysium pools, the moment its back-run is indexed.
  • Sandwich bots GET /v1/mev/bots Elysium
    The sandwich bots of Elysium, most USD taken first.
  • Sandwich bot GET /v1/mev/bots/{address} Elysium
    One sandwich bot of Elysium: what it took, from whom, where.

More

Agent guide (agents.md)llms.txtOpenAPIMCP serverGet an API keyChangelog