femtos

HyperCore · Market data

Candles

OHLCV of any HyperCore market down to 1 s, ascending, UTC-aligned.

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

Parameters

ParamInExample or values
layerqueryhypercore
marketqueryBTC
tfquery1s, 15s, 1m, 5m, 15m, 1h, 4h, 1d
limitquery180

Example

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/candles?layer=hypercore&market=BTC&tf=1m&limit=180"

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; backstop liquidations excluded
v · vqdecimalvolume in base, in quote
ninttrades in the unit
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
    Every tradable perp, spot, HIP-3 and outcome market with 24 h stats.
  • Forming candle WS hc.candles
    The forming candle, pushed once per block where it changes.
  • Trades GET /v1/trades
    Latest fills of one market, newest first.
  • Trades stream WS hc.trades
    All trades of one market as they happen: raced between our node and Hyperliquid's public feed, first copy sent, the other dropped.
  • Best bid / offer WS hc.bbo
    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).
  • Order book GET /v1/book
    L2 book of one market with order counts, from our node.
  • Book stream WS hc.book
    Full-depth book, then the levels each block changes.
  • Order updates WS hc.orders
    Every order status change, filterable by coin, user and status.
  • HYPE price WS prices.hype
    HYPE from the Hyperliquid oracle, perp mark and exchanges.

More