Wallet Types
A Trading Balance is designed for trading and uses an omnibus/pooled model. Funds are held together, with ownership tracked as separate balances on an internal Coinbase Prime ledger. Each asset within a portfolio has exactly one Trading Wallet ID, and balances are directly available for trading. A Vault wallet is designed for offline, segregated storage. Multiple Vault wallets can be created per asset, and each has its own Wallet ID. To learn more about creating Vault wallets, see Creating a Wallet.Omnibus Model
Trading Balance wallets use a pooled model with internal ledgering. This means onchain funds are not necessarily isolated per client or per portfolio at the address level. Instead, Prime tracks allocation by maintaining separate internal ledger balances per portfolio, wallet, and asset. Coinbase maintains the majority of assets held by Trading Balance wallets in offline storage and automatically moves assets to hot wallets based on client activity. Because of this model, reconciliation should rely on Prime balances and transaction/activity records rather than assuming onchain address-level segregation. For more detail on querying balances, see the Balances page.Trading
Trading uses Trading Balance wallets. Order placement references a portfolio, and the portfolio, product symbol, and side together determine which Trading Balance is used for debits and credits. For details on order placement and execution, see Trading Overview.Deposits
Getting deposit instructions for a Trading Balance is possible and is requested using a Wallet ID. A successful call to Get Wallet Deposit Instructions withdeposit_type=CRYPTO creates the default deposit address for the requested network if one does not already exist. Repeating the call for the same network returns the same address. Complete this step before the first onchain deposit or inbound transfer into the trading wallet. For more on deposit workflows, see the Deposits page.
Prime also supports generating unique deposit addresses to differentiate deposits into the same Trading Balance. Unique addresses enable deposit attribution and reconciliation while crediting the same underlying balance. This is particularly useful for Crypto-as-a-Service (CaaS) use cases. See Creating unique deposit addresses for details.