Choosing Your Subscription

Every WebSocket connection starts with a subscribe message. The filters you choose determine which events you receive.

By use case

Whale tracking

See every order placed on HyperLiquid. Filter client-side by notional size.

{"action": "subscribe", "filters": {"action_types": ["order"]}}

The umbrella type "order" matches: order, order_filled, order_canceled, order_rejected. Volume: ~2,000 events/sec across all assets.

Track a specific wallet

{"action": "subscribe", "filters": {"addresses": ["0xd071d6d6ea52f5aa34b79e47f908ee48c8215837"]}}

Copy trading

{
  "action": "subscribe",
  "filters": {
    "addresses": ["0xd071d6d6ea52f5aa34b79e47f908ee48c8215837"],
    "action_types": ["fill"]
  }
}

Market making signals

Pre-consensus cancels and modifications tell you the order book is about to change.

{
  "action": "subscribe",
  "filters": {
    "action_types": ["cancel", "cancelByCloid", "batchModify"],
    "assets": ["BTC"]
  }
}

All activity on one asset

{"action": "subscribe", "filters": {"assets": ["BTC"]}}

Liquidation monitoring

{"action": "subscribe", "filters": {"action_types": ["order"]}}

Filter client-side for event.type === "order_rejected" and check event.data.status for margin rejections.

Prediction markets

{"action": "subscribe", "filters": {"assets": ["#39890"]}}

Full firehose

{"action": "subscribe"}

~6,500 events/sec.

Multiple subscriptions

You can send multiple subscribe messages on one connection. Each creates a separate subscription. Events matching any subscription are delivered.

ws.send(JSON.stringify({
  action: "subscribe",
  filters: {assets: ["BTC"], action_types: ["fill"]}
}));

ws.send(JSON.stringify({
  action: "subscribe",
  filters: {addresses: ["0xabc..."]}
}));

Unsubscribe

{"action": "unsubscribe", "filters": {"assets": ["BTC"], "action_types": ["fill"]}}

Quick reference

Goal	Filters
Track a wallet (all activity)	addresses only
Track a wallet (trades only)	addresses + action_types: fill
Track an asset (orders + fills)	assets + action_types: order, fill
Early cancel signal	assets + action_types: cancel, batchModify
Liquidation signals	action_types: order, filter client-side
Prediction markets	assets with # prefix
Everything (firehose)	no filters

Getting Started

Understanding the Stream

Building with hypernode

Examples

Choosing Your Subscription

By use case

Whale tracking

Track a specific wallet

Copy trading

Market making signals

All activity on one asset

Liquidation monitoring

Prediction markets

Full firehose

Multiple subscriptions

Unsubscribe

Quick reference

​By use case

​Whale tracking

​Track a specific wallet

​Copy trading

​Market making signals

​All activity on one asset

​Liquidation monitoring

​Prediction markets

​Full firehose

​Multiple subscriptions

​Unsubscribe

​Quick reference

By use case

Whale tracking

Track a specific wallet

Copy trading

Market making signals

All activity on one asset

Liquidation monitoring

Prediction markets

Full firehose

Multiple subscriptions

Unsubscribe

Quick reference