竞赛雷达
操作说明与数据口径

OPERATIONS GUIDE

使用文档

从公开榜单、API Key 连接到终端执行：这份文档说明每一步使用什么数据、会发生什么，以及遇到阻断时该怎么处理。

先理解，再执行 估算、自动核验与实际成交分别有独立口径；不要把其中任意一种当成另一种。

QUICK PATH

五步完成一次比赛计划

  1. 01查看活动确认市场、交易对、官方时间与最新快照。
  2. 02连接 API使用专用 Key，校验权限、IP 与提现状态。
  3. 03设置目标选择档位、绑定 API Key，按实时数据计算。
  4. 04保存并启动保存时重新核算；启动前完成报名、余额与风控检查。
  5. 05终端监控查看日志、交易量、损耗与计划状态，必要时暂停或调整。

START HERE

开始前：先确认三件事

竞赛雷达分开处理公开比赛数据和你的个人 API 数据。榜单页只读取公开匿名排行榜；会员、目标和终端页面只使用你在账户中心明确连接并选择的 API Key。

  • 准备专用 API Key。必须开启读取权限；需要执行时再开启对应现货或 USDⓈ-M 交易权限。提现、划转、借贷等权限不得开启。
  • 确认 IP 白名单。账户中心会展示应用需要加入 Binance 的出口 IP。IP 不一致时，Binance 会拒绝请求或交易。
  • 理解数据更新时间。公开门槛依赖榜单快照；个人成交与余额依赖 API 同步。页面标出的快照时间和同步时间决定了当前读数的新鲜度。
重要边界平台不接收 Binance 密码、验证码或网页 Cookie，也不提供提现能力。实盘计划默认关闭，且每次启动仍会重新预检。

DATA LINEAGE

数据来源与口径：先分清“公开、预估、实际”

同一个页面上的数值并不一定来自同一个系统。下面这张图说明三类数据如何进入页面，以及它们能回答的问题。

当前合格交易量
比赛窗口内、指定 API Key 在指定交易对的实际成交量。不同比赛的排名指标可能是交易量或积分。
自动建议交易量
成本模式下，以保留 20% 奖励利润为默认条件计算的可承受交易量上限；它会随目标门槛、奖励币价和价格磨损报价变化。
已发生与预计
“已发生”来自同步记录；“预计”由当前方案与盘口报价推导。两者在页面中分开显示，不能相加后当成已实现收益。
同一比赛资源去重Binance 可能先返回没有榜单的占位资源，随后为同一活动发布新的真实榜单资源。系统会按活动分组、URI、时间窗口和规则身份核对重复项，只展示拥有真实榜单快照的资源；历史占位资源不会生成第二张比赛卡片，也不会影响全局数据质量。

ACCOUNT SETUP

连接账户与 API Key

进入“账户中心”，先用 Google、钱包签名或邮箱验证码建立会员身份，再新增一个 API Key。给每把 Key 一个可读的别名；后续目标、实际数据和计划均按这把 Key 绑定和筛选。

保存凭据前，系统会检查该 Key 的权限、IP 约束和提现状态。服务端只保存加密凭据和指纹，界面不会回显 Secret。

  1. 创建会员会话Google、钱包或邮箱三种入口任选其一。
  2. 输入别名与密钥输入仅提交至服务端，浏览器不存储 Secret。
  3. 权限与 IP 校验读取权限必须存在；已开启提现权限会被拒绝。
  4. 加密保存并选择后续方案必须明确关联其中一把活跃 Key。
每把 Key 独立代理可为单个 API Key 绑定 HTTP、HTTPS 或 SOCKS5 静态家庭 IP 代理，也可粘贴完整代理 URL 自动解析。绑定分两步：先通过候选代理识别真实公网出口 IP，复制到该 Binance API Key 的“仅允许受信任 IP”白名单；确认后系统会再次复核出口 IP，再通过该代理核验 Binance 权限并加密保存。绑定后，该 Key 的权限与余额查询、成交同步与统计、计划行情与下单全部经过该代理。代理参数变化会清除旧确认；完整 URL 解析后立即清空，代理密码保存后仅加密存储且不再回显。
建议做法为竞赛计划使用单独的 API Key。不要让人工策略与自动计划同时操作同一账户、同一交易对；这会影响订单状态和成本核算。

