Skip to main content

Settings > Dust value threshold

Stop showing "Missing purchase history" warning for low-value transactions

Written by Jack

In your Portfolio settings (Settings → Portfolio) you can set the Dust value threshold. This article explains what effect this feature has when viewing your transactions.

Dust value threshold is directly related to "Missing purchase history". You can read more about this warning in:

If you're selling more of an asset than you hold at the time (e.g. you hold 1.5 ETH and import sale of 5 ETH) Koinly will show a "Missing purchase history" warning.

Usually, "Missing purchase history" indicates errors in your imported transactions (missing data, duplicated data, etc.) that you would want to fix to increase the accuracy of your reports.

But sometimes small inaccuracies in the asset amounts imported (e.g. due to rounding) have close to zero effect on your gains calculations while resulting in many "Missing purchase history" errors in your account - making it harder to find real issues with your data.

If you have a lot of errors like that and want to hide them from the Transactions page, you can set the Dust value threshold in your Settings.

How to set the dust threshold

  1. Go to Settings → Portfolio

  2. Change the amount shown in Dust value threshold
    Set it to one you believe is small enough that can be ignored. Mind that the dust value is always set in your base currency.

  3. Click "Save" at the bottom of the page to confirm the change

ℹ️ Default dust threshold value

Dust threshold is by default set to 1 unit of your base currency (1 USD, 1 GBP, 1 EUR, etc.).

After the value is set, missing assets worth less than dust threshold will not be showing the "Missing purchase history" warning anymore. E.g. there's 0.1 USDC missing on this transaction, but because 0.1 USDC is worth less than the dust threshold set, it doesn't result in a visible error:

And this transaction will not show up when filtering by "Missing purchase":

☝️ Dust value threshold doesn't fix any errors

Warnings hidden due to Dust value threshold set in your account are not fixed - they are just hidden. Negative balances still remain in your transaction history.

Use this setting only to hide errors you don't want to fix and you're fine with accepting $0 cost basis (and higher capital gains) on the dust amounts sold

How to disable dust threshold

If you don't want Koinly to hide any "Missing purchase" warnings no matter how small, change the dust threshold to zero (0.00).

Dust threshold and missing prices

Assets with an unknown price where the balance after the transaction turns to negative will always show on the Transactions page no matter the Dust value threshold set. Since the current market value of the missing asset is unknown, Koinly cannot compare it to the threshold set and leaves the warning visible.

Such transactions may disappear from "Missing purchase" filter after you set the market worth (if it results in value of missing assets being lower than the dust threshold). You could say that you should first fix all "Missing prices" errors and then investigate "Missing purchase".

📌 Example

This withdrawal of BOBO2 has the cost basis of $0 and worth is assumed $0 (unknown) but the transaction is still shown when filtering by "Missing purchase" because the actual market value is unknown and balance turned negative:

Common questions and issues

"Missing purchase" filter shows zero or few results

If you're filtering your transaction history by "Missing purchase" and don't see transactions you'd expect to see, it's probably due to Dust threshold set. Change the threshold to zero (temporarily) to reveal all transactions where the asset's balance turns to negative, no matter how small.

Did this answer your question?