Home/How to Use Koinly
Trusted Crypto Tax Software — 850+ Integrations

How to Use KoinlyComplete Setup Guide

From first login to downloaded tax report — the complete Koinly setup walkthrough including exchange connections, error fixes, and report generation.

Free portfolio tracking · No credit card required · Paid plans from $49/year

Koinly Plans

$49/year
Newbie$49 · 100 txns
Hodler$99 · 1,000 txns
Trader$179 · 3,000 txns
Oracle$279 · 10,000 txns
FreePortfolio tracking only
Priced per tax year · All plans include same features
What is Koinly

How to Use Koinly

Using Koinly effectively takes 30-90 minutes for initial setup depending on how many exchanges and wallets you have. The process is: create account → connect each data source → import transactions → review and fix flagged items → purchase plan → generate report. This guide walks through each step in detail with practical tips to minimise manual work.

Koinly At a Glance
TypeCrypto Tax Software
Integrations850+ exchanges & wallets
Countries100+ (20+ localized)
Tax MethodsFIFO · LIFO · HIFO · ACB
Starting Price$49/tax year
Free TierYes — portfolio tracking
US Tax FormsForm 8949 · Schedule D
DeFi / NFTSupported
Staking / MiningAuto-categorized
CPA AccessRead-only sharing
Features

Everything You Need to File Crypto Taxes

From import to IRS-ready reports — Koinly handles the complexity of crypto tax automatically.

🔑
API Connection
Most exchanges connect via read-only API keys — Koinly never needs trading permissions.
📁
CSV Import
For exchanges without API support, download your transaction history CSV and upload to Koinly.
🔍
Auto-Categorization
Koinly automatically labels most transactions. Review orange-flagged ones for manual input.
🔄
Transfer Matching
Koinly identifies transfers between your own wallets and excludes them from tax calculations.
⚠️
Error Resolution
Missing price data, unmatched transfers, and unknown protocols appear in the Review section.
📥
Report Download
Once reviewed and paid, download your report as PDF and/or TurboTax-compatible file.
Pricing

Simple Per-Year Pricing

Koinly charges per tax year, not monthly. All plans include the same features — only transaction limits differ.

Newbie
$49/yr
Up to 100 transactions
All tax reports
All integrations
DeFi & NFT
CPA access
Hodler
$99/yr
Up to 1,000 transactions
All tax reports
All integrations
DeFi & NFT
CPA access
Oracle
$279/yr
Up to 10,000 transactions
All tax reports
All integrations
Priority support
CPA access
How it Works

How to Use How to Use Koinly

Connect your exchanges and wallets, let Koinly calculate everything, then download your tax reports.

1

Create Account

Go to koinly.io and sign up with email or Google. No credit card needed.

2

Add Each Exchange

Go to Wallets → Add Wallet. Search for your exchange. Follow the instructions to create a read-only API key on your exchange and paste into Koinly.

3

Add Blockchain Wallets

For MetaMask, Phantom, hardware wallets — paste your public wallet address. Koinly reads all transaction history from the blockchain automatically.

4

Let Koinly Sync

After connecting each source, Koinly imports all historical transactions. This can take a few minutes for large accounts.

5

Review Flagged Transactions

Go to Review (orange banner) and work through unrecognised transactions. Most are unusual DeFi interactions or ambiguous transfers that need manual labelling.

6

Purchase Plan and Download

Click Generate Report, select the tax year, choose your plan, pay, and download your IRS Form 8949, HMRC report, or country-specific document.

Stop Dreading Crypto Tax Season

Import your transactions, let Koinly calculate your gains and losses, and download your tax reports in minutes.

Try Koinly Free →

Free portfolio tracking · No credit card to start · Plans from $49/tax year

FAQ

Koinly Questions Answered

How long does Koinly setup take?
+
Initial setup takes 30-90 minutes for most users. Connecting exchanges via API is quick (5-10 minutes each). Reviewing flagged transactions takes the most time — typically 1-3 hours for heavy DeFi users, less for simple buy-and-hold portfolios.
Is it safe to give Koinly my API keys?
+
Yes — with an important caveat. Always create READ-ONLY API keys with no withdrawal or trading permissions. Koinly only needs to read your transaction history. Never give any software API keys with withdrawal access.
What if Koinly shows the wrong tax amount?
+
Wrong amounts are usually caused by incomplete data (missing transactions or wallets). Add all your wallets and exchanges, ensure all historical data is imported, and review flagged items. Inaccurate input data will always produce inaccurate output.
Can I import transactions manually if my exchange isn\'t supported?
+
Yes. Koinly supports CSV import for all transactions and has a manual transaction entry interface. For exchanges not in Koinly\'s directory, download your transaction history from the exchange and upload the CSV file.
How do I share Koinly with my accountant?
+
In Koinly Settings, find the CPA Access section and enter your accountant\'s email. They receive an invitation to view your account with read-only access — they see all transactions, reports, and calculations but cannot modify anything.
Reviews

What Users Say About Koinly

Setup Guide Follower
★★★★★

"Followed this guide for my first Koinly setup. 4 exchanges and 2 MetaMask wallets connected in about 45 minutes. Had about 30 flagged transactions to review manually. Total setup to report download: 2.5 hours. Well worth it."

CPA Referral
★★★★★

"Sent this guide to three clients who were new to Koinly. All three completed setup without calling me for help. The step-by-step breakdown of API key creation was the most useful part for them."

DeFi User
★★★★☆

"The flagged transaction review step is where reality diverges from expectation. Had 180 flagged items from DeFi — took most of a Saturday to work through. Worth doing right rather than rushing."

Ready to File Your Crypto Taxes?

850+ integrations, 100+ countries, IRS Form 8949, HMRC reports, DeFi, NFTs, staking — Koinly handles it all.

Get Started Free →

No credit card required to start