币安订单同步

1. 建表

首次使用需执行 SQL 建表：

mysql -u user -p auto_trade_sys < backend/database/add_binance_sync_tables.sql

2. 定时任务脚本

sync_binance_orders.py 从币安拉取各账号最近 6 小时的订单/成交，去重写入 DB。

# 同步所有有效账号
python scripts/sync_binance_orders.py

# 指定账号
python scripts/sync_binance_orders.py -a 2

# 拉取最近 12 小时
python scripts/sync_binance_orders.py --hours 12

# 多账号时减少账号间隔（默认 90 秒，避免限频）
python scripts/sync_binance_orders.py --delay-between-accounts 60

3. Crontab 配置示例

每 3 小时的第 0 分钟执行一次（与 6 小时拉取窗口重叠，便于去重）：

0 */3 * * * cd /path/to/auto_trade_sys && /path/to/.venv/bin/python scripts/sync_binance_orders.py >> logs/sync_binance.log 2>&1

延时说明：因定时任务为每 3 小时跑一次，页面或统计里看到的「币安成交」数据存在一定延时，最多可能滞后约 3 小时；如需最新可手动执行一次脚本。

或每 6 小时：

0 */6 * * * cd /path/to/auto_trade_sys && /path/to/.venv/bin/python scripts/sync_binance_orders.py >> logs/sync_binance.log 2>&1

4. 限频说明

多账号时每个账号之间默认等待 90 秒，可用 --delay-between-accounts 调整
单账号内已降低并发（Semaphore 2）和请求间隔，减少触发 "Way too many requests" 封 IP
若已被封，需等待提示时间后重试；建议 crontab 间隔不少于 3 小时

5. 数据管理

管理后台「数据管理」-「币安订单/成交查询」从 DB 读取，不再调用币安 API。

6. 账户余额快照（总资产缓存）

同步脚本在拉取每个账号的订单/成交后，会顺带调用一次该账号的 futures_account 取余额，并写入 account_snapshots 表。管理员仪表板「总资产 (USDT)」即对各账号该表最近一条快照的 total_balance 汇总，不每次请求币安。若从未跑过本脚本（或脚本报错未写入快照），总资产会显示 0；跑一次后即可有数据。

2.1 KiB Raw Blame History Unescape Escape