How to Add a Custom Token to TPWallet

Navigating the world of decentralized finance (DeFi) and self-custody crypto wallets often means interacting with a wide range of digital assets beyond the most popular coins like Bitcoin, Ethereum, or Tether. For users of TPWallet, one of the most widely used multi-chain crypto wallets across global markets, the ability to add custom tokens is a critical feature that unlocks access to thousands of emerging projects, niche DeFi protocols, community-driven meme coins, and personalized token assets built on supported blockchains. Whether you are participating in a new token presale, holding a reward token from a yield farming platform, or managing a custom token you created for your own project, knowing how to add a custom token to TPWallet ensures you can view, send, receive, and manage your full crypto portfolio in a single, secure interface.

Before diving into the step-by-step process, it is important to understand what a custom token is and why you might need to add it manually. TPWallet automatically displays a curated list of well-known, high-liquidity tokens for each supported blockchain to keep the user interface clean and reduce clutter. However, with tens of thousands of tokens deployed on networks like Ethereum, BNB Chain, Polygon, Arbitrum, Optimism, Solana, and dozens of other chains supported by TPWallet, it is impossible for the wallet to pre-list every existing asset. Custom tokens include newly launched project tokens, small-cap community coins, governance tokens from lesser-known DeFi protocols, non-standard fungible tokens, and even testnet tokens used by developers to build and test blockchain applications. Adding these tokens manually lets you track their balance and transact with them directly from your TPWallet interface, just like you would with any pre-listed asset.

First, you need to ensure your TPWallet is set up correctly and you have selected the right blockchain network for the custom token you want to add. This is one of the most common mistakes new users make: adding a token’s contract address on the wrong chain, which will result in a zero balance display or even lead to lost funds if you try to send tokens to an incompatible address. Start by opening your TPWallet app on your mobile device (TPWallet is available for both iOS and Android, and the process is nearly identical across both platforms). If you have multiple wallets imported or created, make sure you are accessing the correct wallet address where you hold or plan to receive the custom token. Next, navigate to the network selection menu, which is usually located at the top of the home screen, displayed as the name of your currently active network (for example, “Ethereum Mainnet” or “BNB Chain”). Tap on the network name to open the full list of supported networks, then scroll or use the search function to find the blockchain where your custom token is deployed. If you do not see the network you need, you can add a custom RPC network first by tapping the “Add Network” button, entering the required chain details including chain ID, RPC URL, block explorer URL, and native currency symbol, then saving the new network to your wallet.

Once you are on the correct blockchain network, return to the wallet home screen where your token balance list is displayed. At the bottom of the token list, you will usually find an option labeled “Add Token” or “Custom Token” — the exact wording may vary slightly depending on your TPWallet version, but it is always clearly marked to help users add new assets. Tap on this button to open the custom token addition page. On this page, you will be prompted to enter the token’s contract address, which is the unique on-chain identifier for the token smart contract. This is the most important piece of information you will need, and it is crucial that you get this address from a trusted source to avoid scam tokens. You can find the official contract address for a token on the project’s official website, its verified social media channels, or a reputable block explorer like Etherscan, BscScan, or Polygonscan by searching for the token name and verifying the contract is marked as verified and matches the details shared by the project team. Never use a contract address sent to you by a random person in a direct message, as this is a common phishing tactic used to trick users into interacting with fake scam tokens.

After you paste or type the token contract address into the designated field, TPWallet will automatically pull the token’s details from the blockchain, including the token name, token symbol, and number of decimal places. In most cases, these details will be filled in automatically and you will not need to edit them, but it is a good practice to double-check that the token name and symbol match the official token you want to add, to make sure you entered the correct contract address. If for some reason the wallet does not auto-fill these details, you can enter them manually using the information from the official project or block explorer. Pay special attention to the decimal places field, as entering the wrong number of decimals will cause your balance to display incorrectly — for example, a token with 18 decimals will show a balance 1,000,000,000,000,000,000 times higher than the actual amount if you accidentally set decimals to 0. Once all fields are filled correctly, tap the “Add” or “Confirm” button at the bottom of the screen to finalize the process.

Within a few seconds, the custom token will appear in your token list on the home screen of your TPWallet, and you will be able to see your current balance of that token if you already hold it in your wallet address. You can tap on the token to view more details, including your transaction history for that asset, send the token to another wallet address, or receive more of the token by sharing your wallet address (always make sure the sender is sending the token on the same blockchain network you added the token on). You can also rearrange your token list by holding and dragging tokens to different positions, or hide tokens you no longer need by tapping the edit button on the token list page, to keep your wallet interface organized and focused on the assets you use most frequently.

There are several important best practices to keep in mind when adding custom tokens to TPWallet to protect your funds and ensure a smooth experience.