鲸鱼多空比
鲸鱼 / 聪明钱多空持仓，来自币安 Smart Money 信号（大户与鲸鱼数量）。
| 端点 | 来源 | 说明 |
|---|---|---|
GET /smart-money/signal/overview | Binance Smart Money | 单交易对总览：多空人数、鲸鱼数、净持仓、均价。需传 symbol。 |
GET /smart-money/signal/list | Binance Smart Money | 大户净持仓 / 多空成交排行列表。 |
GET /whale-board | 平台快照（Redis） | 全量：所有活跃交易对的鲸鱼多空 + 评分，按评分降序。 |
参数
| 参数 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
symbol | query | string | /overview 必填 | — | 例如 BTCUSDT。 |
timeRange | query | string | /list 必填 | 24h | 30m、1h、24h、7d 之一。 |
min_quote_volume | query | number | 否 | 50000000 | /whale-board 过滤阈值（USDT）。 |
响应 — 200 OK
/smart-money/signal/overview 返回该交易对的多空人数、鲸鱼数、净持仓与均价。/whale-board 返回快照：
{
"generatedAt": 1745920800000,
"rows": [
{ "symbol": "BTCUSDT", "quoteVolume": "...", "whaleLongShort": "...", "score": 0.0 }
]
}
错误
| HTTP | 触发原因 |
|---|---|
400 | timeRange 不在允许集合内（/list）。 |
502 | 上游 Binance 请求失败。 |
示例
# 单交易对鲸鱼多空总览
curl -s "https://api.pipai.org/smart-money/signal/overview?symbol=BTCUSDT"
# 全量巨鲸看板
curl -s "https://api.pipai.org/whale-board?min_quote_volume=50000000"