HyperEVM · Market data

Token candles

OHLCV of a token in USD through its reference pool, the most liquid one.

GET https://api.femtos.xyz/v1/candles

Parameters

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/candles?layer=hyperevm&token=<evmToken>&tf=1h&limit=48"

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

Field	Type	Meaning
`market`	string	Market (token form: the reference pool / USDC market)
`reference`	object	token form, EVM: the reference pool (PoolRef) and its rule
`unit`	usd \| usdc	token form: what o/h/l/c are in
`candles[]`	object	Ascending: {t, o, h, l, c, v, vq, n, vUsd, mcUsd, usd, mcap, …}
`candles[].o`	decimal	Open, in the quote (HyperCore: USDC; EVM pools: the quote token; token form: USD)
`candles[].buys`	int	token form (EVM): swaps buying the token
`candles[].mcap`	object	Same candle as market cap in USD {o,h,l,c} (Elysium, HyperEVM): {o, h, l, c}
`asOf`	ms	Time of `height` (HyperCore: ingested head; EVM: indexed head, committed with the candles)
`height`	int	Head block of the layer the answer is cut at: every event up to it is counted (HyperCore: ingested head; EVM: indexed head, committed with the candles)
`billing`	heavy	heavy over 30 days

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.
Pool detail GET /v1/pools/{address}
One pool: dex, fee, tokens, liquidity in USD, depth, 5m to 24h activity, top LPs.
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=).