Skip to content

Error Codes

This page provides a comprehensive list of error codes you may encounter when using the Cactus Custody API.

Understanding Error Responses

All API responses follow a standard format:

{
  "code": 10381405,
  "message": "",
  "successful": false,
  "data": null
}
FieldDescription
codeThe error code number
successfulfalse for errors, true for successful requests
dataAdditional error details (if available)

Error Code Reference List

CodeDescriptionRecommended Action
403No AuthorizationVerify your API credentials and permissions
500System Error. In rare circumstances (e.g. high traffic), requests may be queued and time out at the API gateway's limit. The error code does not necessarily mean the request failed; it may still be processing on the backend.

GET requests: safe to retry.

POST requests : retry with the same identifier you sent originally (e.g. order_no, apply_id).

Contact support if it persists.

10000000System ErrorRetry the request. Contact support if it persists
10360002System ErrorIf this error occurs, please contact Cactus Support.
10360008API User is not activatedContact your administrator to activate your API user
10360015 Business line has no operation rightCheck business line permissions in your account settings
10360016AKID does not existVerify your AKID is correct. AKID can be found in your email. Please inform our team if there is no email sent to you.
10360018Project does not existCheck that the project/business line ID exists
10360026Signature Verification FailedReview the Authentication Guide and verify your signature generation
10360067Updated second verification.Wait 24 hours after changing 2FA settings. After the change, the asset cannot be withdrawn within 24 hours.
10360100Admin are not allowed to make API callsAPI access has been disabled. Only Operators with API permissions are allowed to make API requests.
10380007API service is not enabledContact Cactus Operations team to enable this feature.
10384304Source IP did not match the API user's whitelistAdd your IP address to the API IP Whitelist. Only administrators can perform this action: Login as Admin → User Configuration → API IP Whitelist
10380000Operation FailedCheck request parameters and retry
10380001No Data AvailablePlease retry the request or refer to the API documentation for further instructions.
10380002Parameter Error

Review the API documentation for the correct parameter format.

Common issue: Mismatch between business line, wallet code, and address. Verify the wallet code belongs to the business line, and the address exists under the wallet code.

10380003Duplicated DataThe resource already exists with the same identifier.
10382006Verification FailedCheck that all required verifications are completed.
10384000Name already existsUse a different name for the resource.
10384002Tag exceeds 250 charactersReduce tag length to 250 characters or less.
10381200Wallet Creation FailureCheck wallet parameters and try again.
10381201Please reduce the number of wallet you want to applyReduce the number of wallets in your request.
10381209Coin not supported.Verify the coin is supported. Check Supported Tokens.
10381300Current number of addresses has reached the upper limitContact Cactus support to request for more addresses.
10381301Please reduce the number of addresses or verify that you have sufficient remaining quota.Use the Get Wallet Information API and Get Address Limit API to verify available quota at the wallet or enterprise level.