TARGET SETTINGS

目标设置、重新计算与保存绑定

在“目标设置”选择比赛、目标名次和 API Key 后，实时计算区域会基于当前公开快照与该 Key 的数据展示建议。点击目标门槛可手动输入数值，所有下方缺口和预估会据此重新计算。

  1. 公开快照活动、门槛、奖励
  2. 个人 API余额、成交与成本
  3. 浏览器预览目标缺口与可承受交易量
  4. 确认保存选择并锁定 API Key
  5. 服务端复算再次验证门槛与参数
  6. 终端执行保存成功后自动跳转
成本模式以奖励价值减去手续费、价格磨损等成本，再保留设定利润。默认最低保留利润为 20%，返佣默认 0。
门槛模式按目标门槛与安全倍数评估所需交易量。适合先估算达到某档的规模，不能替代实际成本核算。
价格磨损按照订单簿卖一 / 买一价差估计。手续费单独计入，市价成交、部分成交或清仓仍可能产生额外磨损。

COMPETITION ENTRY

比赛报名检查：自动核验与人工跳过

选择 API Key 与比赛启动计划时读取该 Key 的 UID、比赛期成交和可用榜单证据。
自动核验通过绿色状态系统找到了足够的 Binance 证据；可以启动计划。
证据不足黄色状态前往 Binance 活动页点击“立即参加”，再刷新自动核验。
人工确认跳过已记录跳过允许继续启动，但不等于 Binance 自动核验通过；后续页面会保留该区别。

报名后榜单或比赛期成交数据可能尚未更新，因此自动核验暂时不足并不等于未报名。请使用“前往 Binance 报名”进入官方活动页；人工确认只跳过检查，不能把状态伪装成自动通过。

EXECUTION LOGIC

启动与执行逻辑

两种下单类型共享启动前的权限、报名、余额和风控预检，但订单类型、等待机制、成交后的处理以及异常处理完全不同。下面分别说明，不应混用。

默认策略 · LIMIT MAKER / LIMIT GTC

尽可能 0 价格磨损刷到目标量

目标是在不主动吃单的前提下累积成交量。它优先排队，不保证马上成交；手续费不计入“价格磨损”。

  1. 01 · 预检锁定计划与可用额度验证登录、绑定 API Key、市场与交易对权限、报名状态、余额、单笔限额、全局开关和 Kill Switch。
  2. 02 · 限价挂单不主动吃单现货在当前买一提交 Maker 买单。合约按设置的价格区间与固定三层阶梯提交限价单；订单不接受会立即成交的价格。
  3. 03 · 等待与追价5 秒检查买一现货买单仍在买一则继续等待；离开买一才撤销未成交部分，并按最新买一重挂。部分成交只重挂剩余金额，不把已成交部分重复计算。
  4. 04 · 成本价卖出成交后生成保护卖单现货买入完成后，以所有已成交子单的实际平均成本提交 GTC 卖单。卖单尚未成交时，允许继续开新的买单批次。
  5. 05 · 待卖上限控制同时暴露的批次未卖批次达到“最大待卖成交单数”时暂停新增买单；已有卖单成交、释放名额后才恢复新买单。
  6. 06 · 达标或止损清理计划归属资产达到目标交易量后撤销本计划未成交卖单，再将计划产生的可售余币市价换回 USDT 并结束计划。若总持仓止损触发，只暂停当前买单、撤单并市价清仓；清仓成交量计入进度，随后自动恢复新买单。
成交计量只接受 Binance 明确返回的实际成交额；挂单成功、已提交或等待中都不计入进度。
Maker 被拒绝若订单会立刻成交，Binance 会拒绝。刷新买一后重挂；可恢复的拒绝不会把计划当成永久结束。
不确定回执超时、5xx 或 SSL 中断时先按客户端订单号对账，不会直接再发一笔相同订单。
可选总持仓止损仅适用于现货买一 / 成本价卖出逻辑，默认关闭。开启后，当计划未卖出持仓按当前买一估值的总亏损超过设定比例，系统暂停当前买单、撤销计划卖单，并市价卖出计划归属余币为 USDT。清仓成功后计划不会停止，而是继续提交新买单；只有清仓失败或状态不明确时才停止计划等待核对。
可选横盘波动率监测只限制新的买入挂单

