常见错误码处理方法
本页说明常见错误码的触发场景及处理方式。完整错误码列表请参见 REST API 错误码 或 WebSocket 错误码。
WebSocket 错误
30002 — 不合法的请求
请求报文格式有误。检查订阅/请求报文是否为合法 JSON，且字段结构与文档一致。
30004 — 用户需要登录
订阅报文在登录成功返回之前就已发送。务必等到收到登录成功的响应后，再发送订阅消息。
认证错误
40006 — 无效的 ACCESS_KEY
检查请求头中的ACCESS-KEY是否正确。
40008 — 请求时间戳过期
请求中的时间戳与服务器时间偏差过大。调用获取服务器时间同步本地时钟。
40009 — sign 签名错误
常见原因及处理方式：
- 签名算法错误→ 参考签名文档
- 签名前对 queryString 或 body 做了 URL 编码（当币对名称含中文时会触发）→ 签名时不要对参数做 URL 编码
频率限制错误
429 — 请求次数过多
超过接口频率限制。降低请求频率，遵守各接口的频率限制规则。
40725 — 返回无映射信息
通常由服务器发布导致，用户在收到报错响应后重试即可
订单错误
25003 — 并发操作，请重试
单向持仓模式下，若全部只减仓单数量超过当前仓位数量时，系统会触发先撤后下，撮合引擎还未处理完撤单，新下单请求已到达。无需特殊操作，系统会阻止重复平仓，稍后重试即可。
25102 — 交易对停止交易维护
该交易对可能尚未支持 UTA 下单、未上线 v3，或正在维护中。
25101= 短期维护或未开放；25102= 较长维护期或即将下架；40309= 已完成下架。
25105 — 此合约暂不支持开仓操作
该交易对不支持开仓，或已下架。查看统一合约是否上线，或查阅下架公告。
25110 — 该币种不支持转入统一账户
该币种不支持转入统一账户，无法操作。
25212 — 重复的 clientOid
重复使用了同一个 clientOid。幂等会基于当前委托单的状态进行判断，即订单挂单期间clientOid不允许重复，成交或撤销后clientOid允许重复。
25229 — 总持仓超过了当前持仓条数限制
已达到最大仓位数量（200 条）。将仓位数量控制在 200 条以下，或创建子账户分散仓位。
25232 — 只减仓只会减少您的仓位
当存在非只减仓单，且两类委托数量之和超过仓位数量，同时非减仓单价格更优时会触发此错误。撤销或修改已有的非只减仓单后再下只减仓单。
25234 — 普通下单剩余数量为 0
触发了 IO 限仓。调整下单仓位后重试。查看详情
25567 — 超过最大下单合约数量
下单数量超过单笔下单量限制。参考获取交易产品信息中的 maxMarketOrderQty（市价单上限）和 maxOrderQty（限价单上限）。
25568 — 订单不符合改单要求
预设止盈止损订单和市价单不允许修改，不要对这两类订单执行改单操作。
25574 — 为保障现有只减仓订单，改单失败
存在同向的非只减仓单时，修改后的价格不允许比只减仓单的价格更优先成交。调整修改后的价格，使其不超过只减仓单的价格优先级。
45110 — 触发最小下单价值限制
下单价值低于最低限额（合约 5 USDT，现货 1 USDT）。注意统一账户中，后端会按交易对精度重设有效数量，可能静默压低实际价值（例如 SYRUPUSDT 步长为 10，下单 16 × 0.4484 → 有效数量 10 × 0.4484 = 4.484 USDT，会被拦截）。确保最终有效下单价值高于最低限额。
45116 — 当前账号持仓条数超过最大数量
已达到最大仓位数量（200 条）。将仓位数量控制在 200 条以下，或创建子账户分散仓位。
45119 — 此合约暂不支持开仓操作
交易对 status 已被限制或已下架。调用获取交易产品信息查看状态，或参考下架公告。
45121 — 合理标记价格偏离盘口过大，当前杠杆开仓风险较高
合理标记价格偏离市场价格过大，当前杠杆开仓风险较高。详见 Bitget 支持文章。
45001 — 未知错误
通常由服务器发布导致，用户在收到报错响应后重试即可
40908 — 并发操作失败
仓位较多时处理耗时超过平均水平，或先撤后挂场景下平仓单在撤单处理完成前到达。需等待上一笔操作完成后再发起新请求。
40710 — 账户状态异常
账户状态异常，联系客服处理。
40760 — 账户处于强平状态，无法下单
账户正在强平中，强平期间禁止交易和划转。等待强平处理完成后再操作。
40022 — 此账号该业务已被限制
两种常见原因：
- 子账户交易权限未开启 → 开启子账户交易权限
- 账户被风控限制 → 联系客服核实账户风控状态
40715 — 委托数量大于最大可开数量
已达到最大可开数量。调用获取最大可开可用查询当前限额。
40034 — 参数不存在
请求参数有误。对照 API 文档逐一核查入参。
40763 — 委托数量不能超过对应档位的最大量
仓位超过当前档位限制。参考仓位档位规则，调整仓位后重试。
40774 — 单边持仓时委托类型也必须是单边持仓类型
下单参数与当前持仓模式不匹配（tradeSide / posSide 错误）。按当前模式使用正确参数组合：
| 模式 | 操作 | 参数 |
|---|---|---|
| 双向持仓 | 开多 | side=buy&posSide=long |
| 双向持仓 | 开空 | side=sell&posSide=short |
| 双向持仓 | 平多 | side=sell&posSide=long |
| 双向持仓 | 平空 | side=buy&posSide=short |
| 单向持仓 | 开多 | side=buy |
| 单向持仓 | 开空 | side=sell |
| 单向持仓 | 平多 | side=sell&reduceOnly=yes |
| 单向持仓 | 平空 | side=buy&reduceOnly=yes |
40815 — 委托价格高于最高买价
买单价格超过当前最高买入价。下调委托价格后重试。
40816 — 委托价格低于最低卖价
卖单价格低于当前最低卖出价。上调委托价格后重试。
40922 — 只允许修改未成交的限价单
订单已完全成交、撤销或被拒绝，无法修改。只能对未成交或部分成交（有剩余数量）的订单进行改单。
41117 — 卖出价格不能低于限制价格
价格超出了交易对允许的买卖价差范围（buyLimitPriceRatio / sellLimitPriceRatio）。参考获取交易对信息中的对应字段值，在允许范围内下单。
43027 — 不满足最小下单价值
买单时系统取标记价格与委托价格的较小值计算实际价值，若标记价格低于委托价格，即使委托价格恰好为 5 USDT 也可能被拦截。不要使用边界值下单，留出一定余量。
45118 — 达到委托总笔数上限
当前挂单数量已达到平台限制。各账户类型限制如下：
- 合约： 每个交易对最多 200 笔未成交委托，每条业务线最多 400 笔（基于 UID 限制）
- 最大仓位条数： 每条业务线 200 条（基于 UID 限制）
- 现货杠杆： 每个交易对/UID 最多 100 笔，总计最多 1,000 笔
- 现货： 每个交易对/UID 最多 200 笔，总计最多 1,000 笔
减少挂单数量后重试。
22046 — 下单价格超过最小价格限制
订单价格低于最小价格限制。上调价格至高于最小限制后重试。
22047 — 下单价格超过最大价格限制
订单价格超出最大价格限制。下调价格至最大限制范围内后重试。
22048 — 超过个人限额，无法委托
可借币数量已达到个人限额。调用获取最大可开可用查询当前最大可开。
22067 — ADL 处理中，禁止操作该币对
该币对正在进行 ADL（自动减仓）处理，期间禁止操作。等待 ADL 处理完成后再重试。
12001 — 当前最多可使用 {0}
账户余额不足。充值后重试。
13008 — 交易员最小交易量为 {0}
下单数量低于交易员最小下单量要求。增加下单数量至满足最小要求后重试。