How to Import Ether.fi Transactions to Koinly: Complete Tax Tracking Guide

Why Accurate Ether.fi Tax Tracking Matters

If you’re holding or using ether.fi assets—whether through the Cash card’s cashback or protocol features—every transaction has tax implications. Capital gains, income from rewards, spend history for deductions: they all compound. The IRS (and tax authorities worldwide) increasingly target crypto users who can’t produce clean records. Koinly is the gold-standard bridge between your ether.fi account and tax-ready reports.

Why it matters: Manual spreadsheets are error-prone, regulators don’t accept them, and audits are expensive. Automated import means zero missed transactions, consistent cost-basis calculations, and reports that satisfy any tax authority.

Prerequisites: What You Need Before Starting

Before importing, gather the essentials:

• Ether.fi account with transaction history (at least one transaction required for import to work).
• Koinly account—free tier covers ≤200 transactions annually; paid plans (USD $99–399/year) handle unlimited transactions and advanced reports.
• Ether.fi API access—available to all users, no additional approval needed. Your API key is generated in the Ether.fi app settings.
• 30 seconds of setup time to authorize Koinly to read your ether.fi data (no withdrawal/spend permissions granted).

Signal: If you have multiple ether.fi wallets or sub-accounts, create separate Koinly portfolios for each to avoid co-mingling tax lots. This prevents cost-basis errors that can trigger audit flags.

Step-by-Step: How to Import Ether.fi Transactions to Koinly

Step 1: Create or Log Into Your Koinly Account

Visit Koinly.io and sign up (or log in if already registered). Koinly is browser-only; no app required. Your first portfolio is free to create. If tracking multiple ether.fi accounts, set up one portfolio per account.

Step 2: Generate Your Ether.fi API Key

Log into your ether.fi account and navigate to Settings → API Keys. Click Generate New Key and select the Read-Only permission level (this prevents accidental withdrawal). Copy the full API key—Koinly will ask for it next.

Key metric: Never share your API key outside of Koinly. Copy it directly from ether.fi settings into Koinly’s import wizard—do not paste into email, chat, or any other service.

Step 3: Add Ether.fi as a Connected Exchange in Koinly

In Koinly, go to Portfolio → Connected Exchanges. Search for “Ether.fi” and click Connect. Paste your API key into the field and click Authorize. Koinly will immediately test the connection by pulling your latest transaction.

Signal: If you see “Authorization failed,” verify that:

• You copied the entire API key (it’s very long).
• The key is still active in ether.fi settings (expired keys must be regenerated).
• Your ether.fi account has at least one transaction on record.

Step 4: Wait for Koinly to Sync

Koinly pulls up to 1 year of transaction history on the first import. Depending on your transaction count, sync takes 5–30 seconds. You’ll see a green checkmark when complete. All future transactions auto-sync daily at 08:00 UTC.

Step 5: Review and Categorize Transactions

Once synced, navigate to your Transactions tab. Koinly auto-categorizes most entries as “Exchange Trade,” “Income,” or “Fee.” Review each transaction and correct the category if needed:

• Cash card spend → categorize as “Spending” (eligible for cost-basis deduction in some jurisdictions).
• Staking rewards → categorize as “Income” (ordinary income for US tax purposes).
• Borrow/lend activity → categorize per your jurisdiction’s rules (usually “Exchange Trade” or “Loan”).
• Network fees → categorize as “Fee” (often deductible).

Why it matters: Correct categorization is the difference between a tax bill and a refund. A single miscategorized transaction can trigger an IRS inquiry.

How to Use Borrow Mode Ether.fi—Tax Implications

Get your DefyCard →

If you’re using ether.fi’s borrow mode (borrowing stablecoins against your ETH collateral), Koinly handles these transactions—but they require careful categorization.

How borrow mode appears in Koinly:

• Borrow transaction → recorded as a “Loan” (Koinly category), not a sale. Your ETH collateral stays in your wallet and continues to appreciate; you owe a debt in stablecoins.
• Interest payments → recorded as “Fee” or “Expense” (usually tax-deductible as investment expenses).
• Repayment → recorded as a “Loan Repayment,” which doesn’t trigger capital gains.

Risk: Do not categorize a borrow as “Exchange Trade” or “Sell.” If you do, Koinly calculates a capital gain on your ETH (even though you didn’t sell), and you’ll overstate your tax liability. Always verify the category before exporting your tax report.

