Skip to content

Business Status Codes (Body status)

HTTP status is fixed to 200; read the business result from body status. All body status values are defined only here; individual APIs do not repeat them.

statusMeaningCommon scenarios
200SuccessBusiness completed
400Parameter errorMissing/invalid Header or signing params; required fields empty (e.g. exchange/withdraw trade_sn, query without order ID)
401Auth failedSignature invalid, timestamp expired, nonce replay, application not found
403ForbiddenIP not whitelisted, OpenAPI not enabled, abnormal account state
404Not foundOrder or receive account does not exist
500System errorQuote/rate failure, create failure
503UnavailableAPI under maintenance
1403Invalid quote / amount mismatchQuote missing, expired, or amount does not match quote
1404Illegal parameterInvalid amount/precision, illegal currency, illegal notify_url, fee charge type not in enum
1405Not configured / account abnormalRate not configured; pay/receive wallet missing; receive account inactive or address empty (contact ops)
1406Risk controlReceive/withdraw amount below/above per-tx limit; fee ≥ submitted amount when deducting from payout
1407Insufficient balancePay wallet available balance insufficient
1408Duplicate order IDMerchant trade_sn already exists
1409Deduct amount mismatchWithdraw deduct_amount does not match recalculated result