HTTP Errors

Learn about error format and common errors encountered using the Circle platform.

The Circle platform returns an HTTP status code when it detects an error in an API request:

• 4xx errors are client errors, which are informative and actionable. They communicate a mistake to the user and suggest fixes.
• 5xx errors are unexpected server-side errors. See Description column for more information on the error and potential fixes.

General error format

HTTP status codes do not always provide sufficient information to determine the cause of the error, but the responses to a request typically contain additional JSON fields that provide additional details. For example, if a request contains an invalid parameter, the response includes the following:

HTTP/1.1 400 Bad RequestContent-Type: application/json

JSON

{
  "code": 2,
  "message": "API parameter invalid"
}

Extended error format

In some cases, the response includes extended information about the cause of the error. For example, if a request doesn’t include a value for a required parameter, the response resembles the following:

HTTP/1.1 400 Bad RequestContent-Type: application/json

JSON

{
  "code": 2,
  "message": "API parameter invalid",
  "errors": [
    {
      "error": "required",
      "message": "fail to bind request to CreateWalletSetRequest: EOF",
      "location": "field1",
      "invalidValue": "null",
      "constraints": {}
    }
  ]
}

Common Developer Services error messages

This section describes some common extended error messages you might encounter using Developer Services APIs.

General

The following errors result from malformed request.

Error Code	HTTP code	Error Message	Description
-1	400	Something went wrong	An unknown error occurred while processing the API request, likely an invalid parameter or API key.
3	403	Forbidden	The API key used does not have access to the requested endpoint.

400 Bad Request

A 400 HTTP status code typically results when the request includes an invalid parameter. The following table includes additional error messages associated with error code 2.

Error Code	HTTP code	Error Message	Description
2	400	Invalid Entity	There is an error in the JSON format passed in the request.
2	400	Fail to bind request to parameter: invalid UUID format	The parameter must be in UUID format.
2	400	Error: Field validation	One of the fields in the request is invalid.
2	400	Error: Field validation for ‘blockchain’ failed on the ‘blockchain’ tag	The blockchain does not exist. Try again with a supported blockchain.
2	400	Error: Field validation for gasLimit failed on the required_without tag”	If feeLevel is provided, gasLimit should be set to NULL. If feeLevel is NULL, gasLimit must be provided.
2	400	Error: Field validation for parameter failed on the min tag	The parameter is not in the correct format.
2	400	Cannot unmarshal	The parameter is not in the correct format.
2	400	INVALID: parameter empty	The parameter is required for this request. Try the request again with this parameter.

Programmable wallet error messages

This section describes the errors that can be returned for Programmable Wallet API requests.

User error codes (155101 - 155149)

