{"id":1274,"date":"2026-01-01T19:36:12","date_gmt":"2026-01-01T19:36:12","guid":{"rendered":"https:\/\/tokenmetrics.mystagingwebsite.com\/?p=1274"},"modified":"2026-02-10T19:43:57","modified_gmt":"2026-02-10T19:43:57","slug":"koinly-troubleshooting","status":"publish","type":"post","link":"https:\/\/tokenmetrics.com\/blog\/koinly-troubleshooting\/","title":{"rendered":"Koinly Troubleshooting: Fix Common Issues With Your Crypto Tax Report"},"content":{"rendered":"\n

Koinly<\/a> does an impressive job of automating crypto tax calculations, but with thousands of exchanges, wallets, and blockchains in play, occasional issues are inevitable. The good news is that most problems have straightforward fixes. This guide walks you through the most common Koinly issues and how to resolve them quickly.<\/p>\n\n\n\n

Why Are My Wallet Balances Wrong?<\/h2>\n\n\n\n

Incorrect wallet balances are the single most common issue users encounter, and the cause is almost always one of two things:<\/p>\n\n\n\n

Exceeding the free plan limit: <\/strong>If you import more than 10,000 transactions on the free plan, Koinly halts all calculations. This means wallet balances, dashboard data, and gains summaries may display incorrect numbers. The fix is to purchase a paid plan that covers your total transaction count, or delete excess transactions you don\u2019t need.<\/p>\n\n\n\n

Incomplete data: <\/strong>If you\u2019ve only connected some of your exchanges or wallets, Koinly can\u2019t see the full picture. For example, if you transferred Bitcoin from Coinbase to a Ledger wallet but haven\u2019t added the Ledger, Koinly sees a withdrawal with no corresponding deposit \u2014 creating a balance discrepancy. The fix is to add all wallets and exchanges where you\u2019ve held or moved crypto.<\/p>\n\n\n\n

Why Is Koinly Matching My Transfers Incorrectly?<\/h2>\n\n\n\n

Koinly<\/a> uses smart algorithms to automatically match withdrawals from one wallet with deposits into another, recognizing them as non-taxable transfers between your own accounts. However, this matching can go wrong when:<\/p>\n\n\n\n

Similar amounts at similar times: <\/strong>If you moved 1 BTC from Binance to Coinbase and also moved 1 BTC from your Ledger to Trezor around the same time, Koinly might accidentally pair the wrong withdrawal with the wrong deposit.<\/p>\n\n\n\n

Exchange delays: <\/strong>Some exchanges report deposits with a time lag, causing the timestamps to not align cleanly.<\/p>\n\n\n\n

To fix mismatched transfers, delete the incorrectly matched transactions and manually create the correct transfer pairings. You can do this from the Transactions page by selecting the affected entries.<\/p>\n\n\n\n

How Do I Handle Missing Cost Basis?<\/h2>\n\n\n\n

A missing cost basis means Koinly doesn\u2019t know how much you originally paid for a particular asset. This usually happens when you imported an exchange account but didn\u2019t import the wallet or exchange where you originally purchased the crypto. Without knowing the purchase price, Koinly can\u2019t accurately calculate your gain or loss on the sale.<\/p>\n\n\n\n

To resolve this, import the original source of the asset. If that\u2019s not possible (for instance, the exchange no longer exists), you can manually add a deposit transaction with the correct cost basis and date. Koinly also lets you set a default cost basis for unmatched assets in the settings.<\/p>\n\n\n\n

How Do I Import Data From an Unsupported Exchange or Wallet?<\/h2>\n\n\n\n

Even if your exchange or wallet isn\u2019t in Koinly\u2019s list of 800+ integrations, you can still import your data. Create a \u201ccustom wallet\u201d in Koinly<\/a> and upload a CSV file formatted according to Koinly\u2019s universal template. The template requires columns for date, type (deposit\/withdrawal\/trade), sent amount, sent currency, received amount, received currency, and fee. Koinly\u2019s help center provides a downloadable template and detailed formatting instructions.<\/p>\n\n\n\n

Why Do I See Gains on Transfers?<\/h2>\n\n\n\n

Transfers between your own wallets are not taxable events \u2014 but the network fee you pay to execute the transfer might be. If you paid a fee in crypto (for example, ETH gas fees), that fee is technically a disposal of an asset and may trigger a small capital gain or loss. Koinly tracks these automatically. If you don\u2019t want transfer fees treated as disposals, you can toggle the \u201cTreat transfer fees as disposals\u201d setting off in your account preferences.<\/p>\n\n\n\n

What Should I Do About Spam Tokens?<\/h2>\n\n\n\n

Many blockchain wallets accumulate unsolicited \u201cspam\u201d or \u201cairdrop\u201d tokens that were never requested. Koinly<\/a> automatically excludes the majority of spam tokens and dust rewards from your transaction count. If a spam token has slipped through and is affecting your calculations, you can manually tag it as spam or delete the transaction entirely.<\/p>\n\n\n\n

Koinly Support Is Here to Help<\/h2>\n\n\n\n

If you\u2019ve tried the steps above and still can\u2019t resolve your issue, Koinly offers in-app live chat support with knowledgeable agents who can walk you through complex scenarios. The help center at support.koinly.io also contains hundreds of articles and step-by-step guides for virtually every situation.<\/p>\n\n\n\n

Ready to simplify your crypto taxes?<\/strong><\/p>\n\n\n\n

Try Koinly<\/a> for free today \u2014 no credit card required. Import your wallets, see your gains, and generate tax-ready reports in minutes.<\/p>\n\n\n\n

Frequently Asked Questions (FAQ)<\/h2>\n\n\n\n

Q: Why are my Koinly balances wrong?<\/strong><\/p>\n\n\n\n

A: Usually because you\u2019ve exceeded the free plan\u2019s 10,000 transaction limit (which pauses calculations) or because not all wallets and exchanges have been connected.<\/p>\n\n\n\n

Q: Why is Koinly pairing the wrong transfers?<\/strong><\/p>\n\n\n\n

A: Koinly\u2019s algorithms can mismatch transfers when similar amounts are moved between multiple wallets at similar times. Delete the incorrect matches and manually create the correct pairings.<\/p>\n\n\n\n

Q: How do I fix missing cost basis in Koinly?<\/strong><\/p>\n\n\n\n

A: Import the original exchange or wallet where you purchased the asset. If that\u2019s not possible, manually add a deposit transaction with the correct purchase price and date.<\/p>\n\n\n\n

Q: Can I use Koinly with an exchange it doesn\u2019t support?<\/strong><\/p>\n\n\n\n

A: Yes. Create a custom wallet in Koinly and upload your transaction history via a CSV file using Koinly\u2019s universal template format.<\/p>\n\n\n\n

Q: Why do transfers show a gain or loss?<\/strong><\/p>\n\n\n\n

A: Network fees paid in crypto during transfers may be treated as a taxable disposal. You can toggle this off in Koinly\u2019s settings under \u201cTreat transfer fees as disposals.\u201d<\/p>\n\n\n\n

Q: How do I remove spam tokens from Koinly?<\/strong><\/p>\n\n\n\n

A: Tag the unwanted transaction as spam or delete it manually. Koinly automatically excludes most spam tokens and dust rewards from your count.<\/p>\n\n\n\n

Q: How do I contact Koinly support?<\/strong><\/p>\n\n\n\n

A: Use the in-app live chat for real-time help, or browse the help center at support.koinly.io for detailed guides and troubleshooting articles.<\/p>\n\n\n\n

\u26a0\ufe0f DISCLAIMER<\/strong> The information provided in this article is for general informational and educational purposes only. It does not constitute financial, tax, legal, or investment advice, nor is it intended as a recommendation or suggestion to buy, sell, trade, or use any particular product, service, or platform.<\/em> <\/td><\/tr><\/tbody><\/table><\/figure>\n","protected":false},"excerpt":{"rendered":"Having issues with Koinly? Learn how to fix wrong wallet balances, incorrect transfer matching, missing cost basis, unsupported exchanges, and other common problems step by step.","protected":false},"author":1,"featured_media":1275,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"csco_display_header_overlay":false,"csco_singular_sidebar":"","csco_page_header_type":"","csco_page_load_nextpost":"","csco_page_reading_time":"","csco_page_toc_navigation":"","csco_post_video_location":[],"csco_post_video_location_hash":"","csco_post_video_url":"","csco_post_video_bg_start_time":0,"csco_post_video_bg_end_time":0,"csco_post_video_bg_volume":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[6],"tags":[121,115,116,117,119,120,118],"sections":[],"entities":[],"class_list":["post-1274","post","type-post","status-publish","format-standard","has-post-thumbnail","category-guides","tag-fix-koinly-errors","tag-koinly-missing-cost-basis","tag-koinly-problems","tag-koinly-transfer-matching","tag-koinly-troubleshooting","tag-koinly-unsupported-exchange","tag-koinly-wrong-balance","cs-entry","cs-video-wrap"],"jetpack_featured_media_url":"https:\/\/tokenmetrics.com\/blog\/wp-content\/uploads\/2026\/02\/Gemini_Generated_Image_1j6qbi1j6qbi1j6q.png","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/tokenmetrics.com\/blog\/wp-json\/wp\/v2\/posts\/1274","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tokenmetrics.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tokenmetrics.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tokenmetrics.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/tokenmetrics.com\/blog\/wp-json\/wp\/v2\/comments?post=1274"}],"version-history":[{"count":2,"href":"https:\/\/tokenmetrics.com\/blog\/wp-json\/wp\/v2\/posts\/1274\/revisions"}],"predecessor-version":[{"id":1277,"href":"https:\/\/tokenmetrics.com\/blog\/wp-json\/wp\/v2\/posts\/1274\/revisions\/1277"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/tokenmetrics.com\/blog\/wp-json\/wp\/v2\/media\/1275"}],"wp:attachment":[{"href":"https:\/\/tokenmetrics.com\/blog\/wp-json\/wp\/v2\/media?parent=1274"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tokenmetrics.com\/blog\/wp-json\/wp\/v2\/categories?post=1274"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tokenmetrics.com\/blog\/wp-json\/wp\/v2\/tags?post=1274"},{"taxonomy":"section","embeddable":true,"href":"https:\/\/tokenmetrics.com\/blog\/wp-json\/wp\/v2\/sections?post=1274"},{"taxonomy":"entity","embeddable":true,"href":"https:\/\/tokenmetrics.com\/blog\/wp-json\/wp\/v2\/entities?post=1274"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}