4.0 KiB
4.0 KiB
API Key 使用方式与 IP 限频说明
一、获取余额、市场报价：每个账号用自己的 API Key 吗？
是的。每个账号都用自己配置的 API Key。
1. 后端 Web API（前端请求「我的余额」「持仓」等）
- 请求会带上当前登录用户/选择的 account_id。
- 后端用
Account.get_credentials(account_id)取该账号的BINANCE_API_KEY/BINANCE_API_SECRET。 - 用这份 Key 创建
BinanceClient，再调get_account_balance()、get_ticker_24h()、持仓、下单等。 - 结论：账号 A 的请求用 A 的 Key，账号 B 用 B 的 Key，互不混用。
2. 交易进程（自动交易 / 扫描）
- 每个账号一个独立进程（由 supervisor 按 account 起多个
trading_system.main）。 - 每个进程启动时通过环境变量
ATS_ACCOUNT_ID指定自己是哪个账号。 - 配置通过
ConfigManager.for_account(account_id)读取，其中 BINANCE_API_KEY / BINANCE_API_SECRET 来自该 account_id 在accounts表里配置的密钥。 - 该进程内所有调用（获取余额、获取交易对列表、获取行情 ticker/K 线、下单）都用同一个 BinanceClient，即该账号的 API Key。
- 结论：每个账号的扫描与交易都只用自己的 Key，没有“统一一个 Key”的情况。
3. 推荐服务（仅行情、不下单）
recommendations_maindeliberately 使用 空 API Key（BinanceClient(api_key="", api_secret="")），只调公开接口（行情、K 线等），不占用任何账号的 Key，也不读 account 的密钥。
二、-1003「IP 被封」和「轮转 API Key」的关系
错误示例：APIError(code=-1003): Way too many requests; IP(43.199.103.162) banned until ...
- 这里限制的是 IP，不是某个 API Key。
- 所有从你这台服务器（同一出口 IP）发出的请求，不管用哪个账号的 Key，都会算在同一个 IP 上。
- 所以：换用不同账号的 API Key 轮转，不能绕过或解除 IP 封禁；封禁期间用哪个 Key 都会失败。
轮转 Key 只有在币安按 API Key 维度限频时才有用；当前你遇到的是 IP 维度 的封禁，所以轮转无法解决“等多久才能用”的问题，只能等该 IP 解封时间到期。
三、为什么多账号时更容易触发 IP 封禁？
- 每个账号一个进程，每个进程都会自己做一整轮市场扫描：
get_all_usdt_pairs()- 对大量交易对再请求 K 线、ticker 等
- 若有 3 个账号，同一台机器上就是 3 份完整扫描，请求量约等于单账号的 3 倍，且都从同一 IP 发出，更容易触发「Way too many requests」和 IP 封禁。
四、可以怎么做来减少封禁 / 尽快恢复使用？
-
解封前
- 等日志里
banned until的时间戳过期（参见BINANCE_IP_BAN_1003.md里用脚本算「还要等多久」）。
- 等日志里
-
解封后降低同一 IP 的请求量
- 拉大 SCAN_INTERVAL（如 900 → 1200 或 1800 秒）。
- 适当减小 MAX_SCAN_SYMBOLS / TOP_N_SYMBOLS。
- 多账号时，考虑只用一个进程做扫描、结果写入 Redis，各账号进程只读，这样行情/扫描请求只打一份，从同一 IP 出去的请求会少很多（需改架构，可后续做）。
-
轮转 API Key
- 对解除当前这次 IP 封禁没有帮助。
- 若未来遇到的是「按 Key 限频」而不是「按 IP 封禁」，再考虑按 Key 轮转或分摊请求才有意义。
五、总结表
| 能力 | 谁在调用 | 用的 API Key |
|---|---|---|
| 获取余额 | 后端 / 交易进程 | 当前 account_id 的 Key |
| 获取市场报价等 | 交易进程 | 当前 account_id 的 Key |
| 推荐服务行情 | recommendations_main | 空 Key（仅公开接口） |
| -1003 IP 封禁 | - | 轮转 Key 无法绕过，需等解封并降请求量 |