Error code	HTTP Code	Error Message	Description
155101	409	Existing user already created with the provided userId.	The user ID already exists. Try the request again with a different user ID.
155102	404	Cannot find the user id in the system.	The user is not found. Try the request again with a different user ID.
155103	401	Cannot find the user token in the system.	The user token is not found. Try the request again with a different user token.
155104	403	The userToken had expired.	The user token has expired. Please generate a new user token and try the request again.
155105	403	The userToken is invalid.	The user token is invalid. Please generate a new user token and try the request again.
155106	409	The user had already been initialized.	The user has already been initialized. Please query the user status first to check if the user has already set a pin and created a wallet.
155107	409	User has previously set a PIN. Use PUT /user/pin to reset the PIN.	The PIN has already been set successfully. Please query the user status to check if the user has already set a PIN.
155108	409	User has previously set up their security questions, and they can’t be reset.	The user has already set the security questions successfully. The questions can only be set once.
155109	409	The specified user has been disabled.	The specified user has been disabled.
155110	400	User has not set up a PIN yet.	The action cannot be performed before the user sets their pin. To set a pin, please call initialize or set a pin first.
155111	400	User hasn’t set the security questions for PIN backup yet.	The action cannot be performed before the user sets their security questions.To set security questions, please call initialize or set security questions first.
155112	400	The user has inputted the incorrect pin.	The user’s PIN is not correct. Try the request again with a different PIN.
155113	400	Provided device ID is not found in the system.	The device ID is not correct. Try the request again with a different device ID.
155114	400	Provided app ID is not recognized in the system.	The app ID is not found. Check the app ID in the SDK API. If you do not have the app ID or it is incorrect, you can acquire it from the Developer Console or by making an API request to GET /config/entity.
155115	400	The user has inputted the incorrect security answers	The provided security answers are not correct. Try the request again with different answers.
155116	404	The challenge ID doesn’t exist in the system.	The challenge ID is invalid. Check the challenge ID in the SDK API.
155117	400	The content provided for approval is not correct.	The provided approval content is unknown. Please integrate with the latest SDK.
155118	400	Encryption key does not match with the user’s token. Call POST /users/token to get the correct token encryption key pair.	The encryption key does not match the user’s token. Call POST /users/token to get the correct token encryption key pair.
155119	400	The user’s PIN input is locked. It will be unlocked after the cooldown period.	The user’s PIN input is locked. Please wait for cold time to unlock, and try again.
155120	400	The user’s security questions input is locked. It will be unlocked after the cooldown period.	The user’s security questions input is locked. Please wait for the locked period to expire to unlock, and try again.
155121	403	The provided challengeId has expired.	The challenge has expired. Try the request again to create a new challenge.
155122	403	The provided challengeId is invalid	The challenge is invalid. Try the request again to create a new challenge.
155123	403	No extra information provided when adding PIN-related requests.	When SDK approves the challenge, the challenge format is wrong. Try the request again to create a new challenge.
155124	403	The extra information provided for PIN-related requests is invalid.	When SDK approves the challenge, the challenge format is wrong. Try the request again to create a new challenge.
155130	400	User OTP token is expired.	User OTP token is expired. Please request OTP email again.
155131	400	User OTP token is invalid.	User OTP token is invalid. Please check the input parameters.
155132	404	User OTP value is not found.	User OTP value is not found. Please request OTP email first.
155133	400	User OTP value is invalid.	User OTP value is invalid. Please check the input parameters.
155134	400	User OTP value is not matched.	User OTP value is not matched. Please check if the OTP value and OTP token match.
155135	400	User’s email is invalid.	User’s email is invalid. Please check the email format in the request.
155136	400	User’s email is not matched.	User’s email is not matched. Please check if the email is the same.
155137	400	User’s device ID is invalid.	User’s device ID is invalid. Please check the input parameters.
155138	400	Failed to send the email.	Failed to send the email. Please check the SMTP configuration in developer console.
155139	400	The idToken / accessToken of SSO is expired.	The idToken / accessToken of SSO is expired. Please get it from SSO provider again.
155140	400	Failed to validate the idToken/ accessToken.	Failed to validate the idToken/ accessToken. Please make sure the ID input on SSO provider configuration is the correct one.
155141	400	The user has exceeded the max limit (5) of entering OTP at the moment.	The user has exceeded the max limit (5) of entering OTP at the moment. Please wait for a cool-down period of 60 minutes before attempting again.
155142	400	The max limit (5) of sending OTP has been exceeded at the moment.	The max limit (5) of sending OTP has been exceeded at the moment. Please wait for a cool-down period of 60 minutes before attempting again.
155143	400	The device token is expired.	The device token is expired. Please request a new device token, and note that the expiry time is 10 mins.
155144	400	The device token is invalid.	The device token is invalid. Please request a new device token, and make sure it is the correct token, and note that only one active token is allowed per deviceId.
155145	404	The device token is not found.	The device token is not found. Please request a new device token to proceed.
155146	400	The OTP token is invalid as the user has entered it incorrectly three times.	The OTP token is invalid as the user has entered it incorrectly three times. Please request a new OTP email.

Entity error codes (155150 - 155199)

