Event Stream

Live event stream (SSE)

Real-time market events over Server-Sent Events: liquidations (OKX, Bybit, Hyperliquid; $250+), $1M+ CEX whale transfers, Hyperliquid top-trader position changes ($25K+), and funding moves, open-interest moves and 1-minute price moves (0.10%+, perps trading $1M+/day) for every Hyperliquid perp.

Each message's data is one JSON event: id, ts (event time, ms), recv_ts (when we saw it, ms), type, venue, symbol, plus type fields: liquidation side (the LIQUIDATED position side) + usd (+ px, sz on Hyperliquid); whale_transfer exchange, chain, direction (inflow/outflow), amount, usd; whale_position action (entry/exit/increase/decrease), side, size, usd (notional of the change at entry price), address, change_pct; funding rate_1h, prev_rate_1h, settle (true = the hourly settlement print); oi_delta usd (signed change), pct, window_s (~60 = minute move, ~300 = 5-minute jump), oi_usd; price_move pct, price, prev_price, window_s.

Pro and Pro Plus. Free keys: /stream/recent (JSON, any key) or the keyless /stream/delayed preview. Up to 3 concurrent streams per key.

get/api/v1/stream

Request

  • Base URL: https://cryptodataapi.com
  • URL: https://cryptodataapi.com/api/v1/stream
  • Auth: API key in header X-API-Key

Query parameters

typesstring nullable

Comma-separated event types: liquidation, whale_transfer, whale_position, funding, oi_delta, price_move. Default: all.

symbolsstring nullable

Comma-separated base coins (BTC,ETH,SOL). Default: all.

min_usdnumber

Drop events smaller than this USD size. Applies to events that carry usd (liquidation, whale_transfer, whale_position, oi_delta); funding and price_move always pass.

since_idinteger nullable

Replay buffered events after this id before going live (~2h ring). The Last-Event-ID header does the same and wins when both are sent.

Response

Server-Sent Events. One JSON event per data: line, id: set for resume; : ping comments every 15s.

Changes

No recorded changes to this operation across all 1 revision of this API.