Whale Long/Short Ratio

Whale / smart-money long/short positioning, derived from Binance's Smart Money signal feed (large holders and whale counts).

Endpoint	Source	Notes
GET /smart-money/signal/overview	Binance Smart Money	Per-symbol overview: long/short head-count, whale count, net position, average price. symbol required.
GET /smart-money/signal/list	Binance Smart Money	Ranked list of large-holder net position / long-short flow.
GET /whale-board	platform snapshot (Redis)	Bulk: all active symbols with whale long/short + score, sorted by score.

Parameters

Name	In	Type	Required	Default	Notes
symbol	query	string	for /overview	—	e.g. BTCUSDT.
timeRange	query	string	for /list	24h	One of 30m, 1h, 24h, 7d.
min_quote_volume	query	number	No	50000000	/whale-board filter, in USDT.

Response — 200 OK

/smart-money/signal/overview returns long/short head-count, whale count, net position and average price for the symbol. /whale-board returns a snapshot:

{
  "generatedAt": 1745920800000,
  "rows": [
    { "symbol": "BTCUSDT", "quoteVolume": "...", "whaleLongShort": "...", "score": 0.0 }
  ]
}

Errors

HTTP	Cause
400	timeRange not in the allowed set (/list).
502	Upstream Binance request failed.

Examples

# Per-symbol whale long/short overview
curl -s "https://api.pipai.org/smart-money/signal/overview?symbol=BTCUSDT"

# Bulk whale board
curl -s "https://api.pipai.org/whale-board?min_quote_volume=50000000"