Introduction
For developers deploying ERC-20 tokens on Base Mainnet, ensuring your token’s metadata (logo, name, description) appears promptly in Coinbase Wallet is crucial. This guide covers the steps to optimize visibility and troubleshoot common issues.
How to Add Your Token to Coinbase Wallet
Step 1: Deploy Your ERC-20 Token Contract
- Write and deploy a compliant ERC-20 smart contract on Base Mainnet.
- Use tools like Remix IDE or Hardhat for testing before deployment.
Step 2: Prepare Token Metadata
- Logo: Upload a high-resolution (minimum 256x256 pixels), transparent PNG/SVG file.
- Descriptions: Keep asset names concise (e.g., "BaseQuest Token").
Step 3: List on Aggregator Platforms
- Free Option: Submit to CoinGecko (takes 5–7 days).
- Paid Option: Fast-track listing via CoinMarketCap.
👉 Learn how to optimize your token's metadata
Note: Metadata updates may take 24–48 hours to reflect in Coinbase Wallet.
Troubleshooting Token Visibility
Why Is My Token Labeled as "Newer"?
- Tokens with <$1M market cap appear under "Newer Tokens" in swaps.
- Solution: Boost trading volume to exit this section.
Updating Token Logo/Description
- Visit Coinbase Wallet’s asset page.
- Click "Update here" at the bottom of your token’s profile.
- Upload new assets and submit via the deployer address.
Pro Tip:
- Post updates from official X/Farcaster accounts to expedite approval.
Promoting Your Token
Custom Trading Links
- Navigate to your token’s page in Coinbase Wallet.
- Click Share > Copy the link.
- Distribute via social media or community channels.
Trending Swaps on Base
- Encourage trading activity to feature in Trending Swaps, visible to 10M+ Coinbase Wallet users.
Send via Text
- Share tokens via SMS/Twitter links. Recipients claim via Coinbase Wallet.
- Supported: Top 100 Base tokens (expanding soon).
FAQs
Q: How long does it take for logo updates to appear?
A: Typically 24–48 hours after aggregator approval.
Q: Can I list my token for free?
A: Yes, via CoinGecko. CoinMarketCap requires a fee.
Q: Why isn’t my token searchable?
A: Ensure it’s listed on at least one major aggregator (Birdeye, CoinGecko).
👉 Explore advanced token deployment strategies
Need Help?
Submit issues via Coinbase Wallet’s support form. Responses within 5 business days.
Final Tip: Regularly update metadata and engage your community to maintain token visibility!