How token migrations work — and how to do one safely.
When a project moves its token to a new contract, a new chain, or a new name, holders usually have to act. This guide explains what's happening, the main kinds of migration, and the exact steps to swap without losing funds. It applies to any token.
A token migration is the controlled swap of an old token for a new one. The old supply is usually frozen or burned and new tokens are issued to holders at a fixed ratio — so your share of the project stays the same even when the numbers change.
Four reasons a token migrates
Most migrations fall into one of these. The steps you take are similar, but the reason tells you what to expect.
Contract upgrade
A new smart contract fixes a bug, adds features, or improves security. Same chain, same project — just a better contract.
Chain move
The token moves to a different blockchain — often for lower fees or more users. You usually bridge or swap across networks.
Rebrand
The project changes name or ticker. The token itself may be functionally the same, but the symbol and branding change.
Redenomination
The supply is scaled up or down (say 100 old for 1 new) to make the per-token price easier to read. Your value is unchanged.
Migrating in six steps
This order keeps you from signing something you shouldn't. Never skip the verification step.
Confirm the migration is real
Read the official announcement on the project's verified channels. Note the ratio, the deadline, and the exact contract addresses.
Verify every address
Copy the new token and migration contract addresses from the announcement and check them against a block explorer. Compare character by character.
Connect the right wallet
Use the wallet that holds your old tokens. A legitimate portal only reads your public address — it never needs your seed phrase.
Approve a specific amount
Sign an approval for the exact amount you want to migrate, not an unlimited allowance. You can migrate in parts.
Migrate and confirm
Submit the swap. Your old tokens are taken and new ones arrive at the same address, usually within a block.
Add the new token
Import the new contract address into your wallet so the balance shows. Keep the transaction hash as your receipt.
Common questions
Do I lose money in a migration?
No. A legitimate migration keeps your share of the project the same. If the ratio changes the token count, your total value is unchanged — only the denomination differs.
What if I miss the deadline?
It depends on the project. Many keep the migration contract open indefinitely; others stop after the window and unmigrated tokens lose exchange support and governance rights. Always check the project's policy.
Do I need to do anything if my tokens are on an exchange?
Usually not. Major exchanges credit the new token to your account automatically. Check your exchange's announcement to be sure, and consider withdrawing to a self-custody wallet if they don't support it.
Why do some migrations change the supply?
To make the per-token price easier to read or to reset tokenomics. A 100-to-1 redenomination, for example, turns a fraction-of-a-cent token into a cleaner number without changing anyone's holdings proportionally.
How do I add the new token to my wallet?
Import it as a custom token using the new contract address from the official announcement. The symbol and decimals usually auto-fill once the address is recognized.