HyperEVM · Market data

Pool detail

One pool: dex, fee, tokens, liquidity in USD, depth, 5m to 24h activity, top LPs.

GET https://api.femtos.xyz/v1/pools/{address}

Parameters

Param	In	Example or values
`address`	path	`<evmPair>`
`layer`	query	`hyperevm`

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/pools/<evmPair>?layer=hyperevm"

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

Field	Type	Meaning
`dex`	string	Protocol
`factory`	string	Factory / PoolManager
`feeTier`	int \| null	Fee tier (hundredths of a bip: 500 = 0.05 %)
`tickSpacing`	int \| null	Tick spacing
`hooks`	string \| null	V4 / Infinity hooks contract
`token0`	object	token0: {address, symbol, name, decimals, priceUsd, spam, spamReason}
`token1`	object	token1: {address, symbol, name, decimals, priceUsd, spam, spamReason}
`liquidity`	object \| null	What the pool holds; null when unknown (a vault pool without L, e.g. Balancer): {method, exact, amount0, amount1, amount0Raw, amount1Raw, usd, partial, at, block}
`depth2pct`	object \| null	Concentrated pools: depth to ±2 % from L and √P: {approx, up, down, liquidity, sqrtPriceX96, block}
`windows`	object	From the candle tables: 5m / 1h from 1 min candles, 6h from 5 min, 24h from 1 h; a window starts at its first candle at or after head − length: {5m, 1h, 6h, 24h}
`topLps[]`	object \| null	V2-style pools with at most 2000 LP holders: the 10 largest: {address, balanceRaw, share, burned}
`lpHolders`	int \| string \| null	V2-style pools: holders of the LP token (">2000" when more); null otherwise
`block`	int	Creation block (provenance)
`tx`	string \| null	Creation transaction (pool-created event in that block)
`lastSwap`	object \| null	The pool's last swap (provenance of the state): {block, t, tx, logIndex}

Markets GET /v1/markets
Active HyperEVM pools with 24 h stats.
Candles GET /v1/candles
OHLCV of one pool in pair price, USD and market cap, ascending, UTC-aligned.
Forming candle WS hyperevm.candles
The forming candle, pushed once per block where it changes.
Trades GET /v1/trades
Latest swaps of one pool, newest first.
Trades stream WS hyperevm.trades
The swaps of one pool, one message per block that has some.
Swaps by wallet GET /v1/trades
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
ERC-20 transfers sent and received by a wallet, newest first, filterable by token, direction, size and time.
Transaction GET /v1/tx/{hash}
One transaction: status, gas, decoded transfers, swaps and liquidity, bridge legs and journey.
Token prices GET /v1/prices
USD price of up to 100 tokens in one call, each with its source and provenance.
Price history 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=).
Token candles GET /v1/candles
OHLCV of a token in USD through its reference pool, the most liquid one.