Managed Transfers Error Dictionary

Updated error values that can be returned by Managed Transfers APIs

Possible Ineligibility Reasons

Here are the reasons why holdings cannot be transferred in some cases.

Configure Transfer Errors

Error CodeDescriptionLevel Found
NoEligibleNetworksNone of the networks supported by Source and Target accounts can be used for the transfer. Individual reasons specifying why a particular network cannot be used may vary.Holdings
SymbolDoesNotMatchThe symbol that was requested for the transfer is different from the holding’s symbolHoldings
NotSupportedForTransferByTargetNone of the networks for that token are eligible to transfer TO the source. This is often due to the client not supporting the token for transfer.Holdings
NotSupportedForTransferBySourceNone of the networks for that token are eligible to transfer FROM the source. This is often due to Mesh or the integration not supporting the token for transfer.Holdings
AmountNotSufficientThe (amount to be transferred + the gas fee) is more than the available balanceNetwork
NoTargetNetworkFoundTarget addresses/institution do not contain the corresponding network, so this network cannot be used for the transferNetwork
GasFeeAssetBalanceNotEnoughThe amount of the asset is sufficient, but there’s not enough balance of the gas fee’s asset (e.g. not enough ETH to send USDC)Network

Preview Transfer Errors

Statuses:

  • Succeeded
  • Failed

Error messages (when status = failed)

Error CodeError Message
NetworkIdMissing{(TransferToAddress.NetworkId)} field was not provided.
AddressMissing{(TransferToAddress.Address)} field was not provided.
SymbolMissing{(TransferToAddress.Symbol)} field was not provided.
UnsupportedSymbolByNetworkNetwork does not currently support the requested symbol.
InvalidAddressPatternTarget address does not match network '{0}' address pattern.
NetworkNotFoundNetwork not found.
NetworkDisabledNetwork '{0}' is currently disabled and cannot be used.
InsufficientFundsInsufficient '{0}' funds.
InsufficientFeeFundsInsufficient '{0}' funds for transfer fees.
EmptyWalletSymbolBalanceSource wallet '{0}' balance is empty.
KycRequiredThe provided '{0}' account requires KYC to be completed to perform transfers.
DepositAmountTooLowThe requested amount is lower than the minimum amount that can be accepted by the target institution.
WrongPreviewRequestFromAuthTokenMissing{(PreviewTransferRequest.FromAuthToken)} is a mandatory field and should be provided.
WrongPreviewRequestNoSymbol{(PreviewTransferRequest.Symbol)} is a mandatory field and should be provided.
WrongPreviewRequestInvalidToAuthToken{(PreviewTransferRequest.ToAuthToken)} is invalid.
WrongPreviewRequestToDataEither {(PreviewTransferRequest.ToAuthToken)} with {(PreviewTransferRequest.ToType)} or {(PreviewTransferRequest.ToAddress)} should be provided.
WrongPreviewRequestAmountBoth {(PreviewTransferRequest.AmountInFiat)} and {(PreviewTransferRequest.Amount)} can not be provided.
WrongPreviewRequestNoAmountEither {(PreviewTransferRequest.AmountInFiat)} or {(PreviewTransferRequest.Amount)} should be provided.
WrongPreviewRequestUnsupportedSymbolBySourceWalletSymbol to transfer not supported by the source wallet over the requested network.
WrongPreviewRequestUnsupportedSymbolByTargetWalletSymbol to transfer not supported by the target wallet over the requested network.
WrongPreviewRequestNetworkRequested network is not supported by the source wallet.
PriceNotFoundCould not fetch '{0}' price.
AmountMoreThanWithdrawMaximumCould not preview the transfer. The requested amount {previewRequest.Amount} {requestDto.Request.Symbol} is greater than the maximum allowed amount ({minimumMaximumAmount.WithdrawMaximumAmount} {requestDto.Request.Symbol}).
AmountLessThanWithdrawMinimumCould not preview the transfer. The requested amount {previewRequest.Amount} {requestDto.Request.Symbol} is below the minimum allowable threshold ({minimumMaximumAmount.WithdrawMinimumAmount} {requestDto.Request.Symbol}).

Execute Transfer Errors

Statuses:

  • Succeeded
  • Failed
  • MfaRequired
  • EmailConfirmationRequired
  • DeviceConfirmationRequired
  • MfaFailed
  • AddressWhitelistRequired

Error messages (when status = failed)

Error CodeError Message
PreviewExpiredThe preview is expired.
TransferIsRequestedThe transfer is already requested.
PreviewNotFoundCould not find the preview.
AddressNotRegisteredThe target address is not registered.