Overview of vault accounts
Vault accounts are the top-level containers for your digital assets in Fireblocks. This article covers how to create, find, rename, archive, and hide vault accounts.
Create a vault account
Via the Fireblocks Console
- Go to Accounts > Vault.
- Select Create vault account.
- On the Create Vault Account dialog, enter the account name in the Account name field. Vault account names must consist only of ASCII characters.
- Select Auto-fuel with gas after an incoming transaction completes if applicable. For more information, see Fireblocks Gas Station.
- Select Create.
Via the Fireblocks API
Use the following endpoint and SDKs to create a single vault account:
Create vault accounts in bulk
You can use the Fireblocks API to create up to 10,000 vault accounts in a single operation.
Use the following endpoint and SDKs to create vault accounts in bulk:
Use the following endpoint and SDKs to check the status of a bulk creation job:
Find a vault account
Use the search bar on the Vault page to find any vault account by name or deposit address. You can also open a vault account and use the search bar to find asset names, asset symbols, blockchains, or any deposit address within that account.
When searching for a deposit address, you can use permanent addresses and other addresses, as well as memos, notes, and tags for assets that support those fields. For assets that support multiple address formats, you can search using SegWit, Legacy, or any other available format. Searching by address description is not supported for assets that support multiple addresses.
Rename a vault account
You can rename a vault account at any time. Vault account names don't affect any asset wallets or deposit addresses within the account.
- Go to Accounts > Vault.
- Find the vault account you want to rename and select More actions (…) > Rename.
- On the Rename vault account dialog, enter the new name.
- Select Rename.
You cannot rename P2P Network vault accounts
These accounts display a Fireblocks Network badge on them.
Archive or unarchive a vault account
Since you can't delete vault accounts, archiving is one way to keep your Vault organized. Archiving removes an account from your active view and excludes it from your Vault's balance chart, but the account remains available via the Fireblocks API.
Important notes about archived accounts
- Archived accounts can still receive incoming transactions. When this happens, the account is automatically unarchived.
- You cannot select an archived account in the Console as a transaction's source or destination. However, archived accounts are always available via the Fireblocks API.
- Archived accounts are not included in your Vault's balance chart.
- Transactions involving archived accounts still appear in your transaction history.
- You cannot archive accounts linked to Fireblocks Network connections.
Archive a vault account
- Go to Accounts > Vault.
- Find the vault account you want to archive, then select More actions (…) > Archive.
- Select Archive.
Unarchive a vault account
- Go to Accounts > Vault.
- Select Show archived to see all archived accounts.
- Select Unarchive for the appropriate account.
Hide or unhide a vault account
Hiding a vault account removes it from view in the Fireblocks Console while keeping it fully accessible via the Fireblocks API. Unlike archiving, hiding an account does not unarchive it when the account receives an incoming transaction.
Important notes about hidden accounts
- Hidden accounts can still receive incoming transactions. This does not unhide the account. These transactions don't appear in your Recent Activity panel, but you can view them in your transaction history.
- You cannot select a hidden account in the Console as a transaction's source or destination. However, hidden accounts are always available via the Fireblocks API.
- Hidden accounts are not included in your Vault's balance chart.
- Transactions involving hidden accounts still appear in your transaction history.
You can hide and unhide accounts individually or in bulk via the Fireblocks API. Use the following endpoints:
To check a vault account's hiddenOnUI status, use the following endpoints:
- Get vault account by ID (for a single account)
- Get vault accounts (paginated) (for multiple accounts)
Archive vs. hide: which should you use?
Both archiving and hiding remove vault accounts from your active Console view, but they serve different use cases. Use the table below to decide which approach fits your situation.
| Archive | Hide | |
| Best for | Workspaces with fewer than 100 accounts, accessed primarily via the Console | Workspaces with thousands or millions of accounts, accessed primarily via the API |
| Incoming transactions | Automatically unarchives the account | Account stays hidden |
| Console visibility | Hidden unless you select Show archived | Not visible in the Console |
| API availability | Always available | Always available |
| Included in balance chart | No | No |
| Transactions in history | Yes | Yes |
| Can transact via Console | No | No |
| How to perform | Console or API | API only |