币安 API -1003 限频/封禁说明

错误含义

APIError(code=-1003): Way too many requests; IP ... banned until 1771041059726
表示当前 IP 请求过于频繁，被临时封禁，直到指定时间戳（毫秒）后自动解除。

如何查看「还要等多久」

时间戳 1771041059726 是毫秒，表示封禁解除时间（Unix 时间戳，毫秒）。

在项目根目录执行：

python3 -c "
from datetime import datetime, timezone
ts_ms = 1771041059726   # 替换成你日志里的时间戳
utc = datetime.fromtimestamp(ts_ms/1000, tz=timezone.utc)
now = datetime.now(timezone.utc)
delta = utc - now
print('解封时间(UTC):', utc.strftime('%Y-%m-%d %H:%M:%S'))
print('当前时间(UTC):', now.strftime('%Y-%m-%d %H:%M:%S'))
if delta.total_seconds() > 0:
    print('还需等待:', delta.days, '天', delta.seconds//3600, '小时', (delta.seconds%3600)//60, '分钟')
else:
    print('已过解封时间，可重试；若仍报错可等几分钟或换网络。')
"

把上面脚本里的 1771041059726 换成你实际日志中的 banned until 后面的数字即可。

如何减少再次被限/封禁

拉大扫描间隔：全局配置里把 SCAN_INTERVAL 调大（如 900 → 1200 或 1800），降低整体请求频率。
缩小扫描范围：适当减小 MAX_SCAN_SYMBOLS、TOP_N_SYMBOLS，减少单次扫描的 API 调用量。
并发已做限制：market_scanner 已用信号量限制并发（如 3），避免同时打爆；若仍触限，可再减小并发或增加批次间延迟。
错误提示：日志里「分析超时（10秒）」多是因为当时已被限频/封禁导致请求挂起或失败，解封后一般会恢复。

解封后若仍偶发 -1003，可先等 1～2 分钟再跑，或临时增大 SCAN_INTERVAL 再观察。

获取持仓/成交超时（TimeoutError）

若日志出现「获取持仓信息最终失败 (已重试 7 次): TimeoutError」或「获取成交记录失败 XXX (已重试 5 次): TimeoutError」：

网络/限频：与 -1003 类似，可能是当时网络抖动或请求排队，重试已用 60 秒超时 × 多轮；过几分钟通常恢复。
适当拉长只读超时（可选）：在运行交易进程的环境里设置环境变量
READ_ONLY_REQUEST_TIMEOUT=90（默认 60 秒），只读接口（持仓、成交、交易对信息）单次等待时间会变长，不影响下单/止损止盈的快速失败。
本次已做：获取交易对信息（如 ENAUSDT）增加 60 秒超时 + 3 次重试；获取成交记录后几次重试间隔改为 2 秒；开仓失败时会打出完整异常与堆栈，便于排查。

近期改动是否增加请求量？

不会。 近期「止损/止盈按保证金封顶」（USE_MARGIN_CAP_FOR_SL、USE_MARGIN_CAP_FOR_TP）只改动了 risk_manager 里 SL/TP 价格的计算方式，没有新增任何对币安 API 的调用。
-1003 来自原有的请求：如 get_open_positions、get_account_balance、sync_positions_with_binance、策略轮询、持仓/挂单同步等。要降低 -1003 概率，请拉大 SCAN_INTERVAL、减小扫描/同步频率（见上文「如何减少再次被限/封禁」），或改用 WebSocket 获取行情/持仓（若已接入）。

拿不到余额时，止盈止损还能正常执行吗？

能。只要止损/止盈已经以条件单形式挂在币安（STOP_MARKET / TAKE_PROFIT_MARKET），触发与成交都由币安撮合引擎执行，不依赖本机是否还能调 API、能否拿到余额或持仓。

已挂在交易所的 SL/TP：即使本机拿不到余额、持仓接口报错或 IP 被临时封禁，价格触及后仍会按交易所订单正常触发、平仓。
依赖本机的部分：若在封禁期间新开仓或需要补挂 SL/TP，会因请求失败而无法下单；已存在仓位若之前已成功调用 _ensure_exchange_sltp_orders 并挂上保护单，则不受影响。

结论：拿不到余额/持仓只影响「本机展示与同步、新开仓、补挂单」；已挂在币安上的止盈止损单会照常执行，可放心。

4.1 KiB Raw Blame History Unescape Escape