Assets

An asset is a representation of value on a blockchain network. Common types of assets include (fungible) tokens and NFTs (non-fungible tokens). CDP APIs support certain popular assets by their symbols and the vast majority by their contract addresses.

Assets supported by symbol

The CDP APIs support the following assets on the Base Sepolia & Mainnet networks to be identified by their symbols.

Asset	Type	Base-Mainnet	Base-Sepolia	Description
Ether, also known as ETH	native	✅	✅	This is the native token of many networks that run on the Ethereum Virtual Machine (EVM), including Base. ETH is used to pay for transactions on the network, and the network provides native APIs to send, receive, and otherwise interact with ETH.
USDC	ERC‑20	✅	✅	backed 1:1 by a U.S. Dollar.
WETH	ERC-20	✅	✅	backed 1:1 by ETH.
DAI	ERC-20	✅	➖	Dai Stablecoin on Base-Mainnet.
RETH	ERC-20	✅	➖	Rocket Pool ETH on Base-Mainnet.
BRETT	ERC-20	✅	➖	Brett on Base-Mainnet.
W	ERC-20	✅	➖	Wormhole Token on Base-Mainnet.
CBETH	ERC-20	✅	➖	Coinbase Wrapped Ether on Base-Mainnet.
AXL	ERC-20	✅	➖	Axelar on Base-Mainnet.
IOTX	ERC-20	✅	➖	IoTeX on Base-Mainnet.
PRIME	ERC-20	✅	➖	Prime on Base-Mainnet.
AERO	ERC-20	✅	➖	Aerodrome on Base-Mainnet.
RSR	ERC-20	✅	➖	Reserve Rights on Base-Mainnet.
MOG	ERC-20	✅	➖	Mog Coin on Base-Mainnet.
TBTC	ERC-20	✅	➖	Base tBTC v2 on Base-Mainnet.
NPC	ERC-20	✅	➖	Non-Playable Coin on Base-Mainnet.
YFI	ERC-20	✅	➖	Yearn Finance on Base-Mainnet.

In addition to Base, CDP APIs also support ETH & USDC on Ethereum Mainnet, MATIC & USDC on Polygon Mainnet and ARB & USDC on Arbitrum Mainnet.

Assets supported by contract address

Besides the assets listed in the above table, CDP APIs support all other ERC20 tokens using their respective contract addresses.

Transfer an ERC20 from a wallet with contract address

The following example demonstrates how to create a transfer for USDC on Base-Sepolia using its contract address. Use Circle faucet to fund your wallet.

Typescript

let wallet = await Wallet.create({ networkId: Coinbase.networks.BaseSepolia });

const transfer = await wallet.createTransfer({
  amount: 0.0001,
  assetId: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
  destination: anotherWallet,
});

// Wait for the transfer to complete.
await transfer.wait();

Trade an ERC20 in a wallet with contract address

The following example demonstrates how to create a trade for USDC on Base-Mainnet using its contract address. Remember to fund your wallet with USDC to complete the trade.

Typescript

let wallet = await Wallet.create({ networkId: Coinbase.networks.BaseMainnet });

// Out-of-band: Fund the wallet.

// Create trade from ETH to `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`.
let trade = await wallet.createTrade({
  amount: 0.00001,
  fromAssetId: Coinbase.assets.Eth,
  toAssetId: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
});

// Wait for the trade to complete.
await trade.wait();

Fetch balances for assets

Fetch balance for assets identified by symbol

Typescript

let balance = await wallet.getBalance(Coinbase.assets.Eth)

Fetch balance for assets identified by contract address

Typescript

let balance = await wallet.getBalance("0x036CbD53842c5426634e7929541eC2318f3dCF7e")

Denominations of ETH

ETH provides 18 places of decimal precision. The smallest amount of sendable ETH is 10^-18, also known as a Wei.

Commonly used denominations of ETH:

Denomination	Amount in Wei	Description
Wei	1 Wei	Smallest denomination of ETH
Gwei	109 Wei	Denomination of ETH commonly used for gas (i.e., transaction fee) calculations
Ether / ETH	1018 Wei	Largest denomination of ETH, commonly used for trading

The SDK supports transfers in denominations of Wei, Gwei, and ETH.

Typescript

SDK Documentation

You can refer to the Asset class SDK docs for a full list of supported methods.

In Node.js, asset IDs are accessed through the assets property of the Coinbase class.

• ETH’s asset ID is Coinbase.assets.Eth
• USDC’s asset ID is Coinbase.assets.Usdc
• WETH’s asset ID is Coinbase.assets.Weth