Error code	HTTP Code	Error Message	Description
155150	404	The SMTP server configuration is not found.	The SMTP server configuration is not found. Please complete the SMTP setting in developer console first.
155151	400	The SMTP server configuration is invalid.	The SMTP server configuration is invalid. Please check the SMTP setting in developer console.
155152	404	The SSO provider configuration is not found.	The SSO provider configuration is not found. Please add SSO provider in developer console.
155154	400	The OTP email template is invalid.	The OTP email template is invalid. Please check the OTP email template configuration.
155155	404	The OTP email template is not found.	The OTP email template is not found. Please add OTP email template in developer console first.
155156	400	Failed to update the email template.	Failed to update the email template. Please check the content of OTP email template.
155157	400	Failed to update the SMTP server	Failed to update the SMTP server configuration. Please check SMTP setting.

Transaction error codes (155201 - 155299)

Error code	HTTP Code	Error Message	Description
155201	400	Not enough funds to fulfill the withdraw request.	There is insufficient native token balance in the wallet to cover all pending transactions on the network. Please add funds to the wallet, and try again.
155202	400	Transaction nonce is inconsistent with sender’s latest nonce.	Transaction nonce mismatches occur when a sender has created one or more transactions on-chain where the initial transaction has not yet reached finality. Try the transaction again.
155203	400	User op nonce can not be larger than 0 when smart contract wallet hasn’t been deployed.	User op nonce can not be larger than 0 when the smart contract wallet hasn’t been deployed.
155204	400	The total cost of executing transaction is higher than the balance of the user’s account when estimating fee.	There is insufficient native token balance in the wallet to cover the total cost of executing the transaction. Please add funds to the wallet, and try again.
155205	400	Failed to execute this request on EVM due to insufficient token when estimating fee.	There is insufficient non-native token balance in the wallet to cover the request execution. Please add funds to the wallet, and try again.
155206	400	The sender address is not token owner or approved when estimating token transfer.	The owner of the tokens may not call approve ABI to allow the caller to access the tokens.
155207	400	Gas required exceeds allowance when estimating fee.	Gas required exceeds allowance when estimating fee.
155208	400	Estimate fee execution reverted.	Estimate fee execution reverted on EVM.
155209	400	ABI function signature can’t pack ABI parameter.	The ABI parameters were invalid. Please correct the ABI parameters and try again.
155210	400	Fails to perform transaction estimation.	Estimate fee execution failed on EVM.
155211	400	MaxFee * GasLimit exceed configurable max transaction fee (default is 1 native token).	Please reduce maxFee or gasLimit, and try again. Note Circle has system-wide limits for maxFee for each blockchain network and native token pair. Ethereum = 1 ETH, Polygon = 10 MATIC, Avalanche = 1 AVAX.
155215	400	Unsupported operation for transaction.	The requested operation for the transaction is not eligible to be executed anymore. Check the status of the transaction.
155218	400	Invalid number of nft in transaction request.	Invalid number of NFT in the transaction request. Only ERC-1155 supports batch NFT token transfer.
155219	400	Invalid destination address.	Please correct the destination address, and try again.
155220	400	Wallet and token’s blockchain mismatch.	The wallet and token’s blockchain must be the same.
155221	400	Invalid amounts in transfer request.	Other than ERC-1155, all other types of token transfer amount length should be 1.
155222	404	NFT metadata can not be found.	NFT metadata can not be found.
155223	400	Unsupported userId for get transactions.	UserId is not supported as a query parameter for GET transaction requests.
155224	400	Failed to parse the provided amounts in request to decimals.	Failed to parse the provided amounts in request to decimals.
155225	400	Wallet and request’s blockchain mismatch.	The wallet and blockchain in the request should be the same.
155226	400	Invalid source address.	Please correct the source address, and try again.
155227	400	Invalid transaction type.	Transaction validation failed because the transaction type is not outbound.
155228	400	Missing token ID.	The token ID is missing from the request. Add the correct token ID, and try again.
155229	400	Transaction is not eligible for operation.	The transaction is not eligible for operation.
155230	400	No call data or abi signature provided.	Please provide ABI signature, and try again.
155231	400	Transaction needs feeLevel or gasLimit provided.	Please provide feeLevel or gasLimit, and try again.
155232	400	SCA transaction needs feeLevel provided.	SCA transaction needs feeLevel provided. Please specify the feeLevel, and try again.
155233	400	Provided gasLimit is too low to complete the requested transaction.	Provided gasLimit smaller than network estimation. Please provide a higher gasLimit, and try again.
155234	400	Transaction can’t have both feeLevel and fee parameters provided.	Specify either feeLevel, or provide the detailed fee params for a transaction.
155235	400	EIP1559 chains need maxFee/priorityFee provided.	EIP1559 chains need maxFee/priorityFee provided.
155236	400	Failed to parse the provided fee in request to decimals.	Failed to parse the provided fee in request to decimals.
155237	400	PriorityFee cannot be larger than maxFee in creating transaction request.	PriorityFee cannot be larger than maxFee in creating transaction requests.
155238	400	Non-EIP1559 chains need gasPrice provided.	Non-EIP1559 chains need gasPrice provided.
155239	400	Invalid token address for transfer.	Please correct the token address, and try again.
155240	400	Invalid token standard for transfer.	Please correct the token standard, and try again.
155241	400	Invalid token decimal for transfer.	Please correct the token decimal, and try again.
155242	400	The lengths of amounts and nft tokens don’t match.	The lengths of amounts and NFT tokens don’t match.
155243	400	Missing bytecode for contract deployment.	Please provide bytecode for contract deployment, and try again.
155244	400	Cannot provide both WalletID and SourceAddress/Blockchain.	Specify WalletID or provide the SourceAddress/Blockchain, and try the request again.
155245	400	Invalid amount in contract execution request.	Invalid amount in contract execution request. Error raised when parsing amount in the request.
155247	400	Cannot provide both CallData and AbiFunctionSignature/AbiParameters.	Specify CallData or provide AbiFunctionSignature/AbiParameters, and try the request again.
155264	400	Wait for pending transactions to be included on the blockchain before submitting new requests. EVM chains restrict the number of queued transactions per sender address.	Please wait, as you have reached the maximum number of the pending transactions per sender address for the corresponding chain. You can check the status of your transactions using the GET /transactions endpoint. To expedite processing, consider using multiple wallets to distribute your transactions. (see Transaction Limits and Optimizations for more tips. )

