- Trading Balance: A wallet that is part of an omnibus account, directly available for trading. Each asset within a portfolio has exactly one Trading Balance Wallet ID.
- Custodial Vault Wallet: A wallet maintained within Coinbase Custody, where assets are held offline and segregated. Multiple vault wallets may be created for each asset by calling Create Wallet. Each vault wallet has its own Wallet ID.
- Onchain Wallet: To learn more about this wallet type, visit Onchain Wallet
Creating a Wallet
Trading Balance Wallets are automatically created under one of the following conditions:- When a user first navigates to an asset in the Prime UI
- When a user places a trade for that asset
- After calling Create Wallet with the
TRADING
wallet type
VAULT
type. Below are examples of this process.
After a wallet creation request for a vault wallet is submitted, the response will include an Activity ID. Since most actions within Prime require consensus approval, a review step in the UI must be completed. Once the wallet creation is approved, the new wallet’s details, including its Wallet ID, can be looked up.
- Java
- .NET
- Go
- Python
- CLI
- TS/JS
Finding a Wallet ID
Use the List Portfolio Wallets endpoint to retrieve all wallets for a portfolio, optionally filtering by wallet type or other parameters. If preferred, wallets may be located by name using a utility script, such as the Get Wallet by Name example from the Coinbase Samples scripts repository. Below is an example of how to list all vault wallets for a portfolio.- Java
- .NET
- Go
- Python
- TS/JS
- CLI