Stream Quickstart

1. Get an API key

Sign up at polynode.dev to get an API key. Keys are prefixed with pn_live_. If you already have a polynode account on the Growth plan ($200/mo) or above, your existing key works on hypernode automatically.

2. Connect

wscat -c "wss://hyper.polynode.dev/ws?key=pn_live_YOUR_KEY"

Send a subscribe message to start receiving events:

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

You’ll immediately start receiving every new order and fill on HyperLiquid:

{"type":"order","consensus":"confirmed","asset":"BTC","user":"0x9e74a6a1...",
 "data":{"coin":"BTC","side":"B","px":"74400.0","sz":"0.20146","oid":380660788366,"tif":"Alo"}}

{"type":"fill","consensus":"confirmed","asset":"HYPE","user":"0x34827044...",
 "data":{"coin":"HYPE","side":"A","px":"22.608","sz":"442.0","dir":"Close Short","closedPnl":"0.92"}}

Common subscriptions

All orders and fills (recommended starting point):

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

Only BTC activity:

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

Track a specific wallet across all markets:

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

Pre-consensus cancels only (early signal):

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

Full firehose (everything, ~6,500 events/sec):

{"action": "subscribe"}

TypeScript

import WebSocket from "ws";

const ws = new WebSocket("wss://hyper.polynode.dev/ws?key=pn_live_YOUR_KEY");

ws.on("open", () => {
  ws.send(JSON.stringify({
    action: "subscribe",
    filters: { action_types: ["order", "fill"] }
  }));
});

ws.on("message", (raw) => {
  const event = JSON.parse(raw.toString());

  if (event.type === "fill") {
    console.log(`FILL: ${event.asset} ${event.data.side === "B" ? "BUY" : "SELL"} ${event.data.sz}@${event.data.px}`);
    console.log(`  PnL: ${event.data.closedPnl} | Fee: ${event.data.fee} ${event.data.feeToken}`);
  }

  if (event.type === "order") {
    console.log(`ORDER: ${event.asset} ${event.data.side === "B" ? "BUY" : "SELL"} ${event.data.sz}@${event.data.px} [${event.data.tif}]`);
  }
});

Python

import json
import websocket

def on_message(ws, message):
    event = json.loads(message)
    if "action" in event:
        return  # subscription ack

    if event["type"] == "fill":
        d = event["data"]
        print(f"FILL: {event['asset']} {d['sz']}@{d['px']} {d['dir']} PnL={d['closedPnl']}")

    if event["type"] == "order":
        d = event["data"]
        print(f"ORDER: {event['asset']} {d['side']} {d['sz']}@{d['px']} [{d['tif']}]")

def on_open(ws):
    ws.send(json.dumps({
        "action": "subscribe",
        "filters": {"action_types": ["order", "fill"]}
    }))

ws = websocket.WebSocketApp(
    "wss://hyper.polynode.dev/ws?key=pn_live_YOUR_KEY",
    on_open=on_open,
    on_message=on_message,
)
ws.run_forever()

Next steps

Event Format — all fields and event types
Filters — narrow the stream to exactly what you need
Authentication — API key tiers and limits
Exchange API — REST endpoints for trading and market data

Getting Started

Understanding the Stream

Building with hypernode

Examples

1. Get an API key

2. Connect

Common subscriptions

TypeScript

Python

Next steps

​1. Get an API key

​2. Connect

​3. Subscribe

​Common subscriptions

​TypeScript

​Python

​Next steps

1. Get an API key

2. Connect

3. Subscribe

Common subscriptions

TypeScript

Python

Next steps