Institutional WebSocket API
Zero-polling raw JSON stream for algorithmic trading bots and high-frequency trading (HFT) models. Stream high-conviction liquidation cascades, CVD divergences, and order book absorption in real time.
Whale Core B2B WebSocket API is an institutional market data pipeline that connects directly to Binance Futures WebSocket nodes. It computes statistical anomalies (Volume Sigma, CVD divergence, Open Interest shift, spoofing) in memory using Python asyncio and pushes structured JSON payloads to algorithmic clients in under 5 milliseconds with zero rate-limit dropouts.
Broadcast directly from Redis memory pub/sub to open sockets.
Continuous live monitoring across all liquid Binance USDT-M markets.
Instantaneous delivery for BTC, ETH, and SOL without throttling.
Standard WebSocket protocol with native ping/pong heartbeat.
Architecture Comparison: WebSocket vs Exchange REST Polling
Why institutional trading desks choose Whale Core over generic exchange REST endpoints:
| Capability | Exchange REST APIs (Generic) | Whale Core WebSocket Stream |
|---|---|---|
| Delivery Latency | 1,000 ms – 5,000 ms (Polling delay) | < 5 ms (Real-time push) |
| Data Enrichment | Raw fills only (unfiltered trades) | Enriched: 1m/5m/15m CVD + OI Δ + Verdict |
| Anomaly Detection | Manual calculation required | Built-in: Cascades, Spoofing, Absorption |
| Connection Model | Hundreds of HTTP requests/minute | Single persistent bi-directional socket |
| Rate-Limit Risk | Frequent 429 Too Many Requests / IP bans | Zero dropouts (Native ping/pong heartbeat) |
Live Event Payload Specification
Every filtered anomaly pushed to your connection carries complete order flow context.
{
"type": "LIQ_CASCADE",
"symbol": "BTCUSDT",
"side": "Sell",
"price": 78500.0,
"impact": 1250000.0,
"timestamp": 1741684800.12,
"verdict_state": "Deleveraging",
"impact_pct": 0.2,
"cvd_1m": -127010000.0,
"cvd_5m": -123420000.0,
"cvd_15m": -125980000.0,
"oi_delta_pct": 0.06,
"funding_rate": 0.000087,
"liq_count": 5
}
Payload Field Reference
| Field | Type | Description |
|---|---|---|
| type | string | Event category: LIQ_CASCADE, VOL_SPIKE, OI_EXPLOSION, SPOOFING, BTC_DECOUPLING. |
| symbol | string | Contract ticker identifier (e.g. BTCUSDT, ETHUSDT, SOLUSDT). |
| side | string | Aggressive market pressure: Buy (liquidation of shorts) or Sell (liquidation of longs). |
| impact | float | Total USD volume executed during the anomaly window. |
| verdict_state | string | Microstructure classification: Deleveraging, Absorption, or Initiation. |
| cvd_1m / 5m / 15m | float | Cumulative Volume Delta across 1, 5, and 15-minute rolling lookback windows. |
| oi_delta_pct | float | Percentage change in Open Interest over 5 minutes (confirms aggressive positioning vs closing). |
| funding_rate | float | Live 8-hour perpetual contract funding rate from Binance. |
Quickstart Code Snippets
Connect your trading algorithmic bots in less than 30 lines of code.
import asyncio
import json
import websockets
API_KEY = "YOUR_API_KEY"
# Secure WSS production stream (or direct ws://173.212.247.145:8080/ws/v2/stream)
WS_URL = f"wss://sigma-liq.fun/ws/v2/stream?api_key={API_KEY}"
async def listen_whale_core():
async with websockets.connect(WS_URL) as ws:
# 1. Receive initial welcome handshake
init_msg = await ws.recv()
print(f"Connected: {init_msg}")
# 2. Event processing loop
while True:
raw = await ws.recv()
event = json.loads(raw)
# Filter high-impact cascades
if event.get("type") == "LIQ_CASCADE":
symbol = event["symbol"]
impact = event["impact"]
side = event["side"]
print(f"🚨 [{symbol}] {side} Liq Cascade: ${impact:,.0f} | CVD: {event.get('cvd_1m')}")
if __name__ == "__main__":
asyncio.run(listen_whale_core())
Frequently Asked Technical Questions
What data anomalies does the Whale Core WebSocket feed detect?
The stream emits 5 primary institutional events: LIQ_CASCADE (rapid sequential liquidations), VOL_SPIKE (statistical volume anomalies over 3σ), OI_EXPLOSION (rapid leveraged position opening), SPOOFING (large limit walls canceled prior to execution), and BTC_DECOUPLING (altcoin price divergence from Bitcoin).
What is the execution latency of the WebSocket stream?
Internal processing latency from Binance trade ingestion through calculation to client WebSocket push is under 5 milliseconds. Top-3 pairs (BTC, ETH, SOL) have 0ms distribution delay.
Which cryptocurrency trading pairs are supported?
Whale Core monitors 100 USDT-margined perpetual futures pairs on Binance 24/7, continuously tracking depth, trade flow, order book density, and funding rates.
How is the data authenticated, and what are the rate limits?
Authentication is passed via the ?api_key= query parameter. Because the connection is a persistent bi-directional WebSocket, you do not need to poll, and there are zero rate-limit bans during high-volatility cascade events.
Get Your API Key
Full WebSocket stream access with sub-millisecond delivery is included with VIP access. Connect your trading terminal today.