Wallet error codes (155501 - 155599)

Error code	HTTP Code	Error Message	Description
155501	409	Frozen wallets can not be updated or interact with, only query.	Frozen wallets cannot be updated or interacted with. You can only query this wallet.
155502	403	Max amount of wallets (tentative 1M) reached under 1 wallet set.	1M maximum amount of wallets has been reached under 1 wallet set.
155503	400	Metadata array length needs to match wallet count in create developer wallets request.	The metadata array length must match the wallet count in the POST /developer/wallets request.
155504	400	Metadata array length needs to match number of blockchains in create user wallets request.	The metadata array length must match the number of blockchains in the create user wallet request.
155505	400	SCA wallet needs to wait for first-time transaction to be queued before processing more transactions.	SCA wallet needs to wait for first-time transactions to be queued before processing more transactions.
155506	400	SCA wallet config is invalid.	SCA wallet config is invalid.
155507	400	SCA account is not supported on the given blockchain.	The SCA account type is not supported on the given chain. Please see the account types doc for more details on the supported blockchains.
155508	400	Can’t create multiple user-controlled SCA wallets across multiple blockchains at a time.	When the account type is SCA, you cannot send more than one value in the blockchains array. Instead, send two separate requests, providing blockchain value one in the first request and value two in the second request.
155509	400	Entity needs to setup paymaster policy on Mainnet before SCA account creation. Please check paymaster policy setup	The paymaster policies for your account need to be properly configured. Go to the web3 console and ensure you have a policy configured for the blockchain and do not have multiple policies for a given blockchain.
155510	400	The operation is not supported on the blockchain you specify.	The provided wallet is associated with a blockchain that does not support the requested API operation. Please ensure you are using a compatible wallet and refer to the documentation for a list of supported operations.
155511	400	Blockchain is not supported for wallet creation.	The specified blockchain is not supported for wallet creation. See the list of supported blockchains.
155512	404	The owner of the SCA wallet can not be found.	The SCA wallet owner cannot be found. Check if ownership was transferred or if the account is set up correctly.
155515	400	The provided wallet account type is not supported by this API.	The specified wallet account type is not supported by this API. See account types for a list of supported types.

