All Collections
Transactions / Tags
Bulk editing/searching
Change Currency (if Koinly imported the wrong token)
Change Currency (if Koinly imported the wrong token)
R
Written by Robin Singh
Updated over a week ago

In Koinly, you can now 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.

Possible scenarios

  1. I imported my trades from an Exchange (API) but the token I traded was misidentified - Koinly interpreted it as a completely different token. Now my dashboard is incorrect because the value of this token is wrong

  2. I synced my non-custodial wallets (i.e. Ethereum), but a bridge I did with one of the tokens between my wallets didn't merge - I notice that the bridged token is "gray" (unrecognized) and doesn't have a market price

Changing the token to a different one

  1. 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)

  2. Click the 3-dot menu next to the transaction you found

  3. Choose the option "Change Currency"

  4. In the modal popup, choose the currency you want to change (on the left) and the currency you want it to be mapped to (on the right) from now on

  5. 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.

  1. Go to Settings

  2. Click "Rules" in the menu to the left

  3. Click the red cross mark icon next to the rule you want to delete

  4. The rule is deleted automatically and will no longer be applied to any future syncs

Reverting the changes made with a rule

While deleting the rule will not revert the changes done, it's still usually possible to work around it:

  1. Delete the rule created by mistake

  2. Go to your Transactions and locate one of the transactions with the mapped token

  3. Create a reverse rule, pointing the mapped token back to the original token

  4. After the rule is applied, delete it from the settings

This workaround will not work if you mapped to a token that already had transactions in the wallet (your reverse rule will remap everything). In such cases, you need to delete and recreate the wallet to revert the changes done.

Limitations

1. 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. Since there may be multiple tokens with the same symbol, look out for:

  • 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?

2. 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 remember to lock all past transactions. Otherwise, you risk importing duplicates. See how to lock your transactions in How to lock your transaction history.

3. Changing the currency is available only for API-imported wallets

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.

It's not currently possible to create a rule for CSV-imported wallets. To fix a currency mapping on CSV-imported wallets, use bulk edit: Bulk editing and deleting.

4. This change is irreversible

Removing the rule after creating it will not remap the tokens back (though usually a workaround mentioned above in Reverting the changes made with a rule will be enough)

Did this answer your question?