# Binance 合约聪明钱 & OI 异动监控

[![npm version](https://img.shields.io/npm/v/binance-smart-money-oi-monitor)](https://www.npmjs.com/package/binance-smart-money-oi-monitor)
[![npm downloads](https://img.shields.io/npm/dm/binance-smart-money-oi-monitor)](https://www.npmjs.com/package/binance-smart-money-oi-monitor)
[![CI](https://github.com/0xBennie/binance-smart-money-oi-monitor/actions/workflows/ci.yml/badge.svg)](https://github.com/0xBennie/binance-smart-money-oi-monitor/actions/workflows/ci.yml)
[![license](https://img.shields.io/npm/l/binance-smart-money-oi-monitor)](LICENSE)
[![node](https://img.shields.io/node/v/binance-smart-money-oi-monitor)](package.json)

[English](README.md) · **简体中文**

> **[Bennie Strategy](https://x.com/0xBenniee)** 出品 · npm 包名 `binance-smart-money-oi-monitor` · 联系：[X/推特 @0xBenniee](https://x.com/0xBenniee) · [Telegram @OxBennie](https://t.me/OxBennie)

生产级的 **Binance Smart Signal（"聪明钱 / Smart Money" 标签页）** 抓取器 —— 拉取
公开 `fapi` 接口**拿不到**的完整 17 字段鲸鱼总览，并内置 7 层 `418 / 429 / 403`
限频封禁防护。

![币安聪明钱看板 —— 分多空的鲸鱼持仓、资金费,自包含可分享卡片](https://raw.githubusercontent.com/0xBennie/binance-smart-money-oi-monitor/main/docs/panel-preview.png)

本仓库包含 **一套工作流的两半** + **三种数据消费方式**：

| 工具 | 技术栈 | 作用 |
|---|---|---|
| **Smart Money 抓取器**（根目录 `src/`） | TypeScript | 把 17 字段鲸鱼总览 + 头部账户 + OI 快照入 SQLite，并提供 Express 看板 |
| **[altmonitor](https://github.com/0xBennie/binance-smart-money-oi-monitor/tree/main/altmonitor)**（`altmonitor/`） | Python | 全市场 1 分钟价格异动（±3%）+ OI 异动监控，带 Telegram bot |

altmonitor 告诉你某个币**何时**异动（实时 Telegram 价格 / OI / 爆量告警）；Smart Money 抓取器 / MCP / 看板告诉你**是谁**在建仓、鲸鱼是否在盈利 —— 把告警到的币直接丢进 `get_full_picture` / `render_panel`。

**Smart Money 数据三种消费方式** —— 当 [Node 库](#当作库使用)、走 [HTTP JSON API](#http-json-api)、或通过自带的
[**MCP server**](#mcp-server从任意终端-ai-调用) 把它暴露成工具给任意终端 AI（Claude Code、Codex、Gemini CLI、Cursor……）。

这是 `binance.com/zh-CN/smart-money/signal/<symbol>` 页面背后调用的接口：

```
https://www.binance.com/bapi/futures/v1/public/future/smart-money/signal/overview?symbol=BTCUSDT
```

无需 API key，无需代理（多数 VPS 区域可直连）。但币安对此 web `bapi` 网关有未公开的
单 IP 权重预算，一次莽撞的突发请求就可能换来 4 小时的 `Retry-After`。本仓库解决这个问题。

---

## 相比公开 fapi，你多拿到什么

| 字段 | 公开 `fapi/data` | 本仓库 |
|---|---|---|
| `longShortRatio` | ✅ 经 `topLongShortPositionRatio` | ✅ |
| 头部 20% 账户/持仓多空比 | ✅ | ✅（附带） |
| Taker 主动买卖比 | ✅ | ✅（附带） |
| 全市场未平仓量（USD）+ 5m/15m/1h/4h 变化 | ✅ | ✅（附带） |
| **`longWhalesAvgEntryPrice` / `shortWhalesAvgEntryPrice`**（鲸鱼均价） | ❌ | ✅ |
| **`longProfitTraders` / `shortProfitTraders`**（盈利交易者数） | ❌ | ✅ |
| **`longProfitWhales` / `shortProfitWhales`**（盈利鲸鱼数） | ❌ | ✅ |
| **聪明钱占全市场 OI 的比例**（衍生计算） | ❌ | ✅ |

**加粗**的那几行才是 Smart Signal 真正有用的地方 —— 它们不只告诉你*哪边持仓更多*，
而是*此刻哪边真在赚钱*、均价多少。公开 `fapi` 给不了这些。

### 解读示例

```
币种            多头盈利%   空头盈利%   鲸鱼均价 多/空    判断
1000RATSUSDT    5%          92%         0.034 / 0.042    🔴 空头大赚（价格已下跌）
1000LUNCUSDT    71%         41%         0.085 / 0.092    🟢 多头大赚（价格已拉升）
```

当 `空头鲸鱼均价 > 多头鲸鱼均价` 超过 5% 时，通常意味着空头进场太晚、即将被逼空。

---

## 架构

```
                    ┌──────────────────────────────────────────────────────┐
                    │                    库内核 (library core)              │
                    │  getSmartMoneyOverview / getTopTraderSnapshot /       │
                    │  getOpenInterest —— 实时直连 Binance (bapi + fapi/    │
                    │  data)，7 层限频防护                                  │
                    └───────────────┬───────────────────────┬───────────────┘
                                    │                        │
        ┌───────────────────────────┘                        └────────────────────────┐
        │  轨道 A —— cron → 库 → 看板                          │  轨道 B —— 实时，无 DB    │
        ▼                                                     ▼  (实时直连 Binance，      │
┌─────────────────┐  cron 60m                                    无 cron / 无 sqlite)    │
│ smart-money-tick│──┐                                       ┌──────────────────────────┐
└─────────────────┘  │                                       │  • Node import 导入      │
┌─────────────────┐  │ 写入快照                              │      import { … }        │
│ top-trader-tick │──┤                                       │  • MCP server            │
└─────────────────┘  │                                       │      (stdio，7 个工具)   │
┌─────────────────┐  │                                       │  • panel HTML 看板卡片   │
│ oi-tick         │──┘                                       │      (render_panel)      │
└─────────────────┘  │                                       └──────────────────────────┘
                     ▼
┌─────────────────────────────────────────────┐
│           sqlite (data/snapshots.db)         │
│   ob_smart_money_snapshots (21 列)           │
│   ob_top_trader_snapshots  (12 列)           │
│   ob_oi_snapshots                            │
└────────────────────┬─────────────────────────┘
                     │ 只读
                     ▼
            ┌───────────────────┐
            │ Express 看板 + API │   http://your-host:3001/
            └───────────────────┘
```

- **轨道 A**（`cron → sqlite → Express`）：定时 tick 把快照写入一个 sqlite
  文件（两/三张表，30 天保留），由一个服务端渲染的 Express 看板 + JSON API
  提供（无前端框架）。
- **轨道 B**（实时，**无 DB**）：同一份库内核被直接消费 —— 当 **Node import**
  导入、走 **MCP server**（stdio，7 个工具）、或通过 **panel HTML**
  （`render_panel`）。每次调用都实时直连 Binance，**无需 cron、无需数据库**。
- **共享内核**：两条轨道都调用 `getSmartMoneyOverview` /
  `getTopTraderSnapshot` / `getOpenInterest`，因此同一套 7 层限频防护保护每条路径。

---

## 7 层 418/429 防护

Smart Signal 接口位于币安 web `bapi` 网关，比 `fapi` 更敏感。一次未协调的突发请求
就可能换来**实测 3.85 小时**的 `Retry-After`。下面 7 层默认全部启用：

1. **真实解析 `Retry-After`** —— 用币安返回的确切秒数，不靠猜。
2. **权重预算追踪** —— 读每个 fapi 响应的 `X-MBX-USED-WEIGHT-1M`，利用率 > 70% 时下一次调用睡到下一分钟窗口。
3. **预检 ping** —— 每个 cron 入口先 ping `/fapi/v1/ping`，遇 418/403 立即中止，不再发任何请求。
4. **抖动间隔** —— smart-money 用 12s ± 3s，top-trader 用 1s ± 200ms，避免形成被 WAF 识别的固定节奏。
5. **指数退避** —— 1 小时内连续软命中，冷却 5min → 15min → 60min 逐级升级。
6. **进程级熔断** —— `isBinanceApiBlocked()` 短路同进程内所有下游调用。
7. **内存缓存** —— smart-money 10min、top-trader 5min，窗口内重复请求同一币不触网。

**没有任何忽略 `Retry-After` 的重试路径**，这是故意的：把 5 分钟软封升级成多小时硬封的
最快方式，就是对 418 做重试循环 —— 别这么干。

---

## 快速开始

```bash
git clone https://github.com/0xBennie/binance-smart-money-oi-monitor.git
cd binance-smart-money-oi-monitor
npm install

# 1. 单次拉取（写入 data/snapshots.db）
npx tsx src/scripts/smart-money-tick.ts

# 2. 启动看板（读同一个 db）
PORT=3001 npx tsx src/scripts/smart-money-dashboard.ts
# → http://localhost:3001/

# 3. 可选：再拉 top-trader 补充（Taker 买卖比 + 5min LSR）
npx tsx src/scripts/top-trader-tick.ts
```

### 环境变量

| 变量 | 默认 | 说明 |
|---|---|---|
| `SMART_MONEY_POOL_MAX` | `0` | 币种上限。**0 = 全部 USDT-PERPETUAL**（~500）。设为如 `100` 限制 |
| `SMART_MONEY_SHARD_INDEX` | `0` | 分片时的 0 基下标 |
| `SMART_MONEY_SHARD_TOTAL` | `1` | 总分片数，`1` = 不分片 |
| `TOP_TRADER_POOL_MAX` / `_SHARD_INDEX` / `_SHARD_TOTAL` | 同上 | top-trader cron 同语义 |
| `OI_POOL_MAX` / `_SHARD_INDEX` / `_SHARD_TOTAL` | 同上 | OI cron 同语义 |
| `SMART_MONEY_DASHBOARD_PORT` / `PORT` | `3001` | 看板监听端口 |

### 当作库使用

```ts
import {
  getSmartMoneyOverview,
  getTopTraderSnapshot,
  getOpenInterest,
  smartMoneyNotionalUsd,
  smartMoneyShareOfOI,
} from 'binance-smart-money-oi-monitor';

const sym = 'BTCUSDT';
const [sm, tt, oi] = await Promise.all([
  getSmartMoneyOverview(sym),         // 17 个鲸鱼字段
  getTopTraderSnapshot(sym, '5m'),    // 头部账户/持仓 LSR + Taker 买卖比
  getOpenInterest(sym),               // 全市场 OI + 5m/15m/1h/4h 变化
]);

if (sm && oi) {
  console.log(`${sm.longWhales} 个多头鲸鱼 @ 均价 ${sm.longWhalesAvgEntryPrice}`);
  console.log(`${sm.longProfitTraders}/${sm.longTraders} 多头在盈利`);
  console.log(`全市场 OI: $${(oi.oiNowUsd / 1e6).toFixed(2)}M，4h 变化 ${oi.oiChg4h == null ? 'n/a' : oi.oiChg4h.toFixed(2) + '%'}`);

  // 聪明钱 USD 名义敞口，由 数量 × 均价 推导（不要用单位不一致的 totalPositions）。
  const smUsd = smartMoneyNotionalUsd(sm);
  const share = smartMoneyShareOfOI(sm, oi.oiNowUsd);
  console.log(`聪明钱名义敞口: $${(smUsd / 1e6).toFixed(2)}M`);
  console.log(`占全市场 OI: ${share == null ? 'n/a' : (share * 100).toFixed(1) + '%'}`);
}
```

> **为什么要 helper？** 币安未公开的 `totalPositions` 字段单位跨币种不一致（有时是币本位、有时是 USD）。
> `smartMoneyNotionalUsd(sm)` 用单位已知的字段（`数量 × 均价`）确定性地算出 USD 名义敞口。不要拿 `totalPositions` 去除任何东西，用这个 helper。

本库还一并导出了所有限频 helper（`isBinanceApiBlocked`、`preflightBinanceFapi`、
`waitForBinanceWeightHeadroom`），你可以把同一套熔断器接进自己的其他 Binance 调用，
让多个模块共用一份权重预算。

直接从 GitHub 安装：

```bash
npm install github:0xBennie/binance-smart-money-oi-monitor
```

### HTTP JSON API

看板进程同时是一个对 sqlite 内容只读的 JSON API —— 任何 HTTP 客户端（包括能 `fetch` 的 AI agent）都能拉：

```bash
npm run dashboard          # 默认 PORT=3001
```

| 路由 | 返回 |
|---|---|
| `GET /api/snapshots` | 每个币最新快照（smart-money 关联 OI），附盈利% 和 占 OI 比例 |
| `GET /api/symbol/:symbol/history?days=30` | 单币快照历史 |
| `GET /health` | `{ ok: true, port }` 存活探针 |
| `GET /` | 人看的 HTML 看板（可排序表格） |
| `GET /symbol/:symbol` | 单币 30 天 HTML 视图 |

> API 返回的是 cron 已写入 `data/snapshots.db` 的内容。先至少跑一次抓取器（`npm run smart-money:tick`），否则响应为空。

### MCP server（从任意终端 AI 调用）

自带的 MCP server 把**实时**的 Smart Money / Top Trader / OI 库（含内置限频防护）暴露成
Model Context Protocol 工具 —— 无需 cron、无需本地数据库。兼容任意 MCP 客户端：
**Claude Code、Claude Desktop、Codex CLI、Gemini CLI、Cursor、Windsurf、Cline、Zed、Continue** ……

**一行注册到你自己的 AI —— 不用 clone、不用 build。** 让客户端指向
`npx -y binance-smart-money-oi-monitor` 即可：

> **更新:** `npx` 会缓存包 —— 要用最新版,重新添加(`claude mcp remove binance-smart-money && claude mcp add …`)或运行 `npx clear-npx-cache`,再重启客户端。

```json
{
  "mcpServers": {
    "binance-smart-money": {
      "command": "npx",
      "args": ["-y", "binance-smart-money-oi-monitor"]
    }
  }
}
```

或在 Claude Code 命令行里加：

```bash
claude mcp add binance-smart-money -- npx -y binance-smart-money-oi-monitor
```

`npx` 会自动下载包、运行 `binance-smart-money-oi-monitor` 这个 bin（即 MCP server），
你的 AI 就拿到下面 7 个工具。该 server 是纯 stdio JSON-RPC，运行时**不加载任何原生模块**
（不拉 `better-sqlite3`/`express`）。

<details>
<summary>从 clone 直接跑（无需发布 npm）</summary>

```json
{
  "mcpServers": {
    "binance-smart-money": {
      "command": "npx",
      "args": ["tsx", "src/scripts/mcp-server.ts"],
      "cwd": "/绝对路径/binance-smart-money-oi-monitor"
    }
  }
}
```

或直接 `npm run mcp` 在前台启动 stdio server。
</details>

**暴露的工具：**

| 工具 | 参数 | 返回 |
|---|---|---|
| `get_smart_money` | `symbol` | 分多空返回**聪明钱 + 鲸鱼各自的仓位**(USD)、均价、盈利者数 —— fapi 拿不到 |
| `get_top_trader` | `symbol`, `period?` | 头部账户（top 20% 保证金）LSR + Taker 买卖比 |
| `get_open_interest` | `symbol` | 全市场 OI（USD + 币数）+ 5m/15m/1h/4h 变化 |
| `get_full_picture` | `symbol`, `period?` | 分多空的聪明钱 + 鲸鱼仓位、头部账户、OI + 占比 —— "X 现在什么仓位"的一键调用 |
| `get_funding` | `symbol`, `notionalUsd?` | 资金费率 → 年化 % + 一笔仓位每次 / 每天 / 每年 付(收)多少 U(默认 1万U);自动识别 8h/4h/1h 周期 |
| `render_panel` | `symbol`, `includeHtml?` | 可分享的深色 HTML 聪明钱卡片（Smart Signal 样式）—— 返回 `{ summary, html }`；传 `includeHtml:false` 只要 summary |
| `render_push` | `symbol` | Telegram `巨鲸总览` 推送卡片，`parse_mode:HTML` 消息体 —— 可直接发到聊天（相对 `render_panel` 的完整 HTML 页面）|

`get_full_picture ETH` 返回示例：

```json
{
  "symbol": "ETHUSDT",
  "smartMoney": { "longShortRatio": 0.288, "shortProfitPct": 72, "notionalUsd": 1860314867 },
  "topTrader": { "topPositionLsr": 1.50, "takerBuySellRatio": 1.16 },
  "openInterest": { "oiNowUsd": 3610164191, "oiChg4h": 0.55 },
  "smartMoneyShareOfOI": 0.515
}
```

### 生成可分享的看板

![可分享的聪明钱看板 — BEAT 示例](https://raw.githubusercontent.com/0xBennie/binance-smart-money-oi-monitor/main/docs/panel-preview.png)

把任意币的鲸鱼仓位做成一张**自包含深色 HTML 卡片**（币安 Smart Signal 那种样式）—— 截图发推，或把 HTML 串嵌进自己的网站。

```bash
npm run panel BEAT          # 生成 beatusdt-panel.html，浏览器打开截图即可
```

三种方式，同一张卡：

```ts
import { buildPanel, renderPanelHtml } from 'binance-smart-money-oi-monitor';
const html = renderPanelHtml((await buildPanel('BEAT'))!);   // 当库用
```

第三种方式是 MCP 工具 `render_panel`（见上方工具表），让你的 AI 当场生成看板。
无论用哪种方式，卡片都零依赖（无外链），到哪都能渲染、截图干净。

---

## 池规模 & cron 节奏

默认行为是**全部 USDT-PERPETUAL 币种**（2026 年约 500 个合约）。按你对数据新鲜度的容忍度选部署模式：

| 模式 | 币数 | smart-money cron | top-trader cron | OI cron | 分片 |
|---|---|---|---|---|---|
| **轻量** | 上限 100 | `7 * * * *`（1×/h） | `*/30 * * * *` | `15,45 * * * *` | 无 |
| **标准** | 上限 200 | `7 * * * *`（1×/h） | `*/30 * * * *` | `15,45 * * * *` | 无 |
| **全量，2h 刷新** | ~500 全部 | `0 */2 * * *`（1×/2h） | `*/30 * * * *` | `15,45 * * * *` | 无 |
| **全量，1h 刷新** | ~500 全部 | `7,37 * * * *`（2×/h，各跑一半） | `*/30 * * * *` | `15,45 * * * *` | **2 分片** |

"1h 刷新"读作**每个币在 1 小时内都拿到一次新快照**，靠 `:07` 和 `:37` 两个 cron 各拉一半（分片 0/2 和 1/2）实现。

算账：smart-money 用 12s ± 3s 间隔（web bapi 对频率敏感），500 币 ≈ 100 分钟，不分片塞不进 1 小时。
top-trader 和 OI 都走 fapi/data、1s 间隔，500 币 ≈ 8 分钟，随便放。

### 分片

币种按 `index % SHARD_TOTAL == SHARD_INDEX` 确定性切分，每个分片永远拉同一批（缓存局部性好，且分片间不会在同一窗口撞同一个币）。

### 数据保留

三张表由每次 `smart-money-tick` 结尾的 `storage.cleanup()` 修剪到 **30 天**。要更长历史就调大
`src/storage.ts` 里的 `RETENTION_DAYS` 重新构建，或在每日 cron 前备份。

默认节奏下（500 币、smart-money 每小时 + top-trader/OI 各 30min）磁盘占用约 **30–80 MB/月**（开 WAL）。

## 生产部署（pm2）

### A. 标准 —— 上限 200，每小时

```js
// ecosystem.config.js
module.exports = {
  apps: [
    {
      name: 'smart-money-tick',
      script: 'node_modules/.bin/tsx',
      args: 'src/scripts/smart-money-tick.ts',
      cron_restart: '7 * * * *',        // 每小时 :07
      autorestart: false,
      env: { SMART_MONEY_POOL_MAX: '200' },
    },
    {
      name: 'top-trader-tick',
      script: 'node_modules/.bin/tsx',
      args: 'src/scripts/top-trader-tick.ts 5m',
      cron_restart: '*/30 * * * *',
      autorestart: false,
    },
    {
      name: 'oi-tick',
      script: 'node_modules/.bin/tsx',
      args: 'src/scripts/oi-tick.ts',
      cron_restart: '15,45 * * * *',    // 与 top-trader 错开
      autorestart: false,
    },
    {
      name: 'smart-money-dashboard',
      script: 'node_modules/.bin/tsx',
      args: 'src/scripts/smart-money-dashboard.ts',
      autorestart: true,
      env: { PORT: '3001' },
    },
  ],
};
```

### B. 全量覆盖 + 1h 刷新 —— 2 路分片

两个 pm2 入口，各在错开的时间拉一半币种：

```js
module.exports = {
  apps: [
    {
      name: 'smart-money-tick-a',
      script: 'node_modules/.bin/tsx',
      args: 'src/scripts/smart-money-tick.ts',
      cron_restart: '7 * * * *',        // :07
      autorestart: false,
      env: { SMART_MONEY_SHARD_INDEX: '0', SMART_MONEY_SHARD_TOTAL: '2' },
    },
    {
      name: 'smart-money-tick-b',
      script: 'node_modules/.bin/tsx',
      args: 'src/scripts/smart-money-tick.ts',
      cron_restart: '37 * * * *',       // :37 —— 与 A 错开 30 分钟
      autorestart: false,
      env: { SMART_MONEY_SHARD_INDEX: '1', SMART_MONEY_SHARD_TOTAL: '2' },
    },
    // ... top-trader-tick 和 dashboard 与模式 A 相同
  ],
};
```

### C. 全量覆盖，刷新更慢 —— 2 小时 cron，不分片

不需要每小时新鲜度时最省的方案：

```js
{
  name: 'smart-money-tick',
  args: 'src/scripts/smart-money-tick.ts',
  cron_restart: '0 */2 * * *',          // 每 2 小时
  autorestart: false,
  // 无需 env —— 默认全部币种
}
```

### 为什么要错峰

熔断器活在每个进程各自的模块状态里。两个同时运行的 cron 进程无法直接共享
`isBinanceApiBlocked()` 状态，但每个进程在发出任何数据请求前都会先用
`preflightBinanceFapi()` 做 ping 探测 —— 所以如果进程 A 刚吃到 418，进程 B 的
预检就会捕捉到并干净地中止。无论如何都把时间错开，好让 IP 权重窗口在两次突发
之间有时间回落。

---

## 伴随工具：altmonitor（价格 / OI / 爆量 异动监控）

> altmonitor 机器人在 GitHub 仓库里（不随 npm 包发布）。

[`altmonitor/`](https://github.com/0xBennie/binance-smart-money-oi-monitor/tree/main/altmonitor) 是一个自包含的 **Python** 工具（本仓库 Python 那一半），
监控**全部** USDT 永续合约，推送三类 Telegram 告警：

1. **价格异动** —— 单根 1 分钟 K 线涨/跌 ≥ ±3%，带价 × 仓四象限 + 振幅 + 多空比
2. **OI 异动** —— 未平仓量在 **1 分钟** 或 **5 分钟** 窗口内骤变超阈值
3. **爆量（成交量）** —— 收盘 1m 成交额突增到自身近 N 根中位的 ≥ N 倍

- 单条 WebSocket 订阅全市场 `@kline_1m`（价格 + 成交量）
- 后台每 60s 扫全市场 `fapi/v1/openInterest`，存进带时间戳的环形缓冲算 1m/5m 变化
- Telegram 命令（`/set_pump`、`/set_oi`、`/set_vol`、`/watch`、`/history`、`/stats` ……）实时调参，无需重启，持久化到 `state.json`
- 可选 SQLite 告警历史（三类都存），供 `/history`、`/stats` 复盘
- 全部免费公开接口 —— 无需 API key，不烧额度

**最快上手：配置向导**（校验 bot token、自动抓取 chat_id、写好 `.env`，再询问本地 / Docker / 部署到你的服务器）：

```bash
cd altmonitor && pip install -r requirements.txt && python setup.py
```

**一条命令部署到自己的 VPS**（先试 SSH key 再用密码，装 Docker，同步代码 + `.env`，运行，上线后 Telegram 通知你）：

```bash
python altmonitor/deploy.py        # 或在 setup.py 最后选"部署到我的服务器"
```

Docker 一键部署（在仓库根目录）：

```bash
cp altmonitor/.env.example altmonitor/.env   # 填 TG_BOT_TOKEN + TG_CHAT_ID
docker compose up -d                          # 构建 + 运行，崩溃自动重启
```

或直接运行：

```bash
cd altmonitor
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env          # 填入 TG_BOT_TOKEN + TG_CHAT_ID
python monitor.py
```

完整配置、Telegram 命令表、Docker compose、systemd 配置见 [`altmonitor/README.md`](https://github.com/0xBennie/binance-smart-money-oi-monitor/tree/main/altmonitor#readme)。

---

## 本仓库**不**包含

- ❌ 不交易，纯数据。
- ❌ 无代理。如果你的 IP 吃到硬 403（CloudFront WAF），唯一办法是等或换 IP —— 防护层的全部意义就是永远走不到那一步。
- ❌ 无链上数据、无盘口、无聚合成交。这些见*致谢*里的项目。

---

## 作者 & 联系

由 **Bennie Strategy** 开发维护。

- 🐦 X / 推特：[@0xBenniee](https://x.com/0xBenniee)（0x 是数字零加 x，双写 e）
- 💬 Telegram：[@OxBennie](https://t.me/OxBennie)（Ox 是大写字母 O）

两个 handle 都是对的，不是打错。有问题、想法或想要某个功能？两个渠道都可以找我，也欢迎提 issue / PR。

---

## 致谢

- **[andychien555/binance-smart-money-tracker](https://github.com/andychien555/binance-smart-money-tracker)**
  —— 最早逆向出 `bapi/futures/v1/public/future/smart-money/signal/overview` 接口。他们的版本基于
  Cloudflare Workers + R2 + 静态 SPA 前端；本仓库是 Node + sqlite + express 版，限频防护更强。架构不同，数据洞见同源。
- **[y18929284608-byte/BNSmartMoneyMonitor](https://github.com/y18929284608-byte/BNSmartMoneyMonitor)**
  与 **[6551Team/opentrade](https://github.com/6551Team/opentrade)** —— 平行实现，印证了接口契约。

---

## 许可证

MIT —— 见 [LICENSE](LICENSE)。