An address is a user-controlled account on a blockchain network. An address can hold a balance of one or more assets, and can be used to send or receive crypto. An address is backed by a private key, which provides access to spend the assets in the address. Addresses can list their balances and support various verbs depending on the type of address.

​
Address Types

Depending on how the associated private key is managed, addresses can be classified into two types, wallet and external.

​
Wallet Addresses

Wallet addresses belong to developer custodied wallets. See Creating a Wallet section. The private keys for these addresses are managed by the CDP SDK. Wallet addresses support all verbs that CDP SDK supports.

​
External Addresses

External addresses do not belong to CDP Wallets. The CDP SDK can be used to interact with these addresses; but because the SDK does not manage private keys for them, all signing operations are done off-platform. External addresses only support retrieving balances, staking verbs, and funding with testnet tokens with the faucet.
SDK Documentation You can refer to the Address class SDK docs for a full list of supported methods.

​
Creating Wallet Addresses

Wallet addresses belong to a wallet: 
let address = await wallet.createAddress();
A wallet comes with a single address by default, accessible via default_address.

​
Creating External Addresses

To create an External Address object, provide the address string and the network: 
let externalAddress = new ExternalAddress("base-sepolia", "YOUR_WALLET_ADDRESS");

​
Viewing Address IDs

To view the hexadecimal string that actually represents your address, use the address_id property: 
let addressId = address.getId();

​
Listing Address historical balances for an asset

To view the historical balances of assets of an address, call the following: 
let resp = await address.listHistoricalBalances(Coinbase.assets.Usdc);
let historicalBalances = resp.data;

​
Listing Address transactions

To view all transactions for a specific address in the blockchain, you can use the following code snippet: 
let resp = await address.listTransactions();
let transactions = resp.data;