HTTP Status Codes
200 (OK)
The request was processed as expected.
400 (INVALID_REQUEST)
The request is not well-formed, violates schema, or has incorrect fields.
401 (NOT_AUTHORIZED)
The API key doesn't match the signature or have the necessary permissions to perform the request.
403 (FORBIDDEN)
The API key doesn't have the necessary permissions to complete the request.
404 (RESOURCE_NOT_FOUND)
The requested resource doesn't exist.
429 (RATE_LIMIT_REACHED)
Too many requests. Blocked due to rate limiting.
5XX
Something went wrong on Fireblocks' end.
API Error Codes
The table below contains all error codes (and their related HTTP status codes) for the Fireblocks API. We recommend reviewing the codes related to the features you want to implement for your workspace and customers.
4XX Error Codes
| Error Code | HTTP Status Code | Relevant Features | Issue and Remediation |
|---|---|---|---|
| -1 | 401 | All | Invalid signature If you receive this error message, ensure the private key you used is correct. |
| -2 | 401 | All | Missing API Key in the JWT Verify that you specify the API key |
| -3 | 401 | All | The entire JWT is missing Uncommon - Potential code change, or bad parameters passed to Fireblocks SDK constructor |
| -4 | 401 | All | Wrong URL in the JWT Uncommon - Potential code change to the Fireblocks SDK source code on your device |
| -5 | 401 | All | Unauthorized: Invalid token format This error code typically indicates the certificate associated with the API user making the call has expired. |
| -6 | 401 | All | Wrong User in the JWT The user that is being used as part of the request is incorrect, verify that the correct user is being used |
| -7 | 401 | All | Unauthorized: Token was not accepted This error code typically indicates the JSON Web Token (JWT) supplied with the API user’s request was not accepted. API requests to Fireblocks are authenticated using the provided JWT. If the JWT is invalid, you will receive the error code. The cause of the error is likely either the wrong API key being used or the wrong baseURL being used. For SDK users, this typically means an incorrect API key was used to create the client. For users with native API client implementations, this typically indicates an error with your JWT creation logic. |
| -8 | 401 | All | Insufficient permissions This error code typically indicates the API user initiating this request does not have access to the requested operation based on their user role |
| -10 | 401 | All | The request has expired This error typically indicates the JSON Web Token (JWT) supplied with the API user’s request has timed out. Please note: - For Fireblocks SDK users, the JWT expiration time is defined based on the system time. - For users with their own API client implementations, the JWT data is defined by the user’s implementation. |
| -12 | 401 | All | The request is with a future issuance timestamp (iat) This error code typically indicates the JSON Web Token (JWT) supplied with the API user’s request is not yet valid for processing. - For SDK users, the JWT “initiated–at” time is defined based on the system time. - For users with their own API client implementations, the JWT data is defined by the user’s implementation. |
| 1000 | 400 | Vault | GetVaultAccounts request has invalid values Check that you pass a valid minAmountThreshold (if you pass it) and only one of namePrefix, nameSuffix if you pass it |
| 1002 | 400 | Vault | Create Vault Account failed Verify that the values provided to the create vault account request are valid and conform to the types specified in the API Docs |
| 1004 | 404 | Vault | Vault account Id was not found Verify that the vault account you're trying to query is valid and exists |
| 1006 | 404 | Asset, Balance | Asset doesn't exist The asset requested for the given vault account does not exist, verify that the vault account contains the asset you're requested. |
| 1008 | 400 | Wallet, Asset (EOS Specific) | EOS Wallet Creation failed The eosAccountName parameter is invalid |
| 1010 | 400 | Wallet | Renaming a deposit address failed You're trying to add an address to a blockchain which does not support more than 1 address (such as ETH) |
| 1013 | 400 | Vault | Vault account renaming failed Verify that the parameters passed to the vault account renaming operation are valid |
| 1015 | 400 | Wallet | Rename a deposit address failed Verify that the parameters that were passed are valid and that the asset you're trying to rename exists |
| 1016 | 400 | Wallet | Rename a deposit address failed The rename operation failed due to a backend issue - open a ticket to support |
| 1017 | 400 | Vault | Hide vault account failed The vault account you requested to hide does not exist, please verify you're using the correct vault account id |
| 1019 | 400 | Vault | Hide on a hidden vault account request You're requesting to hide a vault account that is already hidden, please verify you're using the correct vault account id |
| 1020 | 400 | Vault | Unhide vault account failed The vault account you requested to unhide does not exist, please verify you're using the correct vault account id |
| 1022 | 400 | Vault | Unhide on a visible vault account request You're requesting to unhide a vault account that is not hidden, please verify you're using the correct vault account id |
| 1023 | 400, 404 | Wallet | Get legacy address failed There is no legacy address used for this specific asset |
| 1024 | 400, 404 | Wallet | Get legacy address for an asset without one The asset you're trying to get the legacy address for does not have one (for example ETH) |
| 1025 | 400 | Asset, Vault, Wallet | Usage of an unsupported asset The asset you specified in your request is invalid, please check it against the supported asset list |
| 1026 | 400 | Asset, Vault, Wallet | Creation of a wallet that already exists You've requested to create a wallet for an asset that already has a wallet in the vault account, please check you're using the correct asset and correct asset |
| 1027 | 400 | Asset, Balance | Requested max spendable amount for asset that doesn't support that request You've requested to know the max spendable amount for an asset which does not support this request, verify you're using one of the assets according to the API docs |
| 1028 | 400 | Asset, Balance | Max Spendable Amount invalid value The parameters you provided for the request are invalid, please verify you provided the correct type of values as well as a valid asset and vault account id |
| 1031 | 400 | Asset, Balance | Get balance by assets The request to balance of assets in all vault accounts is invalid, only one of accountNamePrefix and accountNameSuffix can be provided |
| 1032 | 400, 404 | Asset, Balance | Get balances by assets or get balance for asset failed The asset requested does not exist in the vault account |
| 1034 | 400 | Wallet | Create testnet asset failed You're requested to create a testnet asset on a workspace that is does not have testnet support |
| 1035 | 400 | Asset | Activate wallet failed The request to activate the wallet failed, please open a ticket to support |
| 1037 | 400 | Vault | Get vault accounts endpoint is disabled Workspaces created after May 2022 do not support the get vault accounts endpoint, use the paged request |
| 1038 | 400 | Wallet, Asset | Adding a token without base asset Before adding a token to the vault account, please create a base asset wallet |
| 1039 | 400 | Wallet, Asset | Insufficient base asset for token wallet Before creating a token asset, make sure you have sufficient base asset to cover token transactions |
| 1040 | 401 | Vault | Unauthorized user to create vault account The user that's trying to add a vault account does not have the proper permissions needed to create a vault account, make sure you use the correct user |
| 1103 | 400 | Exchange, Fiat | No such exchange/fiat account ID The exchange or fiat account ID does not exist, make sure you're using the correct one |
| 1105 | 400 | Exchange | Exchange account for asset by ID does not exist The exchange account's asset does not exist for the specified exchange account ID, make sure you're using the correct exchange account ID and asset |
| 1106 | 400 | Exchange Transfers | No such exchange account ID The exchange account ID specified does not exist |
| 1108 | 408 | Exchange | Exchange timeout when adding an account We faced an internal timeout when trying to add the exchange account |
| 1111 | 400 | Exchange Transfers | Exchange convert failed Failed to perform a convert operation, please check the message reply to understand the issue |
| 1202 | 400 | Internal Wallets | Create internal wallet failed Internal wallet name must be specified, not empty and to not already exist in a different wallet |
| 1204 | 400 | Internal Wallets | Get internal wallet by id failed The internal wallet specified does not exist, make sure you're querying the correct internal wallet id |
| 1206 | 400 | Internal Wallets | Delete internal wallet failed Failed to delete the internal wallet, please make sure you've specified the correct internal wallet parameters |
| 1208 | 400 | Internal Wallets | Create an internal wallet failed Failed to create an internal wallet, please verify you've provided the correct parameters for the creation as per the API docs |
| 1209 | 400 | Internal Wallets | Getting the wallet's asset failed The internal wallet based off the Id and asset specified does not exist, please make sure you're using the correct asset and wallet id |
| 1212 | 400 | Internal Wallets | Deleting specific asset from wallet failed Please verify that you specified the correct wallet id and asset id for deletion |
| 1213 | 400 | Internal Wallets | Create an unsupported asset address in a wallet The asset you're trying to add to the wallet is not supported, verify the asset you're trying to use |
| 1214 | 400 | Internal Wallets | Create an asset from a different network in the wallet The asset you're trying to add to the wallet is in a different network (mainnet or testnet) and your workspace does not support this network, please verify the network of the asset and your workspace correlate |
| 1215 | 400 | Internal Wallets | Add an asset in a wallet that already has it You're trying to add an asset to the internal wallet but it already has this asset, please make sure you're adding a new asset and not one that already exists |
| 1216 | 400 | Internal Wallets | Add an asset with an invalid address to the wallet You're trying to add an asset to the internal wallet, but the address does not match the asset's conventions, please check the address you're trying to add |
| 1302 | 400 | External Wallets | Create external wallet failed External wallet name must be specified, not empty and to not already exist in a different wallet |
| 1304 | 400 | External Wallets | Get external wallet by Id failed The external wallet requested does not exist, please make sure you're using the correct wallet Id |
| 1306 | 400 | External Wallets | Delete internal wallet failed Failed to delete the external wallet, please make sure you've specified the correct internal wallet parameters |
| 1308 | 400 | External Wallets | Create an internal wallet failed Failed to create an external wallet, please verify you've provided the correct parameters for the creation as per the API docs |
| 1309 | 400 | External Wallets | Getting the wallet's asset failed The external wallet based off the Id and asset specified does not exist, please make sure you're using the correct asset and wallet id |
| 1312 | 400 | External Wallets | Deleting specific asset from wallet failed Please verify that you specified the correct wallet id and asset id for deletion |
| 1313 | 400 | External Wallets | Create an unsupported asset address in a wallet The asset you're trying to add to the wallet is not supported, verify the asset you're trying to use |
| 1314 | 400 | External Wallets | Create an asset from a different network in the wallet The asset you're trying to add to the wallet is in a different network (mainnet or testnet) and your workspace does not support this network, please verify the network of the asset and your workspace correlate |
| 1315 | 400 | External Wallets | Add an asset in a wallet that already has it You're trying to add an asset to the external wallet but it already has this asset, please make sure you're adding a new asset and not one that already exists |
| 1316 | 400 | External Wallets | Add an asset with an invalid address to the wallet You're trying to add an asset to the external wallet, but the address does not match the asset's conventions, please check the address you're trying to add |
| 1351 | 400 | External Wallets | Create external wallet failed External wallet name must be specified, not empty and to not already exist in a different wallet |
| 1354 | 400 | External Wallets | Get external wallet by Id failed The external wallet requested does not exist, please make sure you're using the correct wallet Id |
| 1356 | 400 | External Wallets | Delete internal wallet failed Failed to delete the external wallet, please make sure you've specified the correct internal wallet parameters |
| 1358 | 400 | External Wallets | Create an internal wallet failed Failed to create an external wallet, please verify you've provided the correct parameters for the creation as per the API docs |
| 1359 | 400 | External Wallets | Getting the wallet's asset failed The external wallet based off the Id and asset specified does not exist, please make sure you're using the correct asset and wallet id |
| 1362 | 400 | External Wallets | Deleting specific asset from wallet failed Please verify that you specified the correct wallet id and asset id for deletion |
| 1363 | 400 | External Wallets | Create an unsupported asset address in a wallet The asset you're trying to add to the wallet is not supported, verify the asset you're trying to use |
| 1364 | 400 | External Wallets | Create an asset from a different network in the wallet The asset you're trying to add to the wallet is in a different network (mainnet or testnet) and your workspace does not support this network, please verify the network of the asset and your workspace correlate |
| 1365 | 400 | External Wallets | Add an asset in a wallet that already has it You're trying to add an asset to the external wallet but it already has this asset, please make sure you're adding a new asset and not one that already exists |
| 1366 | 400 | External Wallets | Add an asset with an invalid address to the wallet You're trying to add an asset to the external wallet, but the address does not match the asset's conventions, please check the address you're trying to add |
| 1401 | 400 | Transaction | The operation requested is not supported The operation argument that you provided in the create transaction is not supported, please verify it's correct |
| 1402 | 400 | Transaction | Source balance insufficient Balance of the source account is not sufficient to cover the transaction |
| 1403 | 400 | Transaction | Destination balance is insufficient Some blockchains (such as NEAR) require a minimal amount of asset to be activated, you tried to pass less than the minimal amount, to a vault account which does not have such a wallet, thus the wallet can't be created Please verify you're transferring a sufficient amount, or have the destination create a wallet and deposit a sufficient amount of base asset |
| 1404 | 400 | Transaction | Invalid Peer type When creating the transaction, verify the the type of the source and destination are valid and one of the defined enums in the API docs |
| 1405 | 404 | Transaction | No such transaction The transaction Id you used to try and get the transaction object is invalid and was not found in the system, make sure you're using the correct transaction Id |
| 1406 | 400 | Transaction | Failed to cancel transaction Cancelling the transaction failed for some reason, please open a support ticket |
| 1407 | 400 | Transaction | User can't create a transaction The user trying to create the transaction does not have sufficient permissions to do so, please verify the user's permission level and that you're using the correct user |
| 1408 | 400 | Transaction | Paged get tried to change direction When getting transactions in a paged fashion, you can only go in one direction (forward or backwards) and can't change direction mid execution. Make sure you're only querying the information in one direction |
| 1409 | 400 | Transaction | Transaction creation parameters are invalid Here is a list of items to check: 1. The asset type is valid and is supported 2. You can only specify destination or destinations, not both3. For OTA you must specify the address 4. Typed messages only supported BTC, LTC, DASH and ETH 5. AML Customer reference ID is can only use -_: and alpha-numeric6. You can not have more than 650 destinations in the destinations parameters7. Invalid nodeControls parameters |
| 1410 | 400 | Transaction | Transaction destination wallet does not exist The destination is sending the transaction to an external/internal/contract wallet by an Id, but the Id specified does not exist, check the Id you're using is correct |
| 1411 | 400 | Transaction | Transaction destination wallet asset does not exist The destination is sending the transaction to an external/internal/contract wallet by an Id, but the asset used in the transaction does not exist, check that the asset has an address in the wallet Id |
| 1412 | 400 | Transaction | Transaction destination wallet address is suspended The destination is an external/internal/contract wallet which was not approved yet, approve it and the try again |
| 1421 | 400 | Transaction | Confirmation number change failed Changing the number of confirmations for the transaction failed, please verify that the transaction exists otherwise open a support ticket |
| 1422 | 400 | Transaction | Confirmation number change failed Changing the number of confirmations for the transaction by transaction hash failed, please make sure you're using the correct transaction hash, otherwise open a support ticket |
| 1423 | 400, 404 | Transaction | Get transaction by transaction hash failed Couldn't find a transaction with the specified transaction hash, please verify the transaction hash and try again |
| 1424 | 400 | Transaction, Network Connection | Destination address invalid Here is a list of parameters to check: 1. The address used is invalid for the asset you're using 2. The target (in case of a network transfer) does not contain a wallet for the specified asset 3. You're using the internal/external/contract wallet for a different workspace than the one you're performing the transaction on 4. You trying to send a transaction to a network connection which you do not have 5. You're using destinations one of the destinations is a network connections - this is not supported |
| 1425 | 400 | Transaction | Missing a tag You're trying to send a transaction to an address that requires a tag, please verify you're providing a tag |
| 1426 | 400 | Transaction | Unfreeze failed You tried to unfreeze a transaction, but it is not rejected nor failed by AML therefore it can't be unfrozen |
| 1427 | 400 | Transaction | Source type of transaction is invalid You tried to send a transaction with the source being invalid, verify that the source is one of: VAULT_ACCOUNT, EXCHANGE_ACCOUNT, GAS_STATION or FIAT_ACCOUNT |
| 1428 | 400 | Transaction | Destination of transaction is invalid The destination type of one of the destinations is not one of the defined enum in the API docs, verify that it is correct and try again |
| 1429 | 400 | Asset, Transaction | Validate address failed The asset you tried to use for the validate_address endpoint is not supported |
| 1431 | 400 | Asset, Transaction | Validate address didn't find an address The address provided to the validate_address endpoint is invalid. |
| 1432 | 400 | Transaction | Invalid amount specified The amount must be a number of a numeric string, verify it is so |
| 1433 | 400 | Transaction | Invalid tag specified The tag / memo specified does not comply with the rules of the blockchain, verify the tag / memo is valid |
| 1434 | 400 | Transaction | Freeze failed Freeze can only be done in confirming or completed state, the transaction you're trying to freeze is in neither of those states thus can't be frozen |
| 1435 | 400 | Transaction | List unspent for unknown asset You tried to get the unspent inputs (UTXO) for an asset that does not have such values or no UTXOs exist |
| 1437 | 400 | Exchange, Transaction | Unsupported transfer Direct transfers (Exchange to OTA) is not supported for Kraken exchange |
| 1438 | 400 | Transaction | External Tx ID Duplicate The externalTxId specified in the transaction was already used in the past, please use a different one |
| 1439 | 404 | Transaction | No such External Tx ID The external Tx ID used does not exist, please verify the external Tx ID you're using |
| 1440 | 400 | Transaction | Drop for unsupported blockchain You're trying to run a drop transaction request for a blockchain that is not ETC or ETH |
| 1441 | 400 | Transaction | Replace by fee too low You're attempting to perform a RBF transaction but the gas price you specified is too low, please check it and submit a higher gas price |
| 1443 | 400 | Transaction | Too late for RBF You're trying to replace by fee, but the transaction was already mined |
| 1445 | 403 | Transaction | User can't freeze The user that's trying to perform a freeze does not have the permissions to perform this, check the user's permissions and that you're using the correct user |
| 1446 | 403 | Transaction | User can't unfreeze The user that's trying to perform a unfreeze does not have the permissions to perform this, check the user's permissions and that you're using the correct user |
| 1448 | 400 | Transaction | Fee payer is not allowed for asset You're trying to define a fee payer for an asset which does not support it, please check whether the asset you're using allows for a fee payer configuration |
| 1449 | 400 | Transaction | Fee payer can't pay The defined fee payer does not have a wallet with the base asset to pay the fee, verify that you specified the correct fee payer and check that it contains a base asset wallet with a sufficient amount to pay for the transaction |
| 1450 | 400 | Transaction | Transactions are blocked for this blockchain We have temporarily disabled transactions for the specified blockchain, check the status page for more details |
| 1451 | 400 | Transaction | Transaction confirmations don't match Fireblocks restrictions Fireblocks requires a specific number or a minimum number of confirmations for some blockchains. Manually setting confirmations for a transaction must meet these requirements. For more, see Deposit Control & Confirmation Policy. |
| 1454 | 400 | Transaction | Missing license for creating a MEV protected transaction This feature is not enabled in your workspace and you should contact your Customer Success Manager or the Fireblocks Support team |
| 1502 | 400 | Asset, Transaction | Trying to use a deprecated asset The asset specified in the transaction is deprecated and can't be used, please check the asset and use a different one |
| 1503 | 400 | Asset, Balance, Transaction | Unsupported asset The asset specified is not supported, please check the asset you've specified |
| 1601 | 404 | Network Connection | Network Connection Id does not exist The network connection you're trying to query by id does not exist, please check the Id you're using |
| 1603 | 400 | Network Connection | Delete Network Connection but id is not specified The delete network connection request does not have a connectionId parameter specified, please make sure one is provided and is exists |
| 1604 | 400 | Network Connection | Create a network connection failed The network connection creation failed, check the error message for more information and open a support ticket if insufficient |
| 1605 | 404 | Network Connection | Get Network Connection for unknown id The network connection Id provided could not be found, please verify you're using the correct id |
| 1606 | 404 | Network Connection | Delete network connection for unknown id The network connection Id provided could not be found, please verify you're using the correct id |
| 1607 | 400 | Network Connection | Setting the routing policy for a network connection failed Verify that you used the proper parameters for the call |
| 1608 | 404 | Network Connection | Set routing policy for an unknown network connection id The id you provided for the call was not found, verify you're using the correct id and it exists |
| 1609 | 400 | Network Connection | Validating routing policy failed The attempt to validate whether the network connection's routing will lead to a third party or not for a given asset failed, please verify you passed the correct parameters and open a support ticket if needed |
| 1610 | 404 | Network Connection | Validating routing policy for an unknown network connection id The id you provided for the call was not found, verify you're using the correct id and it exists |
| 1611 | 403 | Network Connection | No multiple network profiles The workspace does not support multiple network profiles. Contact us to request support |
| 1612 | 422 | Network Connection | The counterparty rejected the connection request The Counterparty has to send a connection request. |
| 1613 | 422 | Network Connection | The counterparty is already an active connection The network connection already exists |
| 1614 | 422 | Network Connection | The connection is pending approval You can request approval from the workspace admins |
| 1615 | 422 | Network Connection | The connection is pending approval You can request approval from your counterparty |
| 1616 | 403 | Network Connection | Network connection cannot be deleted There is an active Smart Transfers ticket with the connection which must be closed before deleting the Network connection |
| 9007 | 404 | Network Connection | The Fireblocks Network is not activated in the workspace Reach out to support to resolve this |
| 9011 | 403 | Network Connection | Cannot delete network ID The default ID cannot be deleted before making another ID the default |
| 9012 | 403 | Network Connection | Network profile cannot be deleted It is the last remaining ID. There must be at least one Network profile per tenant |
| 9013 | 403 | Network Connection | Network profile cannot be deleted There is an active Smart Transfers ticket with the Network profile which must be closed before deleting the Network profile |
| 9014 | 422 | Network Connection | Invalid network name The name cant contain the ”<” and “>” characters |
| 9015 | 403 | Network Connection | Could not add an additional network ID Contact customer support to activate the feature |
| 9016 | 422 | Network Connection | The selected asset is not supported on the Fireblocks Network Reach out to support to resolve this |
| 9017 | 422 | Network Connection | Invalid routing policy > non-custom scheme A routing destination type or ID is required |
| 9018 | 422 | Network Connection | Invalid routing policy > destination ID incompatible with selected asset. Make sure you are sending a supported asset |
| 9019 | 422 | Network Connection | Invalid routing policy > selected routing policy is not allowed Select a valid routing policy |
| 9020 | 422 | Network Connection | Invalid routing policy > selected routing destination is not supported Select one of the supported destinations |
| 9021 | 422 | Network Connection | Invalid routing policy > selected crypto destination is not supported Select a vault or a connected exchange account. |
| 9022 | 422 | Network Connection | Invalid routing policy > third-party account provided is invalid Make sure you are adding a supported third party destination |
| 1706 | 400 | FIAT Accounts | FIAT Account id provided is unknown The exchange account id you provided was not found, please verify you're using the correct account id |
| 1708 | 400 | FIAT Accounts | FIAT Account id provided is unknown The exchange account id you provided was not found, please verify you're using the correct account id |
| 1901 | 400 | Asset, Transaction | Estimate fee for unknown asset The asset you specified for the estimate fee call is unknown, please make sure you're using a supported and known asset |
| 1902 | 400 | Asset, Transaction | Estimate fee for an invalid asset The asset you specified does not support the estimate fee call, please make sure you're using a supported and allowed asset |
| 1904 | 400 | Asset, Transaction | Estimate fee with invalid parameters Make sure when calling estimate fee you do not have destination and destinations parameters both used, and that the source parameter is a vault account |
| 1905 | 400 | Asset, Transaction | Estimate fee failed due to insufficient funds The funds you have in the source vault are not sufficient, and thus the estimate fee call failed, make sure you have sufficient base asset in the source vault and try again |
| 1907 | 400 | Asset, Transaction | Estimate fee failed due to smart contract error. The transaction reverted during its simulation as part of estimating the gas limit. There are three ways to properly handle this error: 1. Initiate the transaction again while using different parameters. 2. Try using a different vault to perform the transaction. 3. Read the contract’s source code to better understand the error. |
| 1908 | 400 | Asset, Transaction | Estimate fee failed since the amount you are sending is too small The transaction failed since the amount you tried to send was not enough to pass our balance validation and internal tx checks. Confirm the transfer amount is above the required minimum for this blockchain or more than the transaction fees necessary before resubmitting the transaction. Minimum transfer amounts vary per blockchain. Known minimums: Bitcoin (BTC) - 546 satoshi Cardano (ADA) - 1 ADA + applicable transaction fees |
| 1909 | 400 | Asset, Transaction | Estimate failed due to insufficient gas fees The transaction failed since you didn't have enough gas fees. Make sure you have sufficient gas money and try again. |
| 2002 | 400 | Public Key | Public key could not be found Make sure that the information you provided to the public key query is valid and a wallet for this asset exists in the specified vault account |
| 2101 | 400 | Gas Station | Invalid gas station parameters When editing gas station configuration make sure you provide both gasCap and gasThreshold |
| 2110 | 400 | Gas Station | Invalid asset for gas station When editing gas station configuration, the asset you specified is not supported for this operation, make sure you're using a support and valid asset |
| 2201 | 400 | Balance, Private Ledger | Lock/Release allocation for unsupported asset The asset you specified in the lock or release allocation call is not supported, make sure it is a valid and supported asset |
| 2202 | 400 | Balance, Private Ledger | Lock/Release Allocation for unknown account The virtual account you specified does not exist, please make sure you're using a valid virtual account that exists |
| 2204 | 400 | Private Ledger, Off-Exchange | Allocation not allowed The vault account you specified does not have off-exchange set-up, therefore locking allocation is not allowed, make sure you have off-exchange set and then try again |
| 2205 | 400 | Private Ledger, Balance | Insufficient amount for fee in allocation The call you're trying to perform requires that a sufficient amount for the fee bank is also allocated, the allocation amount you've specified does not meet this demand, please increase the allocation amount |
| 2501 | 400 | Webhooks | Resend webhook for specific tx id failed Make sure one of the parameters resendCreated and resendUpdated is marked as true and try again |
| 2602 | 404 | Off-Exchange | Unknown virtual account id Virtual account id specified does not exist, make sure you're using a virtual account id that exists |
| 2604 | 404 | Off-Exchange | Unknown virtual account id Virtual account id specified does not exist, make sure you're using a virtual account id that exists |
| 2702 | 403 | Users | Insufficient permissions for operation The user that's trying to perform this call does not have sufficient permissions for it, make sure you're using the correct user and they have the proper permissions to view the user list |
| 2814 | 400 | Fee Payer | Fee Payer not configured No fee payer was configured for this workspace, configure one and try again |
| 2816 | 400 | Fee Payer | Asset wallet does not exist You've attempted to set a fee payer by specifying a vault account and asset, however the specified asset does not have a wallet in the specified vault account, please create a wallet in the specified vault account and fund it then try again |
| 2817 | 400 | Fee Payer | Non-base asset You've specified a fee payer asset which is not the base asset, this is not allowed, please specify the base asset and try again |
| 2818 | 400 | Fee Payer | Unsupported asset You've tried to set a fee payer for an asset which is not supported, please verify you're using a supported asset and try again |
| 2902 | 403 | Audits | Getting audits is not allowed The user trying to get the audits is not allowed to due so due to a permissions matter, make sure that the user has the proper permissions and that you're using the correct user |
| 3001 | 404 | Smart Transfers | Ticket not found Fireblocks could not find the Smart Transfer ticket. |
| 3002 | 403 | Smart Transfers | Ticket should be open The attempted action can only be performed on an open Smart Transfer ticket. |
| 3003 | 403 | Smart Transfers | Ticket should be draft The attempted action can only be performed on a Smart Transfer ticket draft. |
| 3004 | 403 | Smart Transfers | Ticket should be draft or open The attempted action can only be performed on an open Smart Transfer ticket or a Smart Transfer ticket draft. |
| 3005 | 403 | Smart Transfers | Ticket action allowed for owner Only the Smart Transfer ticket creator can perform the attempted action. |
| 3006 | 403 | Smart Transfers | Ticket cancel can be done by payer You cannot close the Smart Transfer ticket because the connection already funded it. |
| 3007 | 403 | Smart Transfers | Ticket terms are missing You must define all required terms before you can open the Smart Transfer ticket. |
| 3008 | 403 | Smart Transfers | Ticket expiration date passed The Smart Transfer ticket has expired. |
| 3009 | 400 | Smart Transfers | Term not found No Smart Transfer ticket term matches your search criteria. |
| 3010 | 403 | Smart Transfers | Term should be created status The submitted or updated Smart Transfer ticket term is incorrect. |
| 3011 | 403 | Smart Transfers | Term should be funded status Only a funded Smart Transfer ticket can be closed. |
| 3012 | 403 | Smart Transfers | Term should be funding failed status The attempt to fund the Smart Transfer ticket failed. |
| 3013 | 403 | Smart Transfers | Term amount required You must enter a term amount before you can open a Smart Transfer ticket. |
| 3014 | 403 | Smart Transfers | Term asset required You must select an asset before you can open a Smart Transfer ticket. |
| 3015 | 403 | Smart Transfers | Term asset not supported Fireblocks does not support the selected asset for Smart Transfer tickets. |
| 3016 | 403 | Smart Transfers | Term from to should be different The Smart Transfer ticket must include two different connections. |
| 3017 | 403 | Smart Transfers | Term amount is different than fund amount The entered fund amount does not match the term amount on the Smart Transfer ticket. |
| 3018 | 403 | Smart Transfers | Term asset is different than fund asset The asset selected for funding does not match the term's asset on the Smart Transfer ticket. |
| 3019 | 403 | Smart Transfers | Counterparty not found Fireblocks could not find the counterparty connection. |
| 3020 | 403 | Smart Transfers | Network does not belong to tenant You can only open a Smart Transfer ticket using a Fireblocks Network profile belonging to you. |
| 3021 | 403 | Smart Transfers | Networks not connected The selected counterparty is not a Fireblocks Network connection. |
| 3022 | 403 | Smart Transfers | Term should be created or funding failed status The Smart Transfer ticket has already been funded or is currently being funded. |
| 3023 | 403 | Smart Transfers | Term transaction can be made by counterparty of term who should pay Your Fireblocks Network profile cannot fund the Smart Transfer ticket. |
| 3024 | 403 | Smart Transfers | Network connection does not belong to peers The Fireblocks Network connection funding the Smart Transfer ticket does not match the connection listed on the term. |
| 3025 | 403 | Smart Transfers | Transaction fee and fee level defined You cannot set a fee level (low, medium, or high) and specify a custom fee at the same time. |
| 3027 | 403 | Smart Transfers | Tickets can have at most two terms Smart Transfer tickets can only have two transfer terms. |
| 3029 | 403 | Smart Transfers | Network doesn't have FF enabled The Fireblocks Network connection does not use the Smart Transfer feature. |
| 3030 | 400 | Smart Transfers | Ticket missing expire in You must set an expiration date before you can open a Smart Transfer ticket. |
| 3031 | 403 | Smart Transfers | Ticket creator must receive asset You can only open a Smart Transfer ticket for receiving assets. |
| 9001 | 400 | Wallet | Invalid customer reference id The customer reference id specified is invalid, make sure it only consists of \-\_:a-zA-Z0-9 |
| 9003 | 400 | Transaction | Invalid idempotency key length The idempotency key must be no longer than 40 characters, please verify that if you've specified one, it has a proper length Idempotency key used on internal error request, returning bad request This operation doesn't support the usage of the same idempotency key after an internal error |
| 9005 | 400 | Transaction | A transaction with the same idempotency key is in progress Please wait until the previous transaction for this idempotency key is done before issuing a new one |
| 9006 | 400 | Network Connection | Missing required parameter in request body The request you've sent is missing the isDiscoverable parameter in the body, make sure it exists and is a boolean then try again |
| 9007 | 404 | Network Connection | Unknown network id The network id specified could not be found, please verify it exists and try again |
| 9009 | 400 | Network Connection | Parameters passed are invalid The parameters passed to the set_routing_policy call are invalid, please make sure they are correct and conform to the API docs then try again |
| 11001 | 400 | All | The specified vault account is invalid Please make sure that the vault account you've specified is correct, valid and exists |
| 12000 | 400 | All | Cloud provider issue There is an issue with one of our cloud providers, please check the status page for more details |
5XX Error Codes
10XX codes
| Error Code | Feature | Description |
|---|---|---|
| 1001 | Vault | Get Vault accounts paged failed |
| 1003 | Vault | Create vault account failed |
| 1005 | Vault | Get vault account failed |
| 1007 | Asset, Balance | Get balance for vault account and asset failed |
| 1009 | Wallet, Asset | Create wallet for asset failed |
| 1011 | Wallet | Adding a new address failed |
| 1012 | Wallet | Getting the addresses for the given asset failed |
| 1014 | Vault | Renaming a vault account failed |
| 1018 | Vault | Hide vault account failed |
| 1021 | Vault | Unhide vault account failed |
| 1029, 1030 | Asset, Balance | Get max spendable amount failed |
| 1033 | Asset | Get balance for assets or specific asset failed |
| 1036 | Asset | Fetching max BIP44 index used failed |
11XX codes
| Error Code | Feature | Description |
|---|---|---|
| 1101 | Exchange, Fiat | Failed to get exchange/fiat accounts |
| 1102 | Exchange | Failed to get exchange account by ID |
| 1104 | Exchange | Failed to get exchange account by ID and asset |
| 1107 | Exchange Transfers | Failed to perform an exchange account transfer (internal transfer) |
| 1110 | Exchange Transfers | Convert operation failed |
12XX codes
| Error Code | Feature | Description |
|---|---|---|
| 1201 | Internal Wallets | Failed to get internal wallets |
| 1202 | Internal Wallets | Failed to create an internal wallet |
| 1203 | Internal Wallets | Failed to get internal wallet by ID |
| 1205 | Internal Wallets | Failed to delete internal wallet |
| 1207 | Internal Wallets | Failed to create an internal wallet by asset |
| 1210 | Internal Wallets | Failed to get wallet by asset and wallet ID |
| 1211 | Internal Wallets | Failed to delete specific asset from wallet |
13XX codes
| Error Code | Feature | Description |
|---|---|---|
| 1301 | External Wallets | Failed to get external wallets |
| 1302 | External Wallets | Failed to create an external wallet |
| 1303 | External Wallets | Failed to get external wallet by ID |
| 1305 | External Wallets | Failed to delete an external wallet |
| 1307 | External Wallets | Failed to create an external wallet by asset |
| 1310 | External Wallets | Failed to get wallet by asset and wallet ID |
| 1311 | External Wallets | Failed to delete specific asset from wallet |
| 1350 | External Wallets | Failed to get external wallets |
| 1352 | External Wallets | Failed to create an external wallet |
| 1353 | External Wallets | Failed to get external wallet by ID |
| 1355 | External Wallets | Failed to delete external wallet |
| 1357 | External Wallets | Failed to create an external wallet by asset |
| 1360 | External Wallets | Failed to get wallet by asset and wallet ID |
| 1361 | External Wallets | failed to delete specific asset from wallet |
14XX codes
| Error Code | Feature | Description |
|---|---|---|
| 1404 | Transaction | Transaction creation or get failed |
| 1430 | Asset, Transaction | Validate destination address endpoint failed |
| 1436 | Transaction | List unspent inputs (UTXO) failed |
| 1444 | Transaction | Failed to get the transactions list |
| 1447 | Transaction | Failed to get transaction by external Tx ID |
15XX codes
| Error Code | Feature | Description |
|---|---|---|
| 1501 | Asset | Get supported assets failed |
17XX codes
| Error Code | Feature | Description |
|---|---|---|
| 1702 | Fiat Accounts | Get fiat account by ID failed |
| 1707 | Fiat Accounts | Redeem funds to DDA failed |
| 1709 | Fiat Accounts | Deposit funds from DDA failed |
19XX codes
| Error Code | Feature | Description |
|---|---|---|
| 1903 | Asset, Transaction | Estimate fee calculation failed |
20XX codes
| Error Code | Feature | Description |
|---|---|---|
| 2001 | Public Key | Getting public key information failed |
21XX codes
| Error Code | Feature | Description |
|---|---|---|
| 2102 | Fireblocks Gas Station | Setting gas station information failed |
22XX codes
| Error Code | Feature | Description |
|---|---|---|
| 2203 | Balance, Private Ledger | Lock allocation call failed |
25XX codes
| Error Code | Feature | Description |
|---|---|---|
| 2501 | Webhook | Resend webhook failed |
26XX codes
| Error Code | Feature | Description |
|---|---|---|
| 2601 | Off-Exchange | Get off-exchange failed |
| 2603 | Off-Exchange | Couldn't settle off-exchange with provided virtual account ID |
| 2605 | Off-Exchange | Failed to get off-exchange with specified ID |
27XX codes
| Error Code | Feature | Description |
|---|---|---|
| 2701 | Users | Failed to get users for workspace |
28XX codes
| Error Code | Feature | Description |
|---|---|---|
| 2813 | Fee Payer | Failed to get fee payer |
| 2815 | Fee Payer | Setting the fee payer failed |
| 2819 | Fee Payer | Deleting the fee payer configuration failed |
29XX codes
| Error Code | Feature | Description |
|---|---|---|
| 2901 | Audits | Failed to get audits |