Wallet Set error codes (155601 - 155699)

Error code	HTTP Code	Error Message	Description
155601	400	Failed to retrieve wallet set which already exists.	Cannot create a new wallet set because it already exists. Try again with a unique wallet set.

SDK UI error codes (155701 - 155799)

Error code	HTTP Code	Error Message	Description
155701	N/A	User canceled	The user canceled or exited the execute UI.
155702	N/A	<Launch UI failed reason>	Please check the error message to see the exact UI launch failure reason.
155703	N/A	The code you entered is not the same as the first one	The code you entered is not the same as the first one.
155704	N/A	Your PIN can’t have repeating or consecutive numbers	Your PIN can’t have repeating or consecutive numbers. Try again with a valid PIN.
155705	N/A	Your hint can’t be the same as the answer	Your hint can’t be the same as the answer. Try again with a valid hint.
155706	N/A	Network error	Network error. Try again.
155707	N/A	Failed to encrypt data	Failed to encrypt data. Try again.
155708	N/A	”Biometrics instead of PIN” is disabled	Please enable the “Biometrics instead of PIN” SDK API.
155709	N/A	The device system doesn’t support biometrics	Cannot enable biometrics in this device. The user must use the PIN code.
155710	N/A	Failed to decrypt biometrics key	Ask the user to reset the biometrics settings.
155711	N/A	The user has not enabled biometrics yet	The user skipped the biometrics setting.
155712	N/A	The user refused to enable biometrics	Must call the SetBiometricsPin SDK API so the user can enable biometrics.
155713	N/A	Too many requests. Try again later	Please wait for 30 minutes, and try again.
155714	N/A	Too many requests. The biometrics sensor on the device is locked	Please go to the device system settings to unlock.
155715	N/A	The user didn’t enable biometrics	The user can be prompted to go to the App Settings to re-allow the app to use biometrics. (Warning) This operation will cause the app to be relaunched.
155716	N/A	Unexpected error for biometrics	Unexpected error. Try again.
155717	N/A	User secret is missing. Check the input parameters.	The user secret is missing from the request. Ensure the input parameters are correct and retry the operation.
155718	N/A	User token format is invalid	User token format is invalid. Please ensure the format of the user token is correct, then perform login and execute the challenge again.
155719	N/A	User token and SDK API execute function do not match	User token and SDK API execute function do not match. Please ensure that executeWithUserSecret is for users with SSO/Email auth method, and execute is for users with PIN auth method.
155720	N/A	Social login failed	Social login failed. The social provider returns failed during the execution of social login flow. Please refer to the error message for more details.
155721	N/A	Login info is missing	Login info is missing. Please perform login and execute the challenge again.

Sign transaction error codes (155801 - 155899)

Error code	HTTP Code	Error Message	Description
155801	400	Transaction or rawTransaction is invalid.	Invalid transaction or rawTransaction in request.
155802	400	Account not found.	Cannot find account in the transaction header.
155803	400	Not signer account.	Account is not the signer of this transaction.
155804	400	Transaction is already signed.	Transaction is already signed.
155805	400	Transaction failed to deserialize.	Transaction failed to deserialize.
155806	400	The transaction size exceeds blockchain limit.	The transaction size exceeds blockchain limit.
155807	400	The chain ID is not supported for signing.	The typed data or transaction chain ID is not supported for EVM signing
155808	400	The chain ID is missing in sign request.	The chain ID is missing from typed data or transaction for EVM signing.

Common error codes (156001 - 156099)