适用于全部 0 磨损限价策略，默认关闭。开启后，系统只读取已收盘的 1 秒、30 秒、1 分钟和 5 分钟 K 线，并计算每个周期的 (最高价 − 最低价) ÷ 开盘价 × 100%。四个周期都不超过设定阈值才会创建新的买入挂单；30 秒由最近 30 根已收盘 1 秒 K 线聚合。行情超过阈值或公共行情暂不可用时，计划每 5 秒重试。

横盘不合规时只暂停新的买入挂单，绝不会因此撤销已经挂出的成本价卖单。成本价卖单仍会持续等待成交与对账；只有达到目标后的余币清理，或已开启并触发总持仓止损时，才会撤销计划卖单并执行后续处理。

即时成交策略 · MARKET

市价买卖循环

目标是快速完成一轮买入与卖出。市价单会立即对盘口成交，因此实际手续费和价格磨损都可能高于下单前估算。

  1. 01 · 预检确认本轮可执行与限价策略相同，先检查账号、报名、开关、交易对、最小下单额、可用余额和计划剩余交易量。
  2. 02 · 市价买入按本轮预算立即成交使用当前周期的单边金额提交市价买单。实际成交价和实际数量取 Binance 回执，不能用提交时的报价代替。
  3. 03 · 买单确认先确认，再卖出只有买单取得明确成交回执后，才会计算本轮可卖数量并进入下一步；买单未完成时，计划不会假设已有持仓。
  4. 04 · 市价卖出卖出本轮已买数量立即提交市价卖单。实际买卖两侧的成交额、手续费和任何价格差都写入本轮记录。
  5. 05 · 回执对账完成一轮才累计交易量买卖两侧均明确完成后，系统按实际成交额更新计划进度；未完整完成的轮次不会被当作成功循环。
  6. 06 · 下一轮或结束直到达标、暂停或触发阻断剩余交易量大于 0 时开始下一轮；达到目标后，只处理本计划可审计且高于启动基线的可售余币，尘埃余额保留。
价格磨损市价买入和市价卖出都会消耗盘口流动性。页面的买一 / 卖一价差仅是预估，不能保证覆盖实际市场移动。
异常处理任一订单回执不确定时，先查询原订单和最近订单。未确认前停止后续轮次，避免重复下单。
计划暂停暂停后不会启动新的循环。已有不确定订单仍需完成对账；恢复时以已确认的计划进度继续。

EXECUTION TERMINAL

终端执行：看状态、看日志、再决定动作

实时执行日志
显示下单、挂单成功、等待成交、撤单重挂、部分成交、网络重试和对账事件。波动率等待会明确标为“暂停新增挂单”；它不代表撤销成本价卖单。日志用于解释当前状态，而非仅报告最终成功或失败。
已执行 / 预计执行
已执行是已完成的计划周期；预计执行用于提示还需要多少轮。真实交易以实际成交额为准。
暂停与恢复
暂停优先阻止新增订单并撤销计划当前挂单。恢复时先检查已有订单与已完成进度，避免把不确定回执重复提交。

REMOTE EXECUTION

AWS Worker：把计划执行移出主服务

可在 Worker 管控页登记 EC2 节点，并把每把 API Key 单独绑定到指定节点。绑定后，开始、恢复、暂停和停止计划由主服务写入命令队列；Master 经 AWS SSM 主动读取 Worker 的回环 API 并安全下发命令，Worker 无需回连主服务公网 IP。

