Understanding Multi-Network Balances
Prime maintains consolidated trading balances for each asset, regardless of which network deposits or withdrawals occur on. When you use the Prime Trading Balance, all network-level activity is aggregated into a single asset balance. For example, if you deposit 1 USDC on Ethereum and 1 USDC on Base, you’ll see:- Two separate transaction records, each with its own network-specific symbol (
usdcandbaseusdc) - A combined balance of 2 USDC in your USDC trading balance
Supported Assets and Networks
Prime currently supports multi-network functionality for the following assets:| Asset | Network | Network-Scoped Symbol |
|---|---|---|
| USDC | Ethereum | usdc |
| USDC | Avalanche C-Chain | avausdc |
| USDC | Optimism | optusdc |
| USDC | Base | baseusdc |
| USDC | Solana | splusdc |
| USDC | Arbitrum | arbusdc |
| ETH | Ethereum | eth |
| ETH | Base | baseeth |
| BTC | Ethereum | cbbtc |
| BTC | Base | basecbbtc |
Network-Scoped Symbols
To distinguish assets on different networks, Prime uses network-scoped symbols. These symbols appear in transaction records and API responses to indicate which specific network an asset is associated with. When calling the List Assets endpoint, the response includesnetwork_details for each supported network, with a unique network_scoped_symbol for each network where the asset is available.
For example, a subset of the USDC response includes:
usdcfor Ethereumbaseusdcfor Baseoptusdcfor Optimism
Working with Network-Specific Data
Many Prime API endpoints now include network information and filtering capabilities:Transactions and Activities
When working with transactions, you can typically filter by network-scoped symbols to isolate activity for a specific asset-network pair:- List Portfolio Transactions - Returns
networkfield for onchain transactions - Get Transaction by ID - Returns
networkfield for onchain transactions - List Entity Activities - Filter activities using
symbolsparameter with network-scoped symbols - Create Withdrawal - Accepts optional
networkparameter to specify the destination network for onchain withdrawals. When left out, the withdrawal will default to the default network for a given asset, which is specified by data included in List Assets.
Wallets
Wallet endpoints now include network information for vault wallets:- List Portfolio Wallets - Returns
networkfield for vault wallets - Get Wallet by ID - Returns
networkfield for vault wallets - Create Wallet - Accepts optional
networkparameter for vault wallets - Get Wallet Deposit Instructions - Accepts optional
networkparameter and returnsnetworkfield for onchain deposits - Create Wallet Deposit Address - Requires network and generates a network-specific deposit address