报错分类速查
| 错误代码 / 关键词 | 类型 | 跳到 |
|---|---|---|
IP whitelist / Invalid IP | IP 不匹配 | Section 1 |
Invalid API-key / Permission denied | 权限不足 | Section 2 |
Too many requests / 429 / 418 | 限流 | Section 3 |
Timestamp / recvWindow | 时钟偏差 | Section 4 |
Section 1 · IP whitelist mismatch
典型报错:Invalid API-key, IP, or permissions for action
根因:你的 API 密钥绑定了 IP 白名单,但发起请求的 IP 不在名单里。
⚠️ 当前阶段最常见的情形:你自己给这把密钥设了 IP 白名单(比如填了你自己电脑的 IP),但我们是从我们的服务器发请求的,不在你的名单里。
解决:
- 登录 Binance → API Management → 找到贴给我们的那把密钥
- 看 Restrict access to trusted IPs only 是否开着
- 如果开着:目前请先关掉它(改为不限制 IP)。我们的 IP 白名单功能尚未上线,还无法给你一个可填的固定地址 —— 上线后会在控制台显示应填的 IP 并通知你
- 这把密钥请只贴给我们用 —— 不要同时配给自己的电脑或其他工具,否则出问题很难定位
为什么值得在意:没有白名单,这把密钥一旦泄露,从任何 IP 都能用。
Section 2 · Permission insufficient
典型报错:This action is disabled on this account / API-key permissions do not allow this action
根因:API 密钥权限不全。
要求的最小权限组合:
| 权限 | 状态 |
|---|---|
| Enable Reading | ✅ 必开 |
| Enable Futures | ✅ 必开 |
| Enable Withdrawals(提现) | ❌ 永远关闭 |
| Internal Transfer(内部划转) | ❌ 永远关闭 |
| Universal Transfer(万能划转) | ❌ 永远关闭 |
| Portfolio Margin(组合保证金) | ❌ 必须关闭(开着合约接口不可用) |
| Restrict to trusted IPs | 🔜 功能待上线,当前请勿设置 |
解决:
- Binance → API Management → 找到那把密钥 → Edit restrictions
- 确认 Reading 和 Futures 都开;提现 / 内部划转 / 万能划转 全关
- 若账户开了 Portfolio Margin(组合保证金),需先关闭 —— 否则币安的合约接口整个不可用
- 保存(可能需要 2FA)
改完权限后回控制台点「重新检测」即可,不需要重贴密钥。
Section 3 · Rate limit(限流)
典型报错:Too many requests · IP banned until <timestamp>(429 / 418)/ Rate limit exceeded
根因:Binance API 限流。我们的请求频率经过控制、不会自己触发;多半是你账户上有其他工具 / 脚本同时高频请求。
解决:
- 检查账户上还有哪些 API 密钥,关掉不必要的
- 不要用同一把密钥给多个工具同时跑
- 自己的脚本要遵守 Binance rate limit、加节流
- 等限流过期(报错里通常有 unban 时间)自动恢复
Section 4 · Timestamp / 时钟偏差
典型报错:Timestamp for this request is outside of the recvWindow
根因:发请求的机器时钟跟 Binance 服务器差超过 1 秒。执行端跑在 我们的服务器上,所以这属于我们侧的问题 —— 你不需要检查自己的电脑或手机,直接联系我们即可。
自动处理:执行端主机跑 NTP 时钟同步、启动校准,偶发漂移会自动重试。
如果持续报这个错:邮件联系支持,我们会帮你检查主机 NTP 状态。
其他常见错误
Order would immediately trigger:你的止损/限价立即会触发;执行端会自动调价重下,不用你管Insufficient balance:合约钱包 USDT 不足;充值或减仓Margin is insufficient:已用保证金过多;等持仓自动平 / 手动平掉部分仓位
仍未解决怎么办
邮件 [email protected],请附:
- 完整错误代码 + 报错截图
- 发生的精确时间(UTC + 你的时区)
- 最近是否改过 API 密钥 / IP / 账户设置
- 注册邮箱 + Binance UID 后 6 位