When you leverage how to use borrow mode ether.fi as part of your strategy, accurate tax tracking becomes even more critical. Koinly’s loan-tracking feature ensures your collateral ETH isn’t double-counted as both held and sold.

How to Switch to Direct Pay Mode Ether.fi—Spend Tracking

Some ether.fi users activate direct pay mode for on-chain payments or merchant transfers. When you switch to direct pay mode ether.fi, any spend transactions appear in Koinly as either “Spending” (if you’re converting assets) or “Transfer” (if you’re moving to another wallet without selling).

Koinly behavior for direct pay:

• Outgoing payment in an asset (e.g., paying in ETH)→triggers capital gains calculation. Koinly records the cost basis of the ETH you spent and calculates the gain/loss at the time of payment.
• Outgoing payment in stablecoin → may not trigger gains if the stablecoin is pegged to fiat (e.g., USDC, USDT). Check your jurisdiction’s rules; some treat stablecoins as cash, others as property.
• Incoming payments → recorded as “Received” or “Income,” depending on the source.

Watch: If you spend ether.fi assets for real-world goods (coffee, rent, travel), that spend event is a taxable event in most countries. Koinly’s cost-basis tracking ensures you’re reporting the correct gain/loss.

Verifying Your Imported Data and Troubleshooting

After import, always verify that Koinly captured all your transactions. Check:

• Transaction count → compare Koinly’s total against ether.fi’s account activity page.
• Date range → verify Koinly is showing transactions from your earliest activity onward.
• Balance accuracy → Koinly shows your final balance; ensure it matches your ether.fi wallet balance.

Common issues and fixes:

• “0 transactions imported” → Regenerate API key in ether.fi; some keys expire. Re-authorize in Koinly.
• Missing recent transactions → Koinly syncs at 08:00 UTC daily. If you just transacted, wait until next sync. Manually refresh in portfolio settings.
• Duplicate transactions → Rare, but can happen if you import the same API key twice. Delete the duplicate in transaction editor.
• Borrow transactions showing as trades → Re-categorize as “Loan” in the transaction detail view.
• Wrong cost basis → Verify price data in Koinly’s price editor; sometimes feeds lag or diverge from purchase price.

Signal: Koinly allows you to manually override any transaction category or cost basis. If you know a specific transaction’s correct value (e.g., you bought ETH at a negotiated OTC price), edit it so your report reflects reality, not a third-party price feed’s estimate.

Linking Ether.fi Cash Card Spend to Your Tax Report

If you’re spending with the ether.fi Cash card (earning up to 3% cashback), those transactions also need tracking. When you spend ether.fi assets via the card (direct pay mode), Koinly captures the outgoing transaction and calculates gains. Cashback rewards themselves appear as income in your Koinly report.

Why this matters: Cashback is taxable income at the time of receipt. If you earned $50 in cashback over the year, you owe income tax on $50, even if the cashback sits in your wallet. Koinly auto-marks cashback as “Income,” so you won’t forget it.

For accurate tracking of your full ether.fi ecosystem—staking, borrowing, spending, and cashback—[sign up for the ether.fi Cash card via DefyCard](https://www.ether.fi/@defycard). Every card transaction flows into your Koinly import, giving you a complete tax picture.

Generating Your Final Tax Report

Once all transactions are imported and categorized, generate your tax report:

1. Go to Portfolio → Tax Reports.
2. Select your reporting period (calendar year or custom range).
3. Choose your report format: PDF (for record-keeping), CSV (for accountant review), or TurboTax/IRS Form 8949 (for direct filing).
4. Review the summary—total income, capital gains, losses, and fees claimed as deductions.
5. Export and save a copy. Keep it on file for 7 years (IRS record-retention rule).

Key metric: Koinly’s capital gains calculation defaults to “FIFO” (first-in, first-out) cost basis. If your jurisdiction allows HIFO or weighted-average, switch the method in portfolio settings before exporting. This can significantly change your tax liability.

Risk & Disclosure

This article is educational and not tax, legal, or financial advice. Koinly’s categorization is a starting point; consult a tax professional to ensure accuracy for your situation. DefyCard publishes affiliate-linked reviews; we may earn commission when you sign up for ether.fi or Koinly through our links. Ether.fi Cash card services are available in 76 countries for physical card shipment and are not available in 20 prohibited nations (including China, Russia, North Korea, Turkey, and others) and 21 US states. Verify your country and state eligibility before signing up. Crypto asset values are volatile; tax liability changes as prices fluctuate. Review your Koinly reports monthly, not just annually, to monitor your running tax position.