Error Code	HTTP Code	Error Message	Description
156001	404	Cannot find target wallet in the system. Either the specified wallet doesn’t exist or it’s not accessible to the caller.	The specified wallet does not exist, or is not visible to the caller. Try the request again with a valid wallet ID.
156002	404	Cannot find target token in the system. Either the specified token doesn’t exist or it’s not accessible to the caller.	The specified token does not exist, or is not visible to the caller. Try the request again with a valid token ID.
156003	404	Cannot find target transaction in the system. Either the specified transaction doesn’t exist or it’s not accessible to the caller.	The specified transaction does not exist, or is not visible to the caller. Try the request again with a valid transaction ID.
156004	400	Reusing an entity secret ciphertext is not allowed. Please re-encrypt the entity secret to generate new ciphertext.	Reusing an entity secret ciphertext is not allowed. Please re-encrypt the entity secret to generate a new ciphertext and try again.
156005	404	Cannot find target wallet set in the system. Either no such wallet set, or it’s not accessible to the caller.	The specified wallet set does not exist, or is not visible to the caller. Try the request again with a valid wallet set.
156006	400	TEST_API key cannot be used with blockchain mainnets, or LIVE_API key cannot be used with blockchain testnets.	A TEST_API key cannot be used with blockchain Mainnets, and a LIVE_API key cannot be used with blockchain Testnets. Try again with a valid API key.
156007	401	TEST_API key or LIVE_API key is not found for the request.	A TEST_API key or LIVE_API key is not found for the request. Try again with a valid API key.
156008	400	Cannot find target entity config in the system. Either no such entity config, or it’s not accessible to the caller.	The specified entity config does not exist, or is not visible to the caller. Try the request again with a valid entity config.
156009	400	Fail to parse id as UUID in url.	The specified id is invalid (must be in UUID format). Try again with a valid id.
156010	404	Cannot find the corresponding entity in the system.	The specified entity does not exist, or is not configured. Try again with a valid entity.
156011	404	Cannot find target nftTokenId in the system.	The nftTokenId does not exist. Try again with a valid nftTokenId.
156012	404	Cannot find corresponding pagination cursor in the system.	The pagination parameters are invalid. Please correct your pagination parameters, and try again.
156013	400	The provided entity secret is invalid.	The specified entity secret is not valid. Please create or re-encrypt your entity secret, and try again.
156014	400	Pagination params are invalid. Only UUID format is supported for pageBefore and pageAfter.	Pagination parameters are invalid. Only UUID format is supported for pageBefore and pageAfter.
156015	409	The secret for this entity has already been set.	The secret for this entity has already been set.
156016	403	The entity secret has not been set yet. Please provide encrypted ciphertext in the console.	The entity secret has not been set yet. Please provide encrypted ciphertext in the Developer console.
156017	400	The specified blockchain parameters are incorrect.	The blockchain parameters are invalid. Please correct the blockchain parameters, and try again.
156018	403	The uploaded recovery file is invalid.	The uploaded recovery file is invalid. Try again with a valid recovery file.
156019	403	Current entity secret is invalid. Please rotate the entity secret first.	The current entity secret is invalid. Please rotate the entity secret first in the Developer console, and try again.
156020	403	Please use a new idempotency key.	Please use a new idempotency key, and try again.
156021	409	A new wallet set ID is required.	Please use a new wallet set ID, and try again.
156023	409	EncodedByHex is true in sign request, but the message is not hex encoded.	The encodedByHex parameter is set to true, but the provided message is not in the correct hex-encoded format. Please ensure the message is hex-encoded and try again, or set encodedByHex to false.
156024	400	Data is not a valid JSON string in sign request.	Data is not a valid JSON string in the Sign request. Please provide a valid JSON format typed data string.
156025	400	Invalid message in request.	Sign message is invalid. Try the request again with a valid EIP-191 message.
156026	400	Invalid typed data in request.	Typed data is invalid. Try the request again with a valid EIP-712 typed data.
156027	400	The specified blockchain is either not supported or deprecated.	Please try again with a supported blockchain. Please see the guide Supported Blockchains and Currencies for the complete list of supported blockchains.
156030	400	Invalid unsigned delegate action in request.	Invalid unsigned delegate action in request.

Circle Contracts error messages

This section includes the errors that can be returned from the Circle Contracts API requests.

Contract error codes (175001 - 175199)

