# 常见错误码处理方法
本页说明常见错误码的触发场景及处理方式。完整错误码列表请参见 [REST API 错误码](./restapi) 或 [WebSocket 错误码](./websocket)。
## WebSocket 错误
### 30002 — 不合法的请求
请求报文格式有误。检查订阅/请求报文是否为合法 JSON，且字段结构与文档一致。
### 30004 — 用户需要登录
订阅报文在登录成功返回之前就已发送。务必等到收到登录成功的响应后，再发送订阅消息。
## 认证错误
### 40006 — 无效的 ACCESS\_KEY
检查请求头中的`ACCESS-KEY`是否正确。
### 40008 — 请求时间戳过期
请求中的时间戳与服务器时间偏差过大。调用[获取服务器时间](/zh-CN/docs/catalog/classic-common-public/classic-common#get-server-time)同步本地时钟。
### 40009 — sign 签名错误
常见原因及处理方式：
- **签名算法错误**→ 参考[签名文档](/zh-CN/docs/classic/rest-api#签名)
- **签名前对 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 限仓。调整下单仓位后重试。[查看详情](https://www.bitget.com/zh-CN/trade-info/oi_limit)
### 25567 — 超过最大下单合约数量
下单数量超过单笔下单量限制。参考[获取交易产品信息](/zh-CN/docs/catalog/market/market-data#get-instruments)中的 `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` 已被限制或已下架。调用[获取交易产品信息](/zh-CN/docs/catalog/market/market-data#get-instruments)查看状态，或参考下架公告。
### 45121 — 合理标记价格偏离盘口过大，当前杠杆开仓风险较高
合理标记价格偏离市场价格过大，当前杠杆开仓风险较高。详见 [Bitget 支持文章](https://www.bitget.com/zh-CN/support/articles/12560603775538)。
### 45001 — 未知错误
通常由服务器发布导致，用户在收到报错响应后重试即可
### 40908 — 并发操作失败
仓位较多时处理耗时超过平均水平，或先撤后挂场景下平仓单在撤单处理完成前到达。需等待上一笔操作完成后再发起新请求。
### 40710 — 账户状态异常
账户状态异常，联系客服处理。
### 40760 — 账户处于强平状态，无法下单
账户正在强平中，强平期间禁止交易和划转。等待强平处理完成后再操作。
### 40022 — 此账号该业务已被限制
两种常见原因：
- **子账户交易权限未开启** → 开启子账户交易权限
- **账户被风控限制** → 联系客服核实账户风控状态
### 40715 — 委托数量大于最大可开数量
已达到最大可开数量。调用[获取最大可开可用](/zh-CN/docs/catalog/trading/position-management#get-max-open-available)查询当前限额。
### 40034 — 参数不存在
请求参数有误。对照 API 文档逐一核查入参。
### 40763 — 委托数量不能超过对应档位的最大量
仓位超过当前档位限制。参考[仓位档位规则](https://www.bitget.com/zh-CN/trade-info/position-gear?symbolId=BTCUSDT_UMCBL)，调整仓位后重试。
### 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`）。参考[获取交易对信息](/zh-CN/docs/catalog/market/market-data#get-instruments)中的对应字段值，在允许范围内下单。
### 43027 — 不满足最小下单价值
买单时系统取标记价格与委托价格的较小值计算实际价值，若标记价格低于委托价格，即使委托价格恰好为 5 USDT 也可能被拦截。不要使用边界值下单，留出一定余量。
### 45118 — 达到委托总笔数上限
当前挂单数量已达到平台限制。各账户类型限制如下：
- **合约：** 每个交易对最多 200 笔未成交委托，每条业务线最多 400 笔（基于 UID 限制）
- **最大仓位条数：** 每条业务线 200 条（基于 UID 限制）
- **现货杠杆：** 每个交易对/UID 最多 100 笔，总计最多 1,000 笔
- **现货：** 每个交易对/UID 最多 200 笔，总计最多 1,000 笔
减少挂单数量后重试。
### 22046 — 下单价格超过最小价格限制
订单价格低于最小价格限制。上调价格至高于最小限制后重试。
### 22047 — 下单价格超过最大价格限制
订单价格超出最大价格限制。下调价格至最大限制范围内后重试。
### 22048 — 超过个人限额，无法委托
可借币数量已达到个人限额。调用[获取最大可开可用](/zh-CN/docs/catalog/trading/position-management#get-max-open-available)查询当前最大可开。
### 22067 — ADL 处理中，禁止操作该币对
该币对正在进行 ADL（自动减仓）处理，期间禁止操作。等待 ADL 处理完成后再重试。
### 12001 — 当前最多可使用 \{0\}
账户余额不足。充值后重试。
### 13008 — 交易员最小交易量为 \{0\}
下单数量低于交易员最小下单量要求。增加下单数量至满足最小要求后重试。