Mapping errors are rare, but when they occur, they can result in incorrect market prices and, consequently, inaccurate portfolio values or capital gains.
How token identification works
When you import your transactions, CryptoBooks automatically identifies the tokens and assigns the market price based on their ticker, metadata, and automated matching criteria.
In most cases, the system correctly assigns the right token and accurately calculates portfolio values and capital gains.
When a mapping error can occur
When there are many tokens that share the same ticker (symbol), mapping errors can occur.
In practice, the software may automatically associate one token with another that uses the same symbol, even if they are different assets. This happens because the ticker is not a unique identifier: multiple projects can use the same symbol on different blockchains or even on the same network.
As a result, a token could be:
• valued at the wrong price
• linked to the wrong contract
• considered as a different asset from the one actually held
How to recognize an incorrectly mapped token
The most common signs include:
the token symbol is different from what you expected
the token name doesn’t match the correct one
the total portfolio value in CryptoBooks doesn’t match your actual holdings
some transactions show unusually high or low values
capital gains appear exaggerated or inconsistent
What to do first
Before contacting support, we recommend:
checking that the token ticker, name and contract match the correct project
verifying on which connection/blockchain the issue occurs (exchange or wallet)
noting the date and time of the affected transactions and, if possible, providing the blockchain explorer link showing the token contract
How to fix it with CryptoBooks Support
If you suspect a mapping error, report the issue to our team. We’ll manually verify the match and remap the token in our database if needed.
Once corrected, the system will automatically recalculate prices, values, and capital gains.
To solve this issue contact Support via the in-app chat or by email at customer.support@cryptobooks.tax
To speed up the process, please include:
the correct token ticker, name and contract you expected to see
the current incorrect token name or symbol displayed
transaction IDs or details (including date and time)
the affected exchange or wallet connection
any relevant screenshots or blockchain explorer links
⚠ Temporary effects
Until the issue is fixed, your portfolio value and capital gains may appear incorrect. We recommend waiting to generate final tax reports until the mapping has been resolved.