Error Code	HTTP Code	Error Message	Description
175001	404	Contract not found.	The specified contract does not exist in the system.
175002	400	No ABI JSON for the target contract.	Cannot execute a read function on a contract without the ABI JSON.
175003	400	Constructor parameters length must match constructor signature.	The number of constructor parameters must match the constructor signature.
175004	409	Contract already exists.	The contract already exists in the system.
175005	400	Address is not a contract address.	The given address is not associated with a smart contract.
175006	400	Contract is archived.	Attempted to interact with an archived contract.
175007	400	Invalid ABI JSON.	The inputted ABI JSON is not correctly formatted.
175008	400	Multi-layered proxies are not supported.	Importing a multi-layered proxy contract is not supported.
175009	400	Contract deployment pending.	Contract deployment must be completed before function execution is available.
175010	400	ABI function not found.	The ABI function was not found on the contract.
175011	400	Empty update on a contract.	An empty update for a contract is not allowed
175012	400	Unable to query contract.	Unable to query contract. Check your parameters and try again.
175013	400	ABI function is not supported.	The ABI function of the contract is not supported.

Template error codes (175201 - 175399)

Error Code	HTTP Code	Error Message	Description
175201	404	Template not found.	The specified template does not exist in the system.
175202	400	Deploying this template is temporarily disabled.	Deploying this template is temporarily disabled.
175203	400	Invalid template deployment parameter.	The request contains an invalid field in the template parameters.
175204	400	Missing required template deployment parameter.	The request is missing a required field in the template parameters.
175205	400	Estimation is not supported.	Estimating the deployment of this template is not supported.

Event subscription error codes (175301 - 175399)

Error Code	HTTP Code	Error Message	Description
175301	404	Event subscription not found.	The specified event subscription does not exist or is not accessible to the caller.
175302	409	Event subscription already exist.	The specified event has already been created for this contract.
175303	400	The specified event signature does not exist.	The specified event signature does not exist on this contract.

Common error codes (175401 - 175599)

Code	HTTP Code	Error Message	Description
175401	400	Fail to parse id as UUID in url.	The specified ID is invalid (must be in UUID format). Try again with a valid ID.
175402	400	The specified blockchain is either not supported or deprecated.	The specified blockchain is either not supported or deprecated.
175403	409	Please use a new idempotency key.	Please use a new idempotency key and try again.
175404	400	TEST_API key cannot be used with blockchain mainnets, or LIVE_API key cannot be used with blockchain testnets.	TEST_API key cannot be used with blockchain mainnets, or LIVE_API key cannot be used with blockchain testnets.
175405	401	TEST_API key or LIVE_API key is not found for the request.	TEST_API key or LIVE_API key is not found for the request.
175406	400	This feature is temporarily disabled.	This feature is temporarily disabled.
175407	400	The specified blockchain is unavailable.	The specified blockchain is unavailable. Please check the Circle Status page for more details.
175408	404	Cannot find corresponding pagination cursor in the system.	Cannot find corresponding pagination cursor in the system.
175409	403	Entities with restrictions cannot perform this operation.	Entities with restrictions cannot perform this operation.
175410	400	invalid address format	The address format is invalid.

Transaction error codes (177001 - 177607)

