femtos

HyperCore · Market data

Token candles

OHLCV of a token through its USDC market (a perp coin: the perp).

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

Parameters

ParamInExample or values
layerqueryhypercore
tokenqueryHYPE
tfquery1s, 15s, 1m, 5m, 15m, 1h, 4h, 1d
limitquery48

Example

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

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

Response fields

FieldTypeMeaning
marketstringMarket (token form: the reference pool / USDC market)
unitusd | usdctoken form: what o/h/l/c are in
candles[]objectAscending: {t, o, h, l, c, v, vq, n, vUsd, mcUsd, usd, mcap, …}
candles[].odecimalOpen, in the quote (HyperCore: USDC; EVM pools: the quote token; token form: USD)
candles[].nintTrades
billingheavyheavy over 30 days

Related: Market data

  • Markets GET /v1/markets
    Every tradable perp, spot, HIP-3 and outcome market with 24 h stats.
  • Candles GET /v1/candles
    OHLCV of any HyperCore market down to 1 s, ascending, UTC-aligned.
  • 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.
  • 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 metadata GET /v1/tokens
    Metadata of up to 100 tokens: supply, creator, logo and socials when indexed, family, spam. Also POST with a JSON body.

More