In Koinly, you can map a token to a different one from the database, changing it for all previously imported and future transactions. This article describes when and how to do it.
This functionality is useful in all scenarios where Koinly imported the wrong asset:
How to change currency
Find a transaction with the wrong token
Go to your "Transactions" page and locate one of the transactions with the token you want to map (it can be any transaction with this token)
Use change currency
Click the 3-dot menu next to the transaction and select "Change Currency"
Point to the right token
In the modal popup, choose the currency you want to change from (on the left) and the currency you want it to be mapped to (on the right) from now on. If there are multiple tokens with the same symbol, find the right one using the contract address instead.
Confirm changes
Click "Continue" and wait a few minutes for the change to be applied across all your wallets on this particular blockchain
Video presenting the steps above:
Deleting a created rule
If you created a currency rule by mistake, you can remove it
Go to Settings
Click "Rules" in the menu to the left
Click the red cross mark icon next to the rule you want to delete
The rule is deleted automatically and will no longer be applied to any future syncs
Reverting the change
Reverting the effects of a "Change currency" rule is often impossible and you will need to recreate the wallet (delete it and add it again) to undo the changes.
But if you changed the token to one you never transacted with on the wallet (e.g. you changed USDC to USDT, but you never used USDT in this wallet) then it's possible to undo the change with a workaround:
Delete the faulty rule you created
Find one of the modified transactions on the Transactions page
Create a reverse rule, pointing the mapped token back to the original token
After the rule is applied, delete it from the settings
Limitations
This feature has some important limitations you should be aware of:
Correct token needs to already exist in Koinly's database
The correct token (the one you want to map to) needs to already exist in Koinly. Check the Markets page (https://app.koinly.io/p/markets) to confirm if the token exists. There may be multiple tokens with the same symbol, so confirm by checking:
The logo
Does the token have the same logo as the one you are looking for?Market price
Does the token have the same unit price as the one you are looking for?
You need to set a lock date to avoid importing duplicates
After making this change (and any other currency changes you might need), you need to to lock all past transactions. Otherwise, you risk importing duplicates. See how to lock your transactions in How to lock your transaction history.
Changing the currency is available only for API-imported wallets
"Change currency" will be available for API-imported transactions only
To fix a currency mapping on CSV-imported wallets, use bulk edit: Bulk editing and deleting.
Rule is applied to all wallets of the same type
Any currency rule created will be automatically applied to all API-connected wallets of the same type (e.g. to all Solana wallets).
If you want to apply a similar change to another blockchain (e.g. Ethereum), you need to create a second rule.
This change is irreversible
If you added a rule by mistake, you can delete it but it will not undo the changes to the already imported (and remapped) transactions
In some cases, there is a way to revert the changes - the workaround is mentioned above