Error Code

Code	Description
-2011 Unknown order sent	The specified order could not be found or is no longer valid for this operation. Check whether the orderId or origClientOrderId is correct, whether the order has already been filled or canceled, and whether the symbol matches the original order. Query open or historical orders before retrying cancel or query requests.
26 operation not allowed	The requested operation is not permitted in the current context. Check whether the endpoint supports this action, whether the account or sub-account status allows the operation, and whether any platform restrictions apply. Confirm the request parameters and account type meet the endpoint requirements.
400 api key required	The request is missing a valid API key. Make sure the X-MEXC-APIKEY header (or the API key field required by the endpoint) is included, correctly copied, and not empty. Verify that the client is sending authenticated requests for endpoints that require an API key.
401 No authority	The request was not authorized. Check whether the API key and secret are correct, whether the API key is still active, and whether the key has the permissions required for this endpoint. Confirm that signing, timestamps, and request parameters are valid.
403 Access Denied	Access to the requested resource or endpoint was denied. This error may relate to request frequency, request format, or platform access rules. Confirm that the request format is correct and that call frequency complies with endpoint rate limits. If a temporary restriction was triggered by excessive request frequency, stop calling and retry later. Contact MEXC customer service or API support if the issue persists.
429 Too Many Requests	The request frequency may have exceeded the endpoint rate limit. Reduce the request rate, avoid sending many concurrent requests in a short period, and retry later. Check the rate-limit rules of the corresponding endpoint in the API documentation.
500 Internal error	An internal server error occurred while processing the request. The failure may be temporary. Retry later after checking whether the operation already succeeded (for example, query order or balance status before resubmitting). Contact MEXC customer service or API support if the issue persists.
503 service not available, please try again	The service is temporarily unavailable. Retry later with backoff. Before retrying trade or transfer operations, query the relevant order, transfer, or account status to avoid duplicate submissions. Contact MEXC customer service or API support if the issue persists.
504 Gateway Time-out	The request timed out before a response was received. The operation may or may not have completed on the server. Query the order, transfer, or account result before retrying. Check network stability, reduce payload complexity where applicable, and retry later. Contact MEXC customer service or API support if the issue persists.
602 Signature verification failed	Signature verification failed. Check the API secret, signature algorithm, parameter ordering, character encoding, and whether all required request parameters were included when generating the signature. Make sure the signed parameters match the parameters actually sent in the request, and confirm the timestamp is valid.
10001 user does not exist	The specified user could not be found. Check whether the user ID or account identifier is correct, whether the account exists, and whether the API key belongs to the intended MEXC account. Confirm that sub-account or master-account references are valid for the endpoint.
10007 bad symbol	The symbol parameter is invalid or not recognized. Check whether the symbol name is spelled correctly, uses the expected format, and is supported by the endpoint. Confirm the trading pair exists and is available for the requested operation.
10015 user id cannot be null	A required user ID parameter is missing. Check whether all mandatory user-related fields are included, whether parameter names match the API documentation, and whether null or empty values were sent by mistake.
10072 invalid access key	The API access key is invalid. Check whether the API key was copied completely, belongs to the correct MEXC account, and has not been deleted or disabled. Create a new API key and update the client configuration if the original key is unavailable.
10073 invalid Request-Time	The request time value is invalid. Confirm the request time header or timestamp field uses the format required by the endpoint, is expressed correctly (including milliseconds if required), and reflects the current time. Synchronize local system time with a reliable time source.
10095 amount cannot be null	The amount parameter is missing. Check whether all required amount fields are included, parameter names are correct, and values are not null or empty.
10096 amount decimal places is too long	The amount exceeds the allowed decimal precision. Check the symbol or currency precision rules in the API documentation and exchange information, and adjust the amount to the permitted number of decimal places.
10097 amount is error	The amount value is invalid. Check whether the amount format is correct, within allowed limits, meets minimum and maximum requirements, and uses the correct precision for the symbol or currency.
10098 risk control system detected abnormal	The platform risk control system flagged abnormal activity related to this request. Review account status, recent operations, and request parameters. Retry later if appropriate, and avoid repeated identical submissions in a short period. Contact MEXC customer service or API support if the issue persists.
10099 user sub account does not open	The sub-account feature may not be enabled for this user. Check whether sub-accounts are activated for the master account, whether the correct sub-account identifier is used, and whether the endpoint requires an enabled sub-account.
10100 this currency transfer is not supported	The requested currency is not supported for this transfer operation. Check whether the currency code is correct, whether transfers are enabled for that asset, and whether the transfer type supports the selected currency.
10101 Insufficient balance	The account does not have enough available balance for this operation. Check available balance (excluding locked or frozen funds), confirm the amount and fees, and make sure no other pending orders or transfers are reserving the same funds.
10102 amount cannot be zero or negative	The amount must be greater than zero. Check that amount fields are positive numbers and meet the minimum amount requirements for the symbol or operation.
10103 this account transfer is not supported	This transfer type is not supported for the account or route specified. Check whether the source and destination account types are valid for the endpoint, whether the transfer path is supported, and whether account status allows transfers.
10200 transfer operation processing	A transfer operation for this request is already being processed. Avoid submitting duplicate transfer requests with the same parameters. Query transfer history or status before retrying.
10201 transfer in failed	The inbound transfer failed. Check source account balance, transfer parameters, currency support, account status, and any platform restrictions. Query transfer records to confirm whether a partial or related operation completed before retrying.
10202 transfer out failed	The outbound transfer failed. Check available balance, transfer limits, destination account validity, and whether transfers are enabled for the account or currency. Query transfer history before resubmitting.
10206 transfer is disabled	Transfers are currently disabled for this account or operation type. Check account status, platform announcements, and whether the transfer function is temporarily restricted. Retry later or contact MEXC customer service or API support if the issue persists.
10211 transfer is forbidden	The transfer is not allowed under current conditions. Check account permissions, transfer type, currency support, risk controls, and whether the source or destination account is restricted.
10212 This withdrawal address is not on the commonly used address list or has been invalidated	The withdrawal address is not on the approved commonly used address list or has been invalidated. Check whether the address was added and verified in the account settings, whether the address is still active, and whether withdrawal whitelist or address-book rules apply.
10216 no address available. Please try again later	No withdrawal or deposit address is currently available for this request. This may be temporary. Retry later, confirm the network and currency are supported, and check whether address generation is required through the corresponding endpoint first.
10219 asset flow writing failed please try again	The system failed to record the asset flow for this operation. The operation may not have completed successfully. Query account balance, order status, or transfer history before retrying to avoid duplicate actions. Retry later if no record of the operation exists.
10222 currency cannot be null	The currency parameter is missing. Check whether the currency field is included, spelled correctly, and not null or empty.
10232 currency does not exist	The specified currency was not found. Check whether the currency code is correct and supported by the platform and the endpoint.
10259 Intermediate account does not configured in redisredis	A system configuration issue prevented completion of the operation. Retry later. Query the operation result before resubmitting. Contact MEXC customer service or API support if the issue persists.
10265 Due to risk control, withdrawal is unavailable, please try again later	Withdrawal is temporarily unavailable due to risk control. Retry later, review recent account activity and withdrawal parameters, and check platform announcements. Contact MEXC customer service or API support if the issue persists.
10268 remark length is too long	The remark or memo field exceeds the allowed length. Shorten the remark to within the limit specified in the API documentation and retry.
11444 This feature is temporarily unavailable. For details, please refer to our official announcement. Thank you for your understanding and cooperation	This feature is temporarily unavailable. Check official MEXC announcements for maintenance or restriction notices. Retry later after the announced recovery time, if applicable. Contact MEXC customer service or API support if you need further clarification.
20001 subsystem is not supported	The requested subsystem or business type is not supported by this endpoint. Check whether the endpoint, account type, and operation parameters match the supported subsystem in the API documentation.
20002 Internal system error please contact support	An internal system error occurred. Retry later after verifying whether the operation already completed. Record the request time, endpoint, parameters, and error response. Contact MEXC customer service or API support if the issue persists.
22222 record does not exist	The requested record was not found. Check whether the ID or reference parameter is correct, whether the record has expired or been removed, and whether the query scope (time range, symbol, account) is appropriate.
30000 suspended transaction for the symbol	Trading for this symbol is suspended. Check whether the symbol is open for trading, review platform announcements, and confirm the symbol status through market or exchange information endpoints.
30001 The current transaction direction is not allowed to place an order	The order side or direction is not allowed for this symbol or account under current conditions. Check supported order sides, symbol trading rules, and account restrictions.
30002 The minimum transaction volume cannot be less than :	The order quantity is below the minimum allowed for this symbol. Check the minimum order size in exchange information or symbol rules and increase the quantity accordingly. The exact minimum value is returned by the trading engine or symbol configuration.
30003 The maximum transaction volume cannot be greater than :	The order quantity exceeds the maximum allowed for this symbol. Check the maximum order size in exchange information or symbol rules and reduce the quantity accordingly. The exact maximum value is returned by the trading engine or symbol configuration.
30004 Insufficient position	There is not enough position available for this operation (for example, close or reduce). Check current holdings, locked quantity, and open orders that may reserve position.
30005 Oversold	The sell quantity exceeds available holdings. Check available balance or position, open sell orders, and locked assets before placing the order.
30010 no valid trade price	No valid price is available for this order under current market conditions. Check order type, price parameter, symbol status, and market liquidity. For market orders, confirm market trading is enabled for the symbol.
30014 invalid symbol	The symbol parameter is invalid. Check spelling, format, and whether the symbol exists and supports the requested operation.
30016 trading disabled	Trading is disabled for this symbol or account. Check symbol status, platform announcements, and account trading permissions.
30018 market order is disabled	Market orders are disabled for this symbol. Use a supported order type or check whether limit orders or other order types are available.
30019 api market order is disabled	API market orders are disabled for this symbol. Check symbol API trading rules and use a supported order type if market orders via API are restricted.
30020 no permission for the symbol	The account may not have permission to trade this symbol. Check API key permissions, account type, symbol access rules, and regional or account-level restrictions.
30021 invalid symbol	The symbol parameter is invalid. Check spelling, format, and whether the symbol exists and is available for the requested endpoint.
30025 no exist opponent order	No matching counterparty order is available for this request (for example, certain market or matching conditions). Check order type, price, symbol liquidity, and retry when market conditions change.
30026 invalid order ids	One or more order IDs are invalid. Check whether order IDs are correct, belong to the account, and match the symbol. Query order status before retrying batch operations.
30027 The currency has reached the maximum position limit, the buying is suspended	The maximum position limit for this asset has been reached and buying is suspended. Check current position, platform position limits, and reduce exposure or wait until limits allow new buys.
30028 The currency triggered the platform risk control, the selling is suspended	Platform risk control has suspended selling for this asset. Check platform announcements and account status. Retry later or contact MEXC customer service or API support if the issue persists.
30029 Cannot exceed the maximum order limit	The number of open orders exceeds the allowed limit. Cancel unnecessary open orders or reduce pending order count before placing new orders.
30032 Cannot exceed the maximum position	The position size would exceed the allowed maximum. Check current position, open orders, and symbol position limits before placing the order.
30041 current order type can not place order	The specified order type cannot be used for this request. Check supported order types for the symbol and endpoint, and verify parameters such as type, timeInForce, and related fields.
33333 param is error	One or more request parameters are invalid. Check parameter names, types, formats, required fields, value ranges, and precision against the API documentation for this endpoint.
44444 param cannot be null	A required parameter is missing or null. Check all mandatory fields for the endpoint and ensure none are empty or omitted.
60005 your account is abnormal	The account status appears abnormal. Check account restrictions, security status, KYC status, and recent platform notices. Contact MEXC customer service or API support if the issue persists.
70011 Pair user ban trade apikey	Trading via API may be restricted for this user or trading pair. Check account status, API key permissions, symbol access, and whether API trading is enabled for the pair. Review platform announcements and contact MEXC customer service or API support if the issue persists.
700001 API-key format invalid	The API key format is invalid. Check whether the API key was copied completely and whether it belongs to the correct MEXC account. If the API key has been deleted or is no longer valid, create a new API key and update it in the client.
700002 Signature for this request is not valid	Signature verification failed. Check the API secret, signature algorithm, parameter ordering, character encoding, and whether all required request parameters were included when generating the signature. Make sure the signed parameters are identical to the parameters actually sent in the request.
700003 Timestamp for this request is outside of the recvWindow	The request timestamp is outside the permitted receive window. Synchronize the local system time with a reliable time source, confirm that the timestamp is expressed in milliseconds, and send the request promptly after generating the signature.
700004 Param 'origClientOrderId' or 'orderId' must be sent, but both were empty/null	Either orderId or origClientOrderId must be provided. Include at least one valid order identifier when calling cancel or query order endpoints.
700005 recvWindow must less than 60000	The recvWindow value exceeds the allowed maximum. Set recvWindow to a value within the permitted range (less than 60000 as indicated by the error message) and ensure the request is sent soon after the timestamp is generated.
700006 IP non white list	The request IP is not on the API key IP whitelist. Check the IP whitelist configured for the API key, confirm the outbound IP used by your server or application, and update the whitelist if needed.
700007 No permission to access the endpoint	The API key may not have permission to access this endpoint. Check API key permission settings, account type, and whether the endpoint requires specific scopes (for example, trade, withdraw, or sub-account).
700008 Illegal characters found in parameter	One or more parameters contain illegal characters. Check parameter values for unsupported symbols, encoding issues, or disallowed characters, and align inputs with the format required by the API documentation.
730001 Pair not found	The specified trading pair or business pair could not be found. Check whether the symbol or pair parameter is correct and whether it is supported by the current endpoint.
730002 Your input param is invalid	One or more input parameters are invalid. Check parameter names, types, formats, required fields, and value ranges against the API documentation for this endpoint.
730000 Request failed, please contact the customer service	The request failed due to an unspecified error. Review request parameters, account status, and API key permissions. Record the request details and error response, retry later if appropriate, and contact MEXC customer service or API support if the issue persists.
730001 User information error	The system could not retrieve or validate the required user information. Check whether the account exists, whether the API key belongs to the correct account, and whether the account type and status meet the endpoint requirements.
730002 Parameter error	One or more parameters are invalid or missing. Check required fields, parameter names, data types, formats, and allowed values for this endpoint.
730003 Unsupported operation, please contact the customer service	The requested operation is not supported in the current context. Check endpoint documentation, account type, and parameters. Contact MEXC customer service or API support if you believe the operation should be available.
730100 Unusual user status	The user account status is unusual and may block this operation. Check account restrictions, security status, KYC status, and sub-account state. Contact MEXC customer service or API support if the issue persists.
730600 Sub-account Name cannot be null	The sub-account name is missing. Provide a non-empty sub-account name that meets the naming rules for the endpoint.
730601 Sub-account Name must be a combination of 8-32 letters and numbers	The sub-account name does not meet length or character requirements. Use 8–32 characters consisting of letters and numbers only.
730602 Sub-account remarks cannot be null	The sub-account remarks field is missing. Provide the required remarks value as specified by the endpoint.
730700 API KEY remarks cannot be null	The API key remarks field is missing. Provide a non-empty remarks value when creating or updating the API key.
730701 API KEY permission cannot be null	The API key permission setting is missing. Specify the required permission values according to the endpoint documentation.
730702 API KEY permission does not exist	The specified API key permission is not valid. Check available permission options in the API documentation and use supported permission values only.
730703 The IP information is incorrect, and a maximum of 10 IPs are allowed to be bound only	The IP whitelist configuration is invalid or exceeds the limit. Check IP format, remove excess entries, and ensure no more than 10 IP addresses are bound to the API key.
730704 The bound IP format is incorrect, please refill	One or more IP addresses in the whitelist are in an invalid format. Use valid IPv4 or IPv6 format as required and resubmit the IP list.
730705 At most 30 groups of Api Keys are allowed to be created only	The maximum number of API keys for this account has been reached. Delete unused API keys before creating new ones, or manage existing keys instead of creating additional ones.
730706 API KEY information does not exist	The specified API key could not be found. Check whether the access key is correct, belongs to the account, and has not been deleted.
730707 accessKey cannot be null	The access key parameter is missing. Include a valid API access key in the request.
730101 The user Name already exists	The sub-account or user name is already in use. Choose a different name that satisfies naming rules and is not already registered under the account.
140001 sub account does not exist	The specified sub-account does not exist. Check the sub-account name or identifier, confirm it was created under the master account, and verify spelling and format.
140002 sub account is forbidden	The sub-account is forbidden or restricted from this operation. Check sub-account status, permissions, and whether the account has been disabled or restricted. Contact MEXC customer service or API support if the issue persists.