首次安装
在 Worker 管控页新增 AWS 节点，由控制面经 SSM 安装 Linux Worker 与 systemd 服务。Worker API 只监听 127.0.0.1，Token 仅写入 root 可读的环境文件。
开机与关机
主服务使用自身 IAM Role 调用 EC2 API。Worker 不接收 AWS 密钥，也不开放公网管理端口；EC2 启动后等待 Master 经 SSM 抓取为“在线”再启动计划。
代码更新
发布带 SHA-256 的 Linux Worker 压缩包，然后从账户中心通过 SSM 下发更新。节点会校验 HTTPS、校验和，原子切换二进制并重启服务。
S3 版本库
“打包并上传”会校验 SHA-256，把当前代码构建结果上传到私有且已启用版本控制的 S3 Bucket，并在数据库记录 Bucket、Object Key、VersionId 和代码版本。Worker 通过短时预签名 HTTPS URL 下载指定 S3 版本，不持有 AWS 长期凭据。
断线恢复
Worker 每次启动会生成新的 Boot ID，Master 从快照读取活跃计划。控制面只对“数据库仍在运行、但新进程未持有”的计划补发幂等恢复命令，避免重复下单。
未绑定 API
为兼容本地开发，未绑定节点的 API 继续由主服务本地执行。生产环境应逐把 Key 绑定节点，并确认卡片显示正确的节点、区域和在线状态。
安全要求Worker API 只能监听 EC2 回环地址；Worker Token 只显示一次并应像 API 密钥一样保管。EC2 实例使用最小权限 SSM Role，控制面 IAM 仅允许管理已标记的 Worker 实例和指定的 S3 发布前缀。S3 Bucket 必须保持私有并启用 Versioning，不要把预签名 URL 持久化。禁止把 Binance Secret、代理密码或 AWS 密钥写入发布包、systemd 日志或命令载荷。

ECONOMICS

损耗、收益与 7 天交易量

同步成交指定 API Key + 指定市场 + 指定交易对
分类核算手续费、磨损、已知净损益
终端展示已发生与预计分开显示
指标含义使用边界
已换算手续费已同步成交产生的手续费，按可获得的价格换算为 USDT。没有可换算价格的费用不会被伪造进总额。
磨损已同步现货成交以 FIFO 配对时，买入成本减去卖出收入的结果。未配对现货持仓不计入已知净损益。
已知净损益已扣手续费与磨损的已知结果。不包含无法配对或无法换算的数据。
历史日结今天以前的同步成交按 UTC 日期汇总并持久化到 SQLite；今天的数据保持实时。重复同步会幂等重算历史日结，补到的合约平仓会修正套保收益。
比赛奖励比赛结束满 3 天后的同币种现货卖出按奖励变现处理；纯现货收益 = 现货价值 − 现货手续费。结束后不足 3 天的卖出仍按普通现货成交处理；奖励卖出不消耗普通 FIFO 持仓，也不产生价格磨损，图表单列为“奖励变现”。
套保奖励同日存在同币种合约平仓时，收益 = 现货价值 + 合约已实现盈亏 − 现货手续费 − 合约平仓手续费。以 Binance 已同步成交和非零 realizedPnl 作为平仓证据。
7 天交易量点击目标卡“7 天交易量”只查看该 API Key、该交易对、该市场的已同步成交。没有成交时应显示 0，而不是沿用其他交易对的成交量。

TROUBLESHOOTING

常见状态与处理

数据质量显示 BLOCKED检查当前活动是否已有快照

新比赛若尚未采集到快照，活动详情和门槛可以为空；这不应让全局数据质量标记为 BLOCKED。等待下一次采集或切换至已有快照的活动。

报名检查证据不足去 Binance 报名后刷新自动核验

先点击“前往 Binance 报名”进入官方活动页并完成参与，再返回点击“刷新自动核验”。若活动数据延迟，可使用“我已确认，跳过检查”，但它不会变成自动核验通过。

Binance 网络临时不可达系统会按安全方式重试和对账

SSL、EOF、5xx 或超时并不表示订单一定失败。系统会先按客户端订单号查询原订单；状态仍不确定时不会盲目重复下单。

Maker 订单会立刻成交调整到买一或等待盘口变化

Maker-only 订单若会立刻吃单，Binance 会拒绝。现货策略会在买一挂单；如果价格离开买一，5 秒检查后撤销未成交部分并按新买一重挂。

已保存但看不到任务前往终端执行并检查 API Key 筛选

保存成功后会跳转到终端总览。若筛选了某个 API Key，请改为“全部 API Key”或选中保存方案绑定的那一把 Key。