If you require additional addresses, please reach out to the Cactus team.
10381302Number of addresses for a single application cannot exceed 50Split your request into batches of 50 or fewer
10381304Address application failedVerify address parameters and try again
10381305Address verification failedVerify the address format is valid for the specified chain
10381400 Single withdrawal limit exceededCheck your single transaction withdrawal limit
10381401The daily withdrawal limit has been exceeded.
Daily cycle: 00:00 to 23:59 UTC+0
Wait until the daily limit resets at 00:00 UTC
10381402The weekly withdrawal limit has been exceeded
Weekly cycle: Monday 00:00 to Sunday 23:59 UTC+0
Wait until the weekly limit resets on Monday 00:00 UTC
10381403The monthly withdrawal limit has been exceeded
Monthly cycle: 1st day of month 00:00 to last day of month 23:59 UTC+0
Wait until the monthly limit resets on the 1st at 00:00 UTC
10381405Insufficient balanceCheck wallet balance before creating withdrawal
10381407Failed to create orderReview order parameters and retry
10381408Incomplete Order InformationEnsure all required fields are provided
10381409Not all reviewers have reviewed the order.Ensure that there are enough reviewers to complete the review for this order, and the actual number of reviewers must meet the review count configured by the administrator under the business line’s withdrawal review settings.
10381410Withdrawal for coin is restrictedThis coin is temporarily restricted for withdrawal
10381412The withdraw rate too big or too smallUse Get Recommend Current Fee Rate API to check valid range
10381413Unable to withdraws full amount.Please check on your available amount that can be withdrawn at that point in time.
10381414Duplicated order number.Use a unique order number that was previously not used (ensure Idempotency)
10381415Withdrawal amount must be greater than 1Ensure amount is at least 1 (in smallest unit)
10381416Balance is not enough to advance the miner feeEnsure sufficient balance for both amount and fees
10381417Invalid memo format
Check memo format requirements for your chain
Requirements:
• Max 50 characters
• TON: No spaces
• XRP: Integer 0-4294967295
• STELLAR (MEMO_TEXT): Max 28 characters
• STELLAR (MEMO_HASH): Max 32 characters, hexadecimal
10381418Withdrawal amount should be less than the minimum withdrawal amountCheck minimum withdrawal amount for the token that you are withdrawing.
10381420Destination address limit exceeded.Reduce the number of destination addresses.
10381422The transaction was blocked due to a KYT alertPlease contact Cactus Custody Operations Team.
10381423Manual review rejected.Please contact Cactus Custody Operations Team.
10381424Destination address requires a tagFor XRP chain, a tag is required for your destination address. Ensure that it is filled in when making a withdrawal.
10389000Value lesser than minimum withdrawal amountIncrease withdrawal amount above minimum threshold.
10382000Review failedThe review submission failed. Verify review parameters and retry.
10382002Order has already been reviewedThis order has already been reviewed by the current user.
10382017This order does not existVerify the order number is correct.
10382022Order status not supportedThe current order status does not support this operation
10382023Order type not supportedThis operation is not supported for the current order type
10382024Order is exempted from reviewThis order does not require review
10382026Order has been canceledCannot perform operations on a canceled order
10382028Order cancellation errorPlease contact Cactus Custody Operations Team.
10382030The order does not allow the order creator to review/approve their own orderCheck if the Self Approval option under Withdrawal Approval has been enabled.
10381500The recipient address is not a whitelisted addressAdd the address to your whitelist before withdrawing
10381502The contract address is not a whitelisted addressAdd the contract address to your whitelist
10381507Transfer to EOA address is not allowedOnly contract addresses are allowed for this operation
10381600Business line does not existVerify the business line ID (b_id)
10381601Current user is not associated with any business lineContact administrator to assign you to a business line
10381602The business line has been disabledContact administrator to enable the business line
10381700Business line frozen.Contact support to resolve account freeze
10382103Withdrawal feature disabled.Contact the system administrator to verify that you have the required permissions.
10382104Duplicated order number.Generate a new unique order number and retry the transaction
10382105Insufficient available withdrawal balanceCheck account balance and reduce withdrawal amount or add funds
10382110Insufficient transferable balanceVerify available balance for transfer and adjust amount accordingly
10382116Failed to deduct from Buffer account, unfinished settlement orders existWait for pending settlement orders to complete before attempting withdrawal. Use Get Oasis Order Details to check on the status of your order
10382117Failed to deduct from Buffer account, user's maximum withdraw-able balance insufficient.Check maximum withdrawal limits and ensure amount is within allowed range
10382118Failed to deduct from Buffer account, failed to query balance from exchange.Retry after a few minutes; contact support if issue persists
10382119Withdrawal amount is less than the minimum withdrawal limit.Contact administrator to increase withdrawal amount to meet the minimum requirement
10382122Precision error for withdrawal or transfer amount.Adjust amount to match required decimal precision (view the decimal column for the precision for various token)
10382130Destination Oasis UID not in whitelistAdd the UID to whitelist before attempting transfer
10382131Destination Oasis UID account does not existVerify the UID inputted is correct
10386122Orders cannot be expeditedThis order is not eligible for acceleration
10386123Expedite or Cancellation Rates Too LowIncrease the gas price for acceleration/cancellation. Users can either manually add gas or use the Replace By Fee API to execute.
10386124Orders cannot be canceledThis order cannot be canceled in its current state
10388903The current currency is not tradableThis currency is not available for trading
10389002Insufficient balance in trading accountDeposit funds to your trading account
10389004Out of trading scopeTransaction exceeds allowed trading limits
10389007Failed to create trade orderReview order parameters and retry
10389008Price expiredGet a fresh quote and retry immediately
10389011Withdrawal is suspended on trading accountTrading account withdrawals are temporarily suspended
10389012Deposit is suspended on trading accountTrading account deposits are temporarily suspended
10389017Order cannot be cancelledThis order is not eligible for cancellation
10389018Trading function does not support this trading pairsUse a supported trading pair
10500001Trading pair not supportedCheck supported trading pairs via Get Trading Pairs API
10500002Payment wallet type not supportedUse a supported payment wallet type
10500003Receiving wallet type not supportedUse a supported receiving wallet type
10500004Available trading credit limit exceededReduce transaction amount or wait for credit limit reset
10500005Price deviation too largeGet a fresh quote and retry
10500006No matching wallet foundCreate a wallet for the specified coin and chain
10500007Payment wallet balance insufficientEnsure sufficient balance in payment wallet
10500008Failed to get coin market priceRetry after a few moments
10500009Receiving address secondary verification not completedComplete secondary verification for the receiving address
10500010Latest protocol not signedSign the latest OTC protocol agreement
10500011Wallet does not match the specified coinUse the correct wallet for the specified coin
10500012OTC receiving address is invalidVerify the receiving address format
10500013On-ramp only supports USDT or USDCUse USDT or USDC for on-ramp transactions
10500014OTC has not configured receiving address for the coin and chainContact support to configure receiving address
10500015FLYWING is not availableOTC service is temporarily unavailable
10500016UKey secondary verification failed. Error will only be thrown on the web dashboardThis error only appears on web dashboard, not API
20050002Unauthorized currency for integrated account.This currency is not authorized for integrated accounts
20050003Withdrawal is not allowed for integrated account.Withdrawals are disabled for integrated accounts
20050005Withdrawal for integrated account conditions are not met.Meet the required conditions before withdrawing
20050007Digital asset withdrawal for integrated account has hit its limit.Digital asset withdrawal limit exceeded
20050008Fiat withdrawal for integrated account has hit its limit.Fiat withdrawal limit exceeded
20050009Integrated account not enabled for business line.Enable integrated account for this business line

Still require assistance?

Provide our team with the following information:

  • Request URL
  • API nonce (can be found in your authentication request header: x-api-nonce)
  • Request query parameters or body