-2011 Unknown order sent | 指定的订单不存在或已无法用于当前操作。请检查 orderId 或 origClientOrderId 是否正确,订单是否已成交或撤销,以及交易对是否与原始订单一致。撤销或查询订单前,建议先查询当前挂单或历史订单。 |
26 operation not allowed | 当前上下文不允许执行该操作。请检查接口是否支持此操作、账户或子账户状态是否允许、是否存在平台限制,并确认请求参数与账户类型符合接口要求。 |
400 api key required | 请求缺少有效的 API Key。请确认已携带 X-MEXC-APIKEY 请求头(或接口要求的 API Key 字段),且 Key 完整复制、非空。需鉴权的接口请确保客户端已正确发送 API Key。 |
401 No authority | 请求未通过授权。请检查 API Key 与 Secret 是否正确、API Key 是否仍有效、是否具备该接口所需权限,并确认签名、时间戳及请求参数有效。 |
403 Access Denied | 拒绝访问所请求的资源或接口。该错误可能与请求频率、请求格式或平台访问规则有关。请确认请求格式正确,并检查调用频率是否符合接口限制。若因请求频率过高触发临时限制,请停止调用并稍后重试;若问题持续存在,请联系 MEXC 客服或 API 支持。 |
429 Too Many Requests | 请求频率可能已超过该接口的限速规则。请降低请求频率,避免短时间内大量并发请求,并稍后重试。请参阅 API 文档中对应接口的限速说明。 |
500 Internal error | 服务器内部错误,请求可能未完成。该错误可能为临时性。重试前请先查询订单或余额等,确认操作是否已成功,避免重复提交。若问题持续,请联系 MEXC 客服或 API 支持。 |
503 service not available, please try again | 服务暂时不可用。请稍后重试。重试交易或划转类操作前,请先查询相关订单、划转或账户状态,避免重复提交。若问题持续,请联系 MEXC 客服或 API 支持。 |
504 Gateway Time-out | 请求超时,未收到响应。操作可能在服务端已完成也可能未完成。重试前请先查询订单、划转或账户结果,并检查网络稳定性,稍后重试。若问题持续,请联系 MEXC 客服或 API 支持。 |
602 Signature verification failed | 签名校验失败。请检查 API Secret、签名算法、参数排序、字符编码,以及生成签名时是否包含所有必填参数。确认参与签名的参数与实际发送的参数一致,并验证时间戳有效。 |
10001 user does not exist | 找不到指定用户。请检查用户 ID 或账户标识是否正确、账户是否存在、API Key 是否属于目标 MEXC 账户,并确认主账户或子账户引用对该接口有效。 |
10007 bad symbol | 交易对(symbol)参数无效或无法识别。请检查名称拼写、格式是否符合要求,以及该交易对是否被当前接口支持。确认交易对存在且可用于所请求的操作。 |
10015 user id cannot be null | 缺少必填的用户 ID 参数。请检查是否遗漏用户相关必填字段、参数名是否与文档一致,以及是否误传 null 或空值。 |
10072 invalid access key | API 访问密钥(Access Key)无效。请检查 API Key 是否完整复制、是否属于正确的 MEXC 账户、是否已被删除或禁用。若原 Key 不可用,请创建新 Key 并更新客户端配置。 |
10073 invalid Request-Time | 请求时间(Request-Time)无效。请确认请求时间字段或时间戳格式符合接口要求(如需毫秒级请使用毫秒),并与当前时间一致。建议将本地系统时间与可靠时间源同步。 |
10095 amount cannot be null | 金额参数缺失。请检查必填金额字段是否已填写、参数名是否正确,且值不为 null 或空。 |
10096 amount decimal places is too long | 金额小数位数超过允许精度。请查阅 API 文档及交易对/币种精度规则,将金额调整为允许的 decimal 位数。 |
10097 amount is error | 金额无效。请检查金额格式是否正确、是否在允许范围内、是否满足最小/最大限制,以及精度是否符合交易对或币种要求。 |
10098 risk control system detected abnormal | 平台风控系统检测到与该请求相关的异常。请检查账户状态、近期操作及请求参数,避免短时间内重复提交相同请求,必要时稍后重试。若问题持续,请联系 MEXC 客服或 API 支持。 |
10099 user sub account does not open | 该用户可能尚未开通子账户功能。请确认主账户是否已启用子账户、是否使用了正确的子账户标识,以及该接口是否要求子账户已开通。 |
10100 this currency transfer is not supported | 该币种不支持当前划转操作。请检查币种代码是否正确、该资产是否支持划转,以及划转类型是否支持所选币种。 |
10101 Insufficient balance | 账户可用余额不足。请检查可用余额(不含冻结或锁定部分),确认金额及手续费,并留意是否有其他挂单或划转占用同一笔资金。 |
10102 amount cannot be zero or negative | 金额必须大于零。请确认金额字段为正数,并满足该交易对或操作的最小金额要求。 |
10103 this account transfer is not supported | 当前账户或划转路径不支持该划转类型。请检查源账户与目标账户类型是否有效、划转路径是否受支持,以及账户状态是否允许划转。 |
10200 transfer operation processing | 该划转请求正在处理中。请勿使用相同参数重复提交划转。重试前请先查询划转历史或状态。 |
10201 transfer in failed | 转入失败。请检查源账户余额、划转参数、币种支持、账户状态及平台限制。重试前请查询划转记录,确认是否已有部分或关联操作完成。 |
10202 transfer out failed | 转出失败。请检查可用余额、划转限额、目标账户是否有效,以及该账户或币种是否允许转出。重新提交前请先查询划转历史。 |
10206 transfer is disabled | 当前账户或操作类型的划转功能已关闭。请检查账户状态、平台公告,以及划转功能是否被临时限制。可稍后重试,或联系 MEXC 客服或 API 支持。 |
10211 transfer is forbidden | 当前条件下不允许划转。请检查账户权限、划转类型、币种支持、风控限制,以及源账户或目标账户是否受限。 |
10212 This withdrawal address is not on the commonly used address list or has been invalidated | 提币地址不在常用地址列表中或已失效。请检查地址是否已在账户设置中添加并验证、是否仍有效,以及是否启用了提币白名单或地址簿规则。 |
10216 no address available. Please try again later | 当前无可用提币或充值地址,可能为临时情况。请稍后重试,确认网络与币种受支持,并检查是否需要先通过对应接口生成地址。 |
10219 asset flow writing failed please try again | 系统未能写入资产流水,操作可能未成功完成。重试前请先查询账户余额、订单状态或划转历史,避免重复操作。若无相关记录,可稍后重试。 |
10222 currency cannot be null | 币种参数缺失。请检查币种字段是否已填写、拼写是否正确,且不为 null 或空。 |
10232 currency does not exist | 找不到指定币种。请检查币种代码是否正确,以及平台和当前接口是否支持该币种。 |
10259 Intermediate account does not configured in redisredis | 因系统配置问题,操作未能完成。请稍后重试,重新提交前先查询操作结果。若问题持续,请联系 MEXC 客服或 API 支持。 |
10265 Due to risk control, withdrawal is unavailable, please try again later | 因风控原因,提币暂时不可用。请稍后重试,并检查近期账户活动与提币参数,留意平台公告。若问题持续,请联系 MEXC 客服或 API 支持。 |
10268 remark length is too long | 备注(remark)或 memo 字段超过允许长度。请缩短备注至 API 文档规定的限制内后重试。 |
11444 This feature is temporarily unavailable. For details, please refer to our official announcement. Thank you for your understanding and cooperation | 该功能暂时不可用。请查阅 MEXC 官方公告了解维护或限制说明,在公告恢复时间后(如有)再重试。如需进一步说明,请联系 MEXC 客服或 API 支持。 |
20001 subsystem is not supported | 该接口不支持所请求的子系统或业务类型。请检查接口、账户类型及操作参数是否与 API 文档中支持的子系统一致。 |
20002 Internal system error please contact support | 发生内部系统错误。重试前请先确认操作是否已完成。请记录请求时间、接口、参数及错误返回。若问题持续,请联系 MEXC 客服或 API 支持。 |
22222 record does not exist | 找不到所请求的记录。请检查 ID 或引用参数是否正确、记录是否已过期或删除,以及查询范围(时间、交易对、账户)是否合适。 |
30000 suspended transaction for the symbol | 该交易对已暂停交易。请检查交易对是否开放交易、查阅平台公告,并通过行情或 exchangeInfo 等接口确认交易对状态。 |
30001 The current transaction direction is not allowed to place an order | 当前交易方向不允许下单。请检查该交易对支持的买卖方向、交易规则及账户限制。 |
30002 The minimum transaction volume cannot be less than : | 下单数量低于该交易对允许的最小值。请查阅 exchangeInfo 或交易对规则中的最小下单量并相应调整。具体最小值由交易引擎或交易对配置返回。 |
30003 The maximum transaction volume cannot be greater than : | 下单数量超过该交易对允许的最大值。请查阅 exchangeInfo 或交易对规则中的最大下单量并相应调整。具体最大值由交易引擎或交易对配置返回。 |
30004 Insufficient position | 可用持仓不足(例如平仓或减仓时)。请检查当前持仓、锁定数量及可能占用持仓的挂单。 |
30005 Oversold | 卖出数量超过可用持仓。下单前请检查可用余额或持仓、未成交卖单及锁定资产。 |
30010 no valid trade price | 当前市场条件下无有效成交价格。请检查订单类型、价格参数、交易对状态及市场流动性。若为市价单,请确认该交易对是否允许市价交易。 |
30014 invalid symbol | 交易对(symbol)无效。请检查拼写、格式,以及该交易对是否存在并支持所请求的操作。 |
30016 trading disabled | 该交易对或账户已禁用交易。请检查交易对状态、平台公告及账户交易权限。 |
30018 market order is disabled | 该交易对已禁用市价单。请改用支持的订单类型,或确认限价单等其他类型是否可用。 |
30019 api market order is disabled | 该交易对已禁用 API 市价单。请查阅交易对 API 交易规则,若 API 市价单受限,请改用支持的订单类型。 |
30020 no permission for the symbol | 账户可能没有该交易对的交易权限。请检查 API Key 权限、账户类型、交易对访问规则及地区或账户级限制。 |
30021 invalid symbol | 交易对(symbol)无效。请检查拼写、格式,以及该交易对是否存在并对当前接口可用。 |
30025 no exist opponent order | 无匹配的对手方订单(例如特定市价或撮合条件下)。请检查订单类型、价格、交易对流动性,并在市场条件变化后重试。 |
30026 invalid order ids | 一个或多个订单 ID 无效。请检查订单 ID 是否正确、是否属于当前账户并与交易对匹配。批量操作前请先查询订单状态。 |
30027 The currency has reached the maximum position limit, the buying is suspended | 该资产已达最大持仓限制,买入已暂停。请检查当前持仓及平台持仓限制,减仓或等待限制解除后再买入。 |
30028 The currency triggered the platform risk control, the selling is suspended | 平台风控已暂停该资产卖出。请查阅平台公告及账户状态,稍后重试或联系 MEXC 客服或 API 支持。 |
30029 Cannot exceed the maximum order limit | 未成交订单数量超过允许上限。请先撤销不必要的挂单或减少待处理订单后再下单。 |
30032 Cannot exceed the maximum position | 持仓将超过允许的最大值。下单前请检查当前持仓、未成交订单及交易对持仓限制。 |
30041 current order type can not place order | 当前订单类型不能用于此请求。请检查该交易对及接口支持的订单类型,并核对 type、timeInForce 等相关参数。 |
33333 param is error | 一个或多个请求参数无效。请对照 API 文档检查参数名、类型、格式、必填项、取值范围及精度。 |
44444 param cannot be null | 必填参数缺失或为 null。请检查该接口所有必填字段均已填写且非空。 |
60005 your account is abnormal | 账户状态异常。请检查账户限制、安全状态、KYC 状态及近期平台通知。若问题持续,请联系 MEXC 客服或 API 支持。 |
70011 Pair user ban trade apikey | 该用户或交易对的 API 交易可能受到限制。请检查账户状态、API Key 权限、交易对访问权限及是否允许 API 交易,并查阅平台公告。若问题持续,请联系 MEXC 客服或 API 支持。 |
700001 API-key format invalid | API Key 格式无效。请检查 API Key 是否完整复制、是否属于正确的 MEXC 账户。若 Key 已删除或失效,请创建新 Key 并在客户端更新。 |
700002 Signature for this request is not valid | 签名校验失败。请检查 API Secret、签名算法、参数排序、字符编码,以及生成签名时是否包含所有必填参数。确认参与签名的参数与实际发送的参数完全一致。 |
700003 Timestamp for this request is outside of the recvWindow | 请求时间戳超出允许的接收窗口(recvWindow)。请将本地系统时间与可靠时间源同步,确认时间戳为毫秒级,并在生成签名后尽快发送请求。 |
700004 Param 'origClientOrderId' or 'orderId' must be sent, but both were empty/null | 必须提供 orderId 或 origClientOrderId 至少其一。调用撤销或查询订单接口时,请传入有效的订单标识。 |
700005 recvWindow must less than 60000 | recvWindow 超过允许的最大值。请将 recvWindow 设置在允许范围内(错误信息提示须小于 60000),并在生成时间戳后尽快发送请求。 |
700006 IP non white list | 请求 IP 不在 API Key 的 IP 白名单中。请检查 API Key 配置的白名单、服务器或应用的实际出口 IP,并按需更新白名单。 |
700007 No permission to access the endpoint | API Key 可能没有访问该接口的权限。请检查 API Key 权限设置、账户类型,以及该接口是否需要特定权限范围(如交易、提币、子账户等)。 |
700008 Illegal characters found in parameter | 一个或多个参数包含非法字符。请检查参数值是否存在不支持的符号、编码问题或不允许的字符,并符合 API 文档要求的格式。 |
730001 Pair not found | 找不到指定的交易对或业务对(pair)。请检查 symbol 或 pair 参数是否正确,以及当前接口是否支持该交易对。 |
730002 Your input param is invalid | 一个或多个输入参数无效。请对照 API 文档检查参数名、类型、格式、必填项及取值范围。 |
730000 Request failed, please contact the customer service | 请求失败,原因未明确。请检查请求参数、账户状态及 API Key 权限,记录请求详情与错误返回,必要时稍后重试。若问题持续,请联系 MEXC 客服或 API 支持。 |
730001 User information error | 系统无法获取或校验所需的用户信息。请检查账户是否存在、API Key 是否属于正确账户,以及账户类型与状态是否满足接口要求。 |
730002 Parameter error | 一个或多个参数无效或缺失。请检查必填字段、参数名、数据类型、格式及允许取值。 |
730003 Unsupported operation, please contact the customer service | 当前上下文不支持所请求的操作。请查阅接口文档、账户类型及参数。若认为该操作应可用,请联系 MEXC 客服或 API 支持。 |
730100 Unusual user status | 用户账户状态异常,可能阻止当前操作。请检查账户限制、安全状态、KYC 状态及子账户状态。若问题持续,请联系 MEXC 客服或 API 支持。 |
730600 Sub-account Name cannot be null | 子账户名称缺失。请填写非空的子账户名称,并符合接口命名规则。 |
730601 Sub-account Name must be a combination of 8-32 letters and numbers | 子账户名称不符合长度或字符要求。请使用 8–32 位、仅含字母与数字的组合。 |
730602 Sub-account remarks cannot be null | 子账户备注缺失。请按接口要求填写备注字段。 |
730700 API KEY remarks cannot be null | API Key 备注缺失。创建或更新 API Key 时请填写非空备注。 |
730701 API KEY permission cannot be null | API Key 权限设置缺失。请按接口文档指定所需权限值。 |
730702 API KEY permission does not exist | 指定的 API Key 权限无效。请查阅 API 文档中的可用权限选项,仅使用支持的权限值。 |
730703 The IP information is incorrect, and a maximum of 10 IPs are allowed to be bound only | IP 白名单配置无效或超出限制。请检查 IP 格式、删除多余条目,并确保绑定 IP 不超过 10 个。 |
730704 The bound IP format is incorrect, please refill | 白名单中一个或多个 IP 格式不正确。请使用有效的 IPv4 或 IPv6 格式(按接口要求)并重新提交 IP 列表。 |
730705 At most 30 groups of Api Keys are allowed to be created only | 该账户 API Key 数量已达上限。请先删除不用的 Key 再创建,或管理现有 Key 而非继续新增。 |
730706 API KEY information does not exist | 找不到指定的 API Key。请检查 access key 是否正确、是否属于该账户、是否已被删除。 |
730707 accessKey cannot be null | accessKey 参数缺失。请在请求中传入有效的 API access key。 |
730101 The user Name already exists | 子账户或用户名已被占用。请选择符合命名规则且尚未注册的其他名称。 |
140001 sub account does not exist | 指定的子账户不存在。请检查子账户名称或标识是否正确、是否已在主账户下创建,并核对拼写与格式。 |
140002 sub account is forbidden | 该子账户被禁止或限制执行此操作。请检查子账户状态、权限及是否已被禁用或限制。若问题持续,请联系 MEXC 客服或 API 支持。 |