femtos

HyperEVM · Market data

Candles

OHLCV of one pool in pair price, USD and market cap, ascending, UTC-aligned.

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

Parameters

ParamInExample or values
layerqueryhyperevm
marketquery<evmPair>
tfquery1s, 15s, 1m, 5m, 15m, 1h, 4h, 1d
limitquery288

Example

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/candles?layer=hyperevm&market=<evmPair>&tf=5m&limit=288"

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

Response fields

FieldTypeMeaning
tintunit start (ms)
o · h · l · cdecimalprice in the quote token
usd {o,h,l,c}decimalsame candle in USD
mcap {o,h,l,c}decimalsame candle as market cap, USD
v · vqdecimalvolume in token, in quote
nintswaps in the unit
vUsddecimal | nullvolume in USD
mcUsddecimalmarket cap at close; absent on filled candles
from · to · fillquerywindow (ms) and flat candles for empty units (fill=1, default)
asOf · heightinthead the answer is cut at: every trade up to that block counted

Related: Market data

  • Markets GET /v1/markets
    Active HyperEVM pools with 24 h stats.
  • 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.

More