Code	HTTP Code	Error Message	Description
177001	400	transaction nonce is inconsistent with sender’s latest nonce	The transaction nonce is inconsistent with the sender’s latest nonce.
177002	400	user op nonce can not be larger than 0 when smart contract wallet hasn’t been deployed	User op nonce can not be larger than 0 when the smart contract wallet hasn’t been deployed.
177003	400	failed to execute this request on EVM due to insufficient token when estimating fee	Failed to execute this request on EVM due to insufficient tokens when estimating the fee.
177004	400	the total cost of executing transaction is higher than the balance of the user’s account when estimating fee	When estimating the fee, the total cost of executing the transaction is higher than the balance of the user’s account.
177005	400	the sender address is not token owner or approved when estimating token transfer	The sender address is not token owner or approved when estimating token transfer.
177006	400	gas required exceeds allowance when estimating fee	Gas required exceeds allowance when estimating fee.
177007	400	estimate fee execution reverted	Estimate fee execution reverted.
177008	400	ABI function signature can’t pack ABI parameter	ABI function signature can’t pack ABI parameter.
177009	400	fails to perform transaction estimation	Fails to perform transaction estimation.
177010	400	maxFee * gasLimit exceed configurable max transaction fee (default is 1 native token)	The MaxFee * GasLimit exceeds the configurable max transaction fee (default is 1 native token).
177011	400	transaction needs feeLevel or gasLimit provided	The transaction requires feeLevel or gasLimit to be provided in the request.
177012	400	sca transaction needs feeLevel provided	The SCA transaction requires feeLevel to be provided in the request.
177013	400	EIP1559 chains need maxFee/priorityFee provided	EIP1559 chains require maxFee and priorityFee to be provided in the request.
177014	400	priorityFee cannot be larger than maxFee in creating transaction request	Creating transaction requestspriorityFee cannot be larger than maxFee.
177015	400	missing bytecode for contract deployment	Missing bytecode for contract deployment.
177016	400	cannot provide both WalletID and SourceAddress/Blockchain	You cannot provide WalletID and SourceAddress/Blockchain in a request.
177017	400	Invalid amount in contract execution request	The amount in the contract execution request is invalid.
177018	400	policy is not activated and cannot be used	The Gas Station paymaster policy is not activated and cannot be used.
177019	400	exceeded max daily transaction of the policy	The Gas Station paymaster policy maximum daily transaction limit has been reached.
177020	400	exceeded max spend USD per transaction of the policy	The transaction cost exceeds the Gas Station paymaster policy maximum spend per transaction in USD.
177021	400	exceeded max spend USD daily of the policy	The Gas Station paymaster policy for maximum spending daily in USD has been reached.
177022	400	exceeded max native token daily of the policy	The Gas Station paymaster policy for maximum native tokens daily of the policy.
177023	400	sender is in policy blocklist	The sender is on the Gas Station paymaster policy blocklist.
177024	400	wallet and request’s blockchain mismatch.	The wallet and blockchain in the request should be the same.
177301	400	wallet is Frozen	Frozen wallets can not be updated or interacted with; they can only be queried.
177302	400	invalid sca wallet config	The SCA wallet configuration is invalid.
177303	400	sca wallet first-time transaction is still in progress	The SCA wallet needs to wait for the first-time transaction to finish deploying the wallet before processing more transactions.
177304	400	SCA account is not supported on the given blockchain	The SCA account is not supported on the given blockchain.
177305	400	Entity is not eligible for SCA account creation. Please check paymaster policy setup	The entity is not eligible for SCA account creation. Please check the Gas Station paymaster policy setup.
177601	400	could be caused by either no such wallet or wallet is not accessible to the caller	The target wallet cannot be found in the system. Either the specified wallet doesn’t exist, or it’s inaccessible to the caller.
177602	400	reusing an entity secret ciphertext is not allowed. Please re-encrypt the entity secret to generate new ciphertext	Reusing an entity’s secret ciphertext is not allowed. Please re-encrypt the entity secret to generate a new ciphertext.
177603	400	entity is likely not properly set up during the onboarding process	The corresponding entity cannot be found in the system.
177604	400	the provided entity secret is invalid	The provided entity secret is invalid.
177605	400	the entity secret has not been set yet. Please provide encrypted ciphertext in the console	The entity secret has not been set up on your account. Please provide encrypted ciphertext in the console.
177606	400	current entity secret is invalid. Please rotate the entity secret first	The provided entity secret is invalid. Please rotate the entity secret first and send another API request.
177607	400	please use a new idempotency key	Please use a new idempotency key.
177901	400	smart contract query failed	Error when querying contract. Check parameters and try again.

Compliance Engine error messages

This section includes the errors that can be returned from Compliance Engine API requests.

Standalone screening error codes (280001 - 280099)

Error Code	HTTP Code	Error Message	Description
280001	400	Unsupported Blockchain	Provided blockchain either does not exist or is not supported.
280002	400	Invalid blockchain address	Provided blockchain address is not valid.