1. 盯盘
币安通过 WebSocket 推送你选中币种的实时价格与 K 线；worker 进程始终在线，逐币种处理每一个价格更新。
chrisleekr/binance-trading-bot · 自托管币安现货自动交易机器人
binance-trading-bot：自托管币安自动交易机器人，从部署到实盘放行
它是一个用 TypeScript 写成的自托管应用：你把它跑在自己的 Linux 服务器上，用币安 API Key 接上账户，它就按你选的策略规则盯盘并下单。内置三套策略扩展、账户级 Profile 隔离、回测放行门禁与三级急停。官方文档全英文，本站把部署、参数与排错整理成中文。
项目来源
仓库页显示 5558 Star / 1168 Fork、TypeScript、Apache-2.0，最新版本 v1.5.0；数字会随社区活动变化，采集日期 2026-09-17。
查看官方源码仓库
Apache-2.0 开源可自托管，无订阅费；服务器与币安账户自备
5558 Star1168 Fork、最新 v1.5.0（2026-09-17 采集，会变化）
三进程一容器ROLE=all 时 api + worker + study 同进程
官方风险自述Not production-ready，不建议投入真实资金
Capabilities
binance-trading-bot 有哪些能力，各自要注意什么
依据官方 README 与 docs/ 官方文档（2026-09-17 核验）。下表把每一项能力和它的适用场景、注意点放在一起，避免只看名字产生误会。
| 能力 | 说明 | 适用场景 | 注意点 |
|---|---|---|---|
| 三套策略扩展 | trailing-trade（分步追跌买入 + 跟随高点回撤卖出）、momentum（EMA 突破进场 + 跟踪止损）、rebalance（固定权重或动量权重持有篮子） | 想让机器人按明确规则自动决定买、卖或不动 | 每个 Profile 只能选一套；策略只负责决定，下单由 Executor 负责 |
| 账户与 Profile 隔离 | 一个操作员账号下可挂多个币安账户；每个账户可跑多个独立 Profile，各有自己的币种、预算与策略 | 同一笔资金里想并行跑几套互不干扰的配置 | Profile 之间共享同一个账户钱包，预算要按账户整体额度来规划 |
| 回测与实盘放行门禁 | 回测与实盘共用同一个执行器；只有「同一份配置指纹」的回测才能放行该配置上线 | 在投入真实资金前先验证参数 | 改执行参数会让指纹变化，必须重跑回测，旧回测不再有效 |
| 风控断路器 | 日亏损上限、连亏次数、回撤深度三个断路器，达到阈值就暂停新买入 | 希望亏损到某个程度时自动收手 | 只暂停新买入，不会平仓，也不影响保护性止损；默认值都是 0（关闭） |
| 三级急停 | 单币种暂停（最长 7 天）、单 Profile 停止、整账户全停 | 出现异常时立刻止损操作 | 急停只是不再下新单；已挂在交易所的订单仍可能成交，不会自动撤销 |
| 币种自动发现 | 定时生成可选币种快照，并用净优势回测做准入校验，按币安自身分类排除稳定币与法币 | 不想手工维护币种清单 | 发现机制有自己的准入条件，通过校验前不会进入交易 |
| 通知器 | Slack、Telegram 与通用 Webhook，可通知成交与运行异常 | 不想一直盯着面板，希望出错时被叫醒 | 密钥为写一次不再回显；有实盘 Profile 却没配通知器会在面板上告警 |
| 审计、备份与运维端点 | 操作留痕、PG 备份服务、/status 暴露构建版本与迁移时间 | 长期运行后需要复盘「当时为什么这么做」 | 备份文件与数据库卷含明文币安密钥，泄露后必须轮换密钥 |
How it works
一笔交易是怎么发生的：四步看懂运行环路
官方把整套机制概括成一句话：它是对你指定的每个币种反复跑一个很短的循环。下面四步是最小必要理解，更细的决策链与可靠性机制在「账户」页。
2. 跑规则
你选的策略规则读入最新价、近期 K 线、钱包余额与本身设置，判断这一步该买、该卖，还是什么都不做。
3. 落单
决定之后由执行器负责下单或撤单，并做幂等控制，确保崩溃重启后不会把同一笔单重复提交。
4. 落库与告警
每一步决策都写入数据库，面板上能看到持仓、挂单与「为什么这么做」，并可选择通过通知器推送给你。
Rulebooks
三套内置策略分别适合什么行情
它把策略称作 rulebook（规则书）。你为每个 Profile 挑一本，策略之间的差别不是「谁更赚钱」，而是「各自假设哪种行情会持续」。
| 策略 | 它做什么 | 适合你预期 | 不适合 |
|---|---|---|---|
| Trailing Trade | 价格下跌时分批买进（网格），持有后跟随近期高点回撤卖出 | 价格在一个区间里来回震荡、反复起伏 | 单边持续趋势——它赚的是反复波动，不是一段大趋势 |
| Momentum | 等确认的向上突破再买进，用跟踪止损或在快慢均线死叉时离场 | 一个币已经开始上涨、并且你预期它继续涨 | 横盘磨人的行情：它只做强势突破，可能长时间空仓等待 |
| Rebalance | 按你设定的目标占比持有篮子，价格偏离就纠偏；也可用动量权重只持有近期最强的若干只 | 想持有一个稳定配比，而不是择时进场 | 指望它抓点位：它不做市场择时，只纠正权重漂移 |
常见误会：它支持网格，但网格是 Trailing Trade 内的一种分批建仓方式，不是独立于三套策略之外的第四套策略。执行模式还有 market 与 maker 两种，但在 VIP0 费率档位下 maker 与 taker 手续费相同，maker 模式买到的只是「不穿越点差」，不是更低费率——详见策略页。
Interface evidence
跑起来之后，界面上能看到什么
下面这张是官方文档提供的面板截图。需要提前说清一件事：官方明确声明，其文档内所有截图都是对临时数据库注入种子演示数据后自动生成的，画面里的余额、价格、持仓与盈亏全部是虚构的，不是真实账户、也不是业绩记录。
关于收益的边界：官方在 README 与文档首页都写着「我无法保证你是否能赚钱，使用风险自负」，并明确该项目仍在开发中、不建议投入真实资金。本站不会提供任何收益预期、胜率或回测数字作为投资依据。
Setup and route
自建这台机器人，还是用 EasyClaw 做研究任务
这是两条给不同任务准备的路，不是同一个任务的两个难度。左边要你自备服务器与币安账户、自己承担下单风险；右边不需要部署，但它做的是数据与研究，不会替你下单。
Linux 服务器→Docker 起服务→接币安 Key→建 Profile→回测放行
换来的是账户级隔离、回测放行门禁与可审计的运行记录；代价是自备服务器、自担下单风险，且官方明确不建议投入真实资金。
装 EasyClaw→一句话提问→拿数据/图表
EasyClaw 本机技能里有加密货币行情、策略回测与出图能力，但没有下单类技能；binance-trading-bot 与 EasyClaw 无已证实集成。研究结论不构成投资建议。
先说清楚边界：EasyClaw 能替代的是「查行情、跑研究、出图表」这类任务，替代不了这台机器人的实盘下单与账户管理。完整对照（含各技能明确不覆盖的范围）见对比页。
① 策略回测（quant-analyst）：一句话双均线回测
样例边界：以上为 EasyClaw 实际使用截图（所用技能已在图注标出），左右切换查看。截图只证明对应的研究任务可以用一句话发起，不代表 binance-trading-bot 已集成 EasyClaw；EasyClaw 侧没有下单类技能，结果仅供研究，不构成投资建议。
Who fits
谁适合自建，谁应该先走研究路线
按你自己的任务和目标环境对号入座，比「哪个更强大」这种问法有用得多。
| 你的情况 | 更适合 | 理由 |
|---|---|---|
| 有 Linux 服务器、熟悉 Docker，想让规则自动执行 | 自建 binance-trading-bot | 部署 runbook 已把 9 步命令与验收命令整理好，按步执行即可 |
| 只想先看某个币的历史表现、跑一次策略研究 | EasyClaw 研究路线 | 不需要服务器与币安账户，提问即可得到数据与图表 |
| 期望「装上就自动赚钱」 | 两者都不适合 | 官方明确不保证盈利、不建议投入真实资金；任何收益预期都不成立 |
| 还没有币安账户或不熟悉 API 权限 | 先看接入页再决定 | 权限与 IP 白名单配错会直接导致不交易或报错，且密钥是明文存库 |
| 关心「亏到多少会自动停」 | 自建（风控页）或不做实盘 | 三个断路器与三级急停只存在于自建路线；研究路线根本不下单，也没有对应机制 |
| 网络环境无法稳定访问币安接口 | EasyClaw 研究路线 | 自建要求服务器能出站访问币安的行情与交易接口，否则无法运行 |
FAQ
关于 binance-trading-bot 的常见问题
binance-trading-bot 是什么？和普通交易机器人有什么区别？
它是 chrisleekr 开源的币安现货自动交易应用，自托管在你的服务器上，用 API Key 接账户并按策略规则自动下单。区别在于它把「账户与 Profile 两级隔离」「回测放行门禁」「风控断路器」做成了系统自带机制，而不只是一个连交易所的脚本。项目与文档的权威描述以官方仓库和官方文档站为准。
它免费吗？可以商用吗？
代码本身按 Apache-2.0 许可开源，可自行部署与修改。但运行成本由你承担：需要一台 Linux 服务器、一个币安账户，以及可能的服务器与网络费用。官方仓库与文档未对商用做额外说明，具体以 LICENSE 与官方说明为准。
它已经在 EasyClaw 里了吗？能不能一键安装？
没有。binance-trading-bot 与 EasyClaw 之间无任何已证实集成，它在 EasyClaw 中的安装状态为未验证。EasyClaw 本机技能里有加密货币行情、策略回测与图表这类研究能力，但没有下单类技能，不能替代它做实盘执行。详见对比页。
需要什么前置条件才能跑起来？
官方给出的前置是：一台 Linux 服务器（2 vCPU / 4 GB 内存 / 20 GB 磁盘即可起步）、Docker 24 以上并带 Compose 2.20 以上、服务器能出站访问币安的行情与交易接口、一个开了交易权限并配好 IP 白名单的币安 API Key。以官方 deploy 与 install 文档为准。
回测结果能当作收益预期吗？
不能。官方明确声明无法保证盈利，且项目仍在开发中、不建议投入真实资金。它的回测确实与实盘共用同一个执行器、并明确写了成交与滑点假设，但这些只是让你在投入前核对配置，不构成任何收益承诺或投资建议。历史结果不代表未来表现。
跑起来之后发现它不交易，通常是什么原因？
官方排错文档给出的顺序是：Profile 是否已启用、API Key 状态是否正常、买入条件是否真的满足（「什么都不做」是常见且有效的决策，可在日志里看到每个 tick 的判断依据）、以及账户里是否有可用余额。逐条对照见排错页。