Skip to main content
Network response messages and their descriptions.
Network ResponseDescription
ACCOUNT_FROZEN_FOR_TOKENThe account is frozen and cannot transact with the token
TOKENS_PER_ACCOUNT_LIMIT_EXCEEDEDThe maximum number of token relations for a given account is exceeded
INVALID_TOKEN_IDThe token is invalid or does not exist
INVALID_TOKEN_DECIMALSInvalid token decimals
INVALID_TOKEN_INITIAL_SUPPLYInvalid token initial supply
INVALID_TREASURY_ACCOUNT_FOR_TOKENTreasury account does not exist or is deleted
INVALID_TOKEN_SYMBOLToken Symbol is not UTF-8 capitalized alphabetical string
TOKEN_HAS_NO_FREEZE_KEYFreeze key is not set on a token
TRANSFERS_NOT_ZERO_SUM_FOR_TOKENAmounts in the transfer list are not net-zero
MISSING_TOKEN_SYMBOLToken Symbol is not provided
TOKEN_SYMBOL_TOO_LONGToken Symbol is too long
ACCOUNT_KYC_NOT_GRANTED_FOR_TOKENKYC must be granted and the account does not have KYC granted
TOKEN_HAS_NO_KYC_KEYKYC key is not set on a token
INSUFFICIENT_TOKEN_BALANCEToken balance is not sufficient for the transaction
TOKEN_WAS_DELETEDToken transactions cannot be executed on deleted token
TOKEN_HAS_NO_SUPPLY_KEYThe supply key is not set on a token
TOKEN_HAS_NO_WIPE_KEYThe wipe key is not set on a token
INVALID_TOKEN_MINT_AMOUNTInvalid mint amount
INVALID_TOKEN_BURN_AMOUNTInvalid burn amount
TOKEN_NOT_ASSOCIATED_TO_ACCOUNTAccount has not been associated with an account
CANNOT_WIPE_TOKEN_TREASURY_ACCOUNTCannot execute wipe operation on treasury account
INVALID_KYC_KEYInvalid kyc key
INVALID_WIPE_KEYInvalid wipe key
INVALID_FREEZE_KEYInvalid freeze key
INVALID_SUPPLY_KEYInvalid supply key
MISSING_TOKEN_NAMEToken Name is not provided
TOKEN_NAME_TOO_LONGToken Name is too long
INVALID_WIPING_AMOUNTThe provided wipe amount must not be negative, zero or bigger than the token holder balance
TOKEN_IS_IMMUTABLEThe token does not have Admin key set, thus update/delete transactions cannot be performed
TOKEN_ALREADY_ASSOCIATED_TO_ACCOUNTAn associateToken operation specified a token already associated with the account
TRANSACTION_REQUIRES_ZERO_TOKEN_BALANCESAn attempted operation is invalid until all token balances for the target account are zero
ACCOUNT_IS_TREASURYAn attempted operation is invalid because the account is a treasury
TOKEN_ID_REPEATED_IN_TOKEN_LISTSame TokenIDs present in the token list
TOKEN_TRANSFER_LIST_SIZE_LIMIT_EXCEEDEDExceeded the number of token transfers (both from and to) allowed for token transfer list
EMPTY_TOKEN_TRANSFER_BODYTokenTransfersTransactionBody has no TokenTransferList
EMPTY_TOKEN_TRANSFER_ACCOUNT_AMOUNTSTokenTransfersTransactionBody has a TokenTransferList with no AccountAmounts
FRACTION_DIVIDES_BY_ZEROA custom fractional fee set a denominator of zero
INSUFFICIENT_PAYER_BALANCE_FOR_CUSTOM_FEEThe transaction payer could not afford a custom fee
CUSTOM_FEES_LIST_TOO_LONGThe customFees list is longer than allowed limit 10
INVALID_CUSTOM_FEE_COLLECTORAny of the feeCollector accounts for customFees is invalid
INVALID_TOKEN_ID_IN_CUSTOM_FEESAny of the token Ids in customFees is invalid
TOKEN_NOT_ASSOCIATED_TO_FEE_COLLECTORAny of the token Ids in customFees are not associated to feeCollector
CUSTOM_FEE_NOT_FULLY_SPECIFIEDA custom fee schedule entry did not specify either a fixed or fractional fee
CUSTOM_FEE_MUST_BE_POSITIVEOnly positive fees may be assessed at this time
TOKEN_HAS_NO_FEE_SCHEDULE_KEYFee schedule key is not set on token
CUSTOM_FEE_OUTSIDE_NUMERIC_RANGEA fractional custom fee exceeded the range of a 64-bit signed integer
INVALID_CUSTOM_FRACTIONAL_FEES_SUMThe sum of all custom fractional fees must be strictly less than 1
FRACTIONAL_FEE_MAX_AMOUNT_LESS_THAN_MIN_AMOUNTEach fractional custom fee must have its maximum_amount, if specified, at least its minimum_amount
CUSTOM_SCHEDULE_ALREADY_HAS_NO_FEESA fee schedule update tried to clear the custom fees from a token whose fee schedule was already empty
CUSTOM_FEE_DENOMINATION_MUST_BE_FUNGIBLE_COMMONOnly tokens of type FUNGIBLE_COMMON can be used as fee schedule denominations
CUSTOM_FRACTIONAL_FEE_ONLY_ALLOWED_FOR_FUNGIBLE_COMMONOnly tokens of type FUNGIBLE_COMMON can have fractional fees
INVALID_CUSTOM_FEE_SCHEDULE_KEYThe provided custom fee schedule key was invalid
ACCOUNT_AMOUNT_TRANSFERS_ONLY_ALLOWED_FOR_FUNGIBLE_COMMONAn AccountAmount token transfers list referenced a token type other than FUNGIBLE_COMMON
INVALID_TOKEN_MINT_METADATAThe requested token mint metadata was invalid
INVALID_TOKEN_BURN_METADATAThe requested token burn metadata was invalid
PAYER_ACCOUNT_DELETEDThe payer account has been marked as deleted
CUSTOM_FEE_CHARGING_EXCEEDED_MAX_RECURSION_DEPTHThe reference chain of custom fees for a transferred token exceeded the maximum length of 2
CUSTOM_FEE_CHARGING_EXCEEDED_MAX_ACCOUNT_AMOUNTSMore than 20 balance adjustments were to satisfy a CryptoTransfer and its implied custom fee payments
INSUFFICIENT_SENDER_ACCOUNT_BALANCE_FOR_CUSTOM_FEEThe sender account in the token transfer transaction could not afford a custom fee
SERIAL_NUMBER_LIMIT_REACHEDCurrently no more than 4,294,967,295 NFTs may be minted for a given unique token type
CUSTOM_ROYALTY_FEE_ONLY_ALLOWED_FOR_NON_FUNGIBLE_UNIQUEOnly tokens of type NON_FUNGIBLE_UNIQUE can have royalty fees
TOKEN_IS_PAUSEDToken is paused. This Token cannot be a part of any kind of Transaction until unpaused.
TOKEN_HAS_NO_PAUSE_KEYPause key is not set on token
INVALID_PAUSE_KEYThe provided pause key was invalid