开发者平台
主题

错误码#

接口错误码#

错误码错误名称说明
80000SIGN_VERIFY_FAILED签名校验失败:签名无效或请求被篡改
80010NONCE_REPLAYED请求重复提交
80020ACTION_TYPE_MISMATCH操作类型与所调用接口不符
80030ILLEGAL_PARAMETER参数非法或请求体为空
80031MISSING_CLIENT_ORDER_ID缺少 clientOrderId
80032ACCOUNT_NOT_SETUP用户没有链上智能账户或钱包
80033LEVERAGE_TOO_LOW杠杆倍数低于最小值
80034LEVERAGE_PRECISION_INVALID杠杆倍数精度不合法
80035MARGIN_MODE_INVALID保证金模式不合法
80036POSITION_DIRECTION_INVALID持仓方向不合法
80037LEVERAGE_EXCEEDS_TIER杠杆倍数超过当前档位上限
80038INSTRUMENT_ISOLATED_ONLY该合约仅支持逐仓,不能切换为全仓
80039ISOLATED_POSITION_NOT_FOUND调整保证金时,该资产不存在逐仓仓位
80040RATE_LIMITED请求过于频繁,触发限流
80041ORDERS_STILL_EXIST切换保证金模式前,该合约仍有挂单
80042REDUCE_ONLY_TPSL_FORBIDDENReduce-Only 订单不可携带 TPSL
80043PARTIAL_POSITION_TPSL_FIELD_IMMUTABLE部分仓位 TPSL 的不可变字段被修改
80044ORDER_SIZE_BELOW_MINIMUM下单数量低于 minTradeAmount
80045INVALID_CLIENT_ORDER_IDclientOrderId 格式、区域或来源不合法
80050FEATURE_RESTRICTED当前用户所在地区或合规策略不允许使用该功能
80058CALLDATA_INVALIDcalldata 或 action payload 非法
80060AGENT_NOT_AUTHORIZED签名恢复出的地址不是当前 OpenAPI 用户的有效 Agent
80061CREATE_SUB_ACCOUNT_NOT_ALLOWED当前主账户未获准创建子账户
80062EXCHANGE_OS_TRADE_FROZEN当前用户的全部 Exchange OS 交易操作已被冻结
80063EXCHANGE_OS_SPOT_BUY_FROZEN当前用户的 Spot 买入操作已被冻结
80064EXCHANGE_OS_SPOT_TRADE_FROZEN当前用户的 Spot 交易操作已被冻结
80065EXCHANGE_OS_PERP_OPEN_FROZEN当前用户的 Perps 开仓或加仓操作已被冻结
80066EXCHANGE_OS_MARGIN_TRANSFER_FROZEN当前用户的逐仓减保证金或保证金模式切换操作已被冻结
80067API_KEY_AUTHENTICATION_FAILEDOpenAPI API Key、签名、时间戳、Passphrase 或权限认证失败
80068OPENAPI_AUTH_CROSS_SITE_NOT_SUPPORTED当前接口不支持跨站点 API Key
80069OPENAPI_AUTH_API_FROZENAPI Key 已被冻结
80070OPENAPI_AUTH_ENVIRONMENT_MISMATCHAPI Key 与当前 Broker 域不匹配
80071OPENAPI_AUTH_TIMESTAMP_EXPIRED请求时间戳已过期
80072OPENAPI_AUTH_ACCESS_KEY_REQUIRED缺少 OK-ACCESS-KEY 请求头
80073OPENAPI_AUTH_PASSPHRASE_REQUIRED缺少 OK-ACCESS-PASSPHRASE 请求头
80074OPENAPI_AUTH_PASSPHRASE_INVALIDOK-ACCESS-PASSPHRASE 无效
80075OPENAPI_AUTH_SIGNATURE_REQUIRED缺少 OK-ACCESS-SIGN 请求头
80076OPENAPI_AUTH_TIMESTAMP_REQUIRED缺少 OK-ACCESS-TIMESTAMP 请求头
80077OPENAPI_AUTH_BROKER_ID_MISMATCHAPI Key 的 Broker ID 不匹配
80078OPENAPI_AUTH_IP_INVALID请求 IP 无效或不在白名单中
80079OPENAPI_AUTH_ACCESS_KEY_INVALIDOK-ACCESS-KEY 无效
80080OPENAPI_AUTH_TIMESTAMP_INVALIDOK-ACCESS-TIMESTAMP 无效
80081OPENAPI_AUTH_SIGNATURE_INVALID请求签名无效
80082OPENAPI_AUTH_AUTHORITY_INVALIDAPI Key 权限无效
80083OPENAPI_AUTH_REQUEST_METHOD_INVALID请求方法无效
80084OPENAPI_AUTH_API_KEY_NOT_FOUNDAPI Key 不存在
80085OPENAPI_AUTH_PERMISSION_DENIEDAPI Key 缺少所需权限
80086OPENAPI_AUTH_COLO_RESTRICTED请求被机房或 IP 限制策略拦截
80087OPENAPI_AUTH_BASE_COIN_NOT_PERMITTEDAPI Key 没有该币种的交易权限
80088OPENAPI_AUTH_BIZ_LINE_NOT_PERMITTEDAPI Key 没有该业务线的交易权限
80101INVALID_ARGUMENT参数无效,例如请求体过大、格式非法或被后端拒绝
80102RESOURCE_NOT_FOUND请求的资源不存在
80103NOT_LEADER当前服务节点不可处理,请重试
80104DUPLICATE_TX重复请求,该交易已提交过
80105CONFLICT状态冲突,资源正忙,请稍后重试
80106TX_NOT_CONFIRMED请求已受理但超时未确认,可稍后查询结果
80107INTERNAL_ERROR服务端内部错误
80108NO_MARKET_DATA请求合法,但上游行情源没有返回该标的数据
80109INDEX_NOT_FOUND请求的行情指数不存在
80110GATEWAY_TIMEOUT请求超时,结果未知
80111USER_NOT_FOUND请求的用户不存在
80200INVALID_TRANSACTION无效交易
80201GENERIC_MESSAGE通用错误消息
80202INSUFFICIENT_BALANCE余额不足
80203INSUFFICIENT_MARGIN保证金不足
80204NONCE_VALIDATION_FAILED链上交易序号校验失败
80205ACCOUNT_NOT_FOUND账户不存在
80206INVALID_SUB_ACCOUNT无效子账户操作
80207INVALID_REFERRAL无效 referral 操作
80208ASSET_NOT_FOUND币对或资产不存在
80209PORTFOLIO_NOT_FOUNDPortfolio 不存在
80210ORDER_NOT_FOUND订单不存在
80211MARGIN_TABLE_NOT_FOUND保证金分层表不存在
80212EXECUTION_FAILED执行失败
80213UNAUTHORIZED未授权
80214BALANCE_OVERFLOW余额溢出
80215MARK_PRICE_NOT_FOUND资产标记价缺失
80216POSITION_NOT_FOUND仓位不存在
80217MARGIN_CALCULATION_FAILED保证金计算失败
80218ORDER_EXECUTION_FAILEDFOK 未全成、IOC 无流动性或 Post-Only 穿价
80219ASSET_HALTED资产已暂停交易
80220ALREADY_EXISTS资源或状态已存在
80221RATE_LIMITED_CHAIN链侧操作限额耗尽,节流间隔未到
80222EXCEED_CANCEL_ALL_LIMITCancel-All 日限额超限
80223EXCEED_OPEN_ORDER_LIMIT挂单数量超限
80224BALANCE_NOT_FOUND指定 Token 余额不存在
80225MULTISIG_SINGLE_SIGN_DISALLOWED多签账户不可使用单签路径
80226MULTISIG_TARGET_NOW_NORMAL目标用户已不是多签账户
80227MULTISIG_THRESHOLD_NOT_MET多签阈值未达成
80228MULTISIG_OUTER_SIGNER_INVALID无效的多签外层签名者
80229MULTISIG_INNER_DIGEST_FAILED多签内层摘要计算失败
80230ORDER_BELOW_MIN_NOTIONAL下单名义额低于市场最小下单额
80231TOKEN_NOT_FOUND币种不存在
80232FILL_NOT_FOUND成交不存在或不属于当前用户
80233CASHFLOW_NOT_FOUND资金流水不存在或不属于当前用户
80234POST_ONLY_WOULD_CROSSPost-Only 会立即成交
80235PRICE_OUTSIDE_LIMIT_BAND限价超出价格带
80236BUY_PRICE_DEVIATES_BELOW_MID买价低于中间价偏离阈值
80237ORDER_ABOVE_MAX_NOTIONAL下单名义额超过上限
80238OPEN_INTEREST_EXCEEDS_PLATFORM未平仓合约数量超过平台上限
80239OPEN_INTEREST_EXCEEDS_USER未平仓合约数量超过用户上限
80240PLACE_TIER_NOTIONAL_EXCEEDED下单超过当前档位名义上限
80241PLACE_INSUFFICIENT_MARGIN下单保证金不足
80242REDUCE_ONLY_NO_POSITIONReduce-Only 没有对应仓位
80243CLOSE_SIZE_EXCEEDS_POSITION平仓量超过持仓数量
80244ASSET_SETTLEMENT_PENDING资产结算中,仅允许 Reduce-Only
80245TRIGGER_PRICE_EQUALS_REFERENCE计划委托触发价等于参考价
80246ALGO_SIZE_EXCEEDS_POSITION计划委托数量超过持仓数量
80247POSITION_TPSL_SIZE_EXCEEDS_POSITION仓位 TPSL 下单量超过持仓数量
80248STOP_ORDER_MODIFY_TARGET_NOT_FOUND计划委托改单目标不存在或已触发
80249TPSL_DIRECTION_AGAINST_PARENTTPSL 方向与父单相反
80250TP_LIMIT_PRICE_AGAINST_PARENTTP 限价位于父单错误一侧
80251TPSL_TRIGGER_CROSSED_REFERENCE仓位 TPSL 触发价已穿越参考价
80252TPSL_DUPLICATE_ON_PARENT单个订单只能包含一个 TP 和一个 SL
80253ENTIRE_POSITION_TPSL_DUPLICATE每个整仓仅允许一组 TP 和 SL
80254OA_TRIGGER_MARKET_CHILD_IMMUTABLEOA 触发市价子单不可修改
80255OA_TRIGGER_LIMIT_AMOUNT_IMMUTABLEOA 触发限价子单数量不可修改
80256OA_TP_LIMIT_CHILD_IMMUTABLEOA TP 限价子单不可修改
80257ENTIRE_POSITION_TPSL_SIZE_IMMUTABLE整仓 TPSL 数量不可修改
80258POSITION_MODE_SWITCH_BLOCKED存在挂单或持仓,不可切换仓位模式
80259LEVERAGE_ORDERS_EXCEED_LIMIT调整杠杆时挂单数量超限
80260LEVERAGE_INSUFFICIENT_MARGIN_CROSS全仓调整杠杆时保证金不足
80261ISOLATED_MARGIN_TRANSFER_INSUFFICIENT逐仓保证金划转不足
80262MARGIN_ADJUST_INSUFFICIENT调整保证金后保证金不足
80263MARGIN_ADJUST_AVAILABLE_INSUFFICIENT调整保证金时可用余额不足
80264LEVERAGE_INSUFFICIENT_MARGIN_ISOLATED逐仓调整杠杆时保证金不足
80265MODIFY_TARGET_NOT_FOUND改单目标不存在或已终态
80266MODIFY_ASSET_SETTLEMENT_PENDING资产结算中,改单被拒绝
80267PLAN_MODIFY_TRIGGER_PRICE_EQUALS_REFERENCE计划改单触发价等于参考价
80268TPSL_MODIFY_TRIGGER_PRICE_EQUALS_REFERENCE仓位 TPSL 改单触发价等于参考价
80269PLAN_TRIGGER_CROSSED_REFERENCE计划委托触发方向不符
80270PLAN_MODIFY_TRIGGER_CROSSED_REFERENCE计划改单触发方向不符
80271TPSL_MODIFY_TRIGGER_CROSSED_REFERENCE仓位 TPSL 改单触发价已穿越参考价
80272TPSL_MODIFY_SIZE_EXCEEDS_POSITION仓位 TPSL 改单量超过持仓
80273CANCEL_CLOID_NOT_MATCHED按 clientOrderId 撤单时未找到目标
80274MODIFY_CLOID_NOT_MATCHED按 clientOrderId 改单时未找到目标
80275PLAN_MODIFY_CLOID_NOT_MATCHED按 clientOrderId 修改计划委托时未找到目标
80276MARKET_KIND_NOT_SUPPORTED当前操作不支持所提交的市场类型
80277WIRE_MARKET_TYPE_MISMATCH请求中的 marketType 与 assetId 对应的市场类型不一致
80278MARKET_TRIGGER_PRICE_IMMUTABLE市价触发 TPSL 订单不可修改委托价格
80279PLAN_MARKET_TRIGGER_PRICE_IMMUTABLE市价触发计划委托不可修改委托价格
80280TP_LIMIT_PRICE_AGAINST_LATESTTP 限价位于最新价格的错误一侧
80281MARGIN_MODE_LEVERAGE_MISMATCH逐仓切换全仓前,多仓与空仓杠杆必须一致
80282MARGIN_MODE_INSUFFICIENT_TO_CROSS逐仓切换全仓后,全仓保证金不足
80283MARGIN_MODE_INSUFFICIENT_TO_ISOLATED全仓切换逐仓时,可用保证金不足
80284MODIFY_PARENT_PRICE_CONFLICTS_WITH_TPSL修改母单价格后,与附加 TPSL 触发价冲突
80285ISOLATED_POSITION_TIER_SWAP_MARGIN_INSUFFICIENT逐仓持仓跨档位迁移时,权益不足以覆盖最新档位要求
80286IOC_NO_LIQUIDITYIOC 或 FrontMarketIoc 订单没有可立即成交的流动性
80287TPSL_WIRE_SHAPE_INVALIDTPSL 或计划委托请求的 wire 结构不合法
80288MULTISIG_INNER_ACTION_NOT_ALLOWED多签信封内层 action 类型不允许
80289MULTISIG_ENVELOPE_RECONFIG_REJECTED多签信封不允许重新配置,只允许解除多签
80290MULTISIG_INNER_SIGNATURE_COUNT_INVALID多签信封内层签名数量超出允许范围
80291MULTISIG_OUTER_SIGNER_IS_SELF多签账户自身不能作为外层签名者
80900BACKEND_UNAVAILABLE后端不可达或不可用
80901SUBMIT_FAILED请求已通过校验,但提交后端失败
80902NOT_YET_ENABLED接口已定义,但下游功能尚未启用
80903RPC_DATA_EMPTYRPC 返回空的 Data

公有 WebSocket 错误码#

错误码错误名称说明
60017UNRECOGNIZED_URL连接地址错误
60014LIMIT_EXCEEDED请求发送过快。单连接请求限流采用令牌桶,容量为 480,补充速率为每小时 480 个 Token
60012UNRECOGNIZED_REQUEST服务端无法解析消息,例如不是合法 JSON、op 不支持或 args 为空数组。整条请求被丢弃,不会部分生效
60033REQUEST_ID_NOT_LOGICAL请求中的 id 不合法,例如长度过长或包含不允许的字符。id 可选,但一旦传入必须合法
60013INVALID_ARGSargs 数组中包含 null 元素。只有该元素被拒绝,同一请求中的其他元素仍会正常处理
60018CHANNEL_NOT_EXIST频道名称错误或当前环境未开放该频道,也可能是 assetId 缺失、为空或不存在
4004ws close服务端连续 30 秒未收到连接数据后主动关闭连接。客户端即使没有业务请求,也需要定期发送心跳
4006ABNORMAL_DISCONNECTION服务端发生异常,连接被主动关闭。客户端可以重连并重新订阅

私有 WebSocket 错误码#

错误码错误名称说明
60017UNRECOGNIZED_URL连接地址错误
60014LIMIT_EXCEEDED请求发送过快。单连接请求限流采用令牌桶,容量为 480,补充速率为每小时 480 个 Token
60033REQUEST_ID_NOT_LOGICAL登录或订阅请求中的 id 不合法,整条请求被丢弃
60012UNRECOGNIZED_REQUEST登录请求无法解析,例如 args 缺失、为空数组、包含 null,或缺少 apiKey、passphrase、timestamp、sign
60026OAUTH_AND_APIKEY_BATCH_NOT_SUPPORTED同一个 op=login 同时传入 OAuth Token 和 API Key。一次登录只能使用一种凭证
60031NOT_ALLOW_MULTIPLE_LOGIN一条连接只允许登录一个账户。已经登录、上一次登录仍在处理或本次请求包含多个账户时返回
60027PARAMETER_IS_EMPTY登录必填参数为空,msg 会说明具体缺少的字段
60005INVALID_ACCESS_KEYAPI Key 无效,例如格式不是 UUID 或用户中心判定该 API Key 不可用
60004INVALID_ACCESS_TIMESTAMPtimestamp 不是数字或无法解析。应传 Unix 时间戳
60006TIMESTAMP_EXPIREDtimestamp 与服务端时间差过大,签名已过期
60007INVALID_SIGN签名校验失败,通常由待签字符串、字段顺序、Secret Key 或编码方式错误导致
60024API_LOGIN_PASSPHRASE_ERRORPassphrase 与 API Key 不匹配
60032APIKEY_NOT_EXISTAPI Key 不存在,可能已被删除或使用了错误的环境
60009LOGIN_FAILURE登录失败,但原因不属于上述错误
60029NO_ACTIVE_CEDEFI_ADDRESS仅 op=login-wallet 使用。API Key 校验通过,但账户没有可用的 CeDeFi 地址
60030NO_CEDEFI_ACCOUNT仅 op=login-wallet 使用。账户没有 CeDeFi 账户
63999INTERNAL_SYSTEM_ERROR登录过程中的服务端内部错误。可以重试,持续出现时应提供 connId 和时间点
51003ARGS_EMPTYop=connect_backends 或 op=send 的 args 缺失或为空数组
51004BACKEND_MISSING某个 arg 为 null,或缺少 backend,或 backend 为空白
51005BODY_INVALIDop=send 的 body 缺失、为空或不是 JSON 字符串
51011BACKEND_NOT_CONFIGURED请求中的 backend 未在当前服务配置
51013DUPLICATE_CONNECTbackend 通道已经建立或正在建立,不需要重复发送 connect_backends
51012BACKEND_UNAVAILABLE请求无法发送到后端。可能是后端不可达、正在重连或排队请求已达上限。该错误可重试
60018CHANNEL_NOT_EXIST订阅频道不在私有网关频道列表中,可能是频道名称错误或当前环境未开放
0CODE_CONNECTED不是错误。表示 backend 通道已就绪,之前确认的订阅已自动恢复
50011CODE_DISCONNECT不是最终错误。backend 通道断开,但 WebSocket 连接仍保留,服务端会自动重连
50012CODE_COMPLETEDbackend 通道主动正常关闭,恢复方式与 CODE_DISCONNECT 相同
4004ws close服务端连续 30 秒未收到连接数据后主动关闭连接。登录和订阅后也需要维持心跳
4006ABNORMAL_DISCONNECTION服务端处理连接时发生未预期的内部异常
61001UNSUPPORTED_CHANNEL频道无效或不受支持
61002INVALID_ARGS参数异常
61003UNKNOWN_OPop 无效或不受支持
61004REQUEST_DATA_DESERIALIZATION_FAILEDrequest.data 反序列化失败
61005INVALID_USER_ADDRESS用户地址无效
61006INVALID_VAULT_ADDRESSVault 地址无效