femtos

HyperCore · Market data

Trades stream

All trades of one market as they happen: raced between our node and Hyperliquid's public feed, first copy sent, the other dropped.

WebSocket channel hc.trades on wss://api.femtos.xyz/v1/ws

Parameters

ParamInExample or values
coinfilterBTC

Subscribe

{"op":"subscribe","channel":"hc.trades","filter":{"coin":"BTC"}}

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

Response fields

FieldTypeMeaning
snapshot: trueTrade[]last 50 trades at subscribe
dataTrade[]the new trades: {t, px, sz, side, tid, hash, users, block}
tidinttrade id, unique: dedupe on it
users[buyer, seller]both sides, lowercase 0x
hashstringtransaction hash (all zeros when the public feed gives none)
blockint | nullnull when the public feed was first; our node fills it in the snapshots
latency_ms.source_to_sentinttrade time → sent by the server

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.
  • 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