A connected wallet can import thousands of blockchain records into CoinLedger, but an imported record is not automatically a filing-ready explanation of what happened. One bridge can arrive as an unrelated withdrawal and deposit; liquid staking can resemble a trade; a liquidity position can contain several assets, an LP token, fees and rewards. This guide provides a repeatable DeFi reconciliation workflow: reconstruct the economic event first, verify CoinLedger’s classification second, and review the tax treatment with evidence before generating reports.
Last reviewed: October 22, 2026. CoinLedger features, supported protocols, tax settings and terminology can change. DeFi tax treatment depends on jurisdiction and facts, and authorities have not issued specific guidance for every protocol design. This independent guide is educational, not tax, accounting, legal or investment advice. Use current official documentation and consult a qualified professional before filing.
1. What DeFi reconciliation means
Reconciliation is the process of proving that CoinLedger’s transaction list represents the activity recorded across wallets, exchanges and blockchains. It answers three different questions:
- Completeness: did every relevant transaction enter the account?
- Classification: did deposits, withdrawals and contract calls become the correct economic event?
- Tax treatment: do the selected settings reflect the user’s jurisdiction and documented position?
Those questions must be handled in order. Changing tax treatment cannot repair a missing wallet, and editing a label cannot repair a duplicated import.
2. Blockchain data is not a tax conclusion
A block explorer can prove that tokens moved, which contract received them, the fee paid and the transaction time. It usually cannot prove why the user acted, who controlled the destination, or which legal treatment applies. CoinLedger translates raw records into recognizable transaction types, but incomplete data can make a bridge look like a disposal or an internal transfer look like income.
Keep three layers separate:
| Layer | Evidence | Question |
|---|---|---|
| On-chain fact | Hash, addresses, token contracts, amounts, timestamp and fee | What moved? |
| Economic event | Protocol interface, wallet ownership and related transaction legs | What did the user do? |
| Tax treatment | Local law, settings and professional advice | How should it be reported? |
3. Build a complete source inventory
List every centralized exchange, self-custody address, hardware wallet account, chain, Layer 2 network and protocol used during the year. Include abandoned wallets and services used only once. A missing source breaks the chain between an outgoing transaction and the asset that arrived elsewhere.
For each source, record
- platform, wallet label and blockchain;
- public address or exchange account;
- first and last date used;
- import method and date range;
- whether the source remains accessible;
- where the original CSV or statement is stored.
Never enter a seed phrase or private key to import tax records. CoinLedger wallet imports use public addresses for supported chains; exchange integrations should use only the access documented by the provider.
4. Choose one import path per source
Duplicating the same activity through a wallet address, CSV and API can create extra transactions and false gains. Decide which source is authoritative, document its coverage, then compare totals before adding another import.
A second import can be appropriate when the first lacks history, but its date range should fill a defined gap rather than overlap blindly. After every import, compare transaction counts, earliest date, latest date and balances before continuing.
5. Reconcile in dependency order
Do not start by editing the largest gain. Work in an order that preserves relationships:
- confirm sources and date coverage;
- remove true duplicates;
- match transfers between owned addresses;
- match bridges and cross-chain movements;
- review trades and multi-asset swaps;
- review staking and liquidity positions;
- classify rewards and income;
- repair prices and missing basis;
- review fees;
- run reports and compare ending inventory.
This sequence prevents an early manual edit from hiding the real source of a warning.
6. Use the Potential Bridges, Trades and Transfers tab
CoinLedger can flag withdrawal and deposit pairs that were not mapped automatically. Its Potential Bridges, Trades and Transfers area suggests the most likely relationship. Treat the suggestion as a review queue, not automatic proof.
Compare the two sides using:
- timestamp and expected bridge duration;
- source and destination chains;
- token contract and economic asset;
- sent and received quantity;
- protocol and network fees;
- ownership of both addresses;
- transaction hashes and bridge explorer records.
7. Bridge, transfer or trade?
These events may all contain one outgoing and one incoming record, but they describe different activity.
| Type | Economic pattern | Evidence to verify |
|---|---|---|
| Self-transfer | Same asset moves between addresses controlled by the user | Ownership of both addresses and matching amount |
| Bridge | Value moves between networks through bridge contracts | Source transaction, destination mint/release and bridge record |
| Trade | One asset is exchanged for a different asset | Swap route, assets, quantities and fair values |
| Multi-asset swap | Several inputs or outputs form one economic exchange | All legs from the same protocol interaction |
A similar ticker does not prove the same asset. Conversely, a token can change contract or representation across a bridge while preserving an economic relationship. Document the exact path.
8. Reconstruct a bridge step by step
Start with the source-chain withdrawal and open its hash. Identify the bridge contract, token and net amount. Then locate the destination-chain receipt. Import both addresses before manually creating missing entries.
If CoinLedger recognizes the pair, confirm the suggested bridge. If it does not, follow the current official bridge-import workflow and include fees. Avoid creating a standalone deposit without its source, because that can generate missing basis or apparent income.
9. Wrapped and unwrapped assets
Wrapping can exchange a native asset for a contract representation such as ETH for WETH. Other wrappers represent Bitcoin, staking claims or bridged assets. The transaction mechanics and chosen tax treatment should not be guessed from the word “wrapped.”
Verify whether ownership and economic exposure continued, whether a different token was received, and whether the protocol introduced a new claim. CoinLedger and its educational materials discuss alternative approaches for some wrapped or bridged transactions because specific authority may be limited. Record the method chosen and apply it consistently.
10. Native staking
CoinLedger documents Native Stake and Native Unstake transaction types for assets locked directly with a validator or native staking mechanism. The principal should be separated from rewards. Moving principal into staking is not the same event as receiving newly earned tokens.
Review:
- the amount delegated or locked;
- the validator or staking program;
- the unstaked principal;
- reward receipts and claim dates;
- fees and slashing, if any.
11. Liquid staking
Liquid staking usually provides another token representing the position. CoinLedger explains that this may import as a Trade or Add Liquidity, with the exit appearing as a Trade or Remove Liquidity. That differs from native staking because a transferable placeholder token is received.
Reconcile the original asset, received liquid-staking token, conversion ratio, rewards mechanism and redemption. Some tokens increase in quantity; others keep the same quantity while their redemption value changes. Treating both models identically can distort income or basis.
12. Staking rewards
Separate reward income from principal movement. Verify when rewards became controlled by the wallet, their quantity, fair market value and source. Do not classify a returned stake as a reward simply because it arrives as an inbound record.
If rewards accrue inside a token’s exchange rate rather than arriving as separate tokens, the data pattern differs. Preserve protocol documentation and ask a tax professional when recognition timing is uncertain.
13. Add Liquidity
A liquidity deposit may send two or more assets to a pool and receive an LP token or NFT representing the position. Review the entire contract interaction, not each transfer in isolation.
Liquidity entry checklist
- Identify every deposited asset and quantity.
- Locate the received LP token or position NFT.
- Confirm pool, network and protocol.
- Record gas and protocol fees.
- Review the Add Liquidity classification.
- Document the tax setting used for the year.
14. Remove Liquidity
At exit, the user may burn an LP token and receive a different mix of assets from the original deposit. That difference is not automatically a missing transfer: fees, trading activity and impermanent loss can change the pool share.
Match the burned position to the returned assets, then verify price data and remaining LP balance. A partial withdrawal should not close the entire position.
15. LP rewards and liquidity mining
Protocol incentives can arrive separately from the value accumulated inside a pool. Identify reward token, claim event, amount, market value and subsequent disposal. Do not merge reward income into the liquidity deposit merely because the same protocol distributed it.
Governance tokens may have low liquidity or missing price history. Use supportable market evidence rather than inventing a zero value for a token that traded elsewhere.
16. Lending, borrowing and collateral
A DeFi loan can involve a collateral deposit, receipt token, borrowed asset, interest, repayments and collateral return. Imported lines must be reconstructed as one lifecycle.
| Stage | Record to locate | Risk if misclassified |
|---|---|---|
| Deposit collateral | Asset out and any receipt token | False disposal or unmatched withdrawal |
| Borrow | Borrowed asset received | False income |
| Interest accrual/payment | Debt change or payment | Missing expense or incorrect asset quantity |
| Repayment | Principal and interest sent | False disposal calculation |
| Collateral return | Original asset received | Missing basis |
| Liquidation | Collateral sold or transferred | Unreported disposition |
Tax treatment for receipt tokens and protocol mechanics can be uncertain. Escalate material lending positions to a professional with the complete transaction evidence.
17. Forced liquidations
A liquidation is not simply a transfer to another owned wallet. Identify collateral removed, debt repaid, penalty, returned remainder and timestamp. Price volatility can make the amounts unintuitive, so compare protocol records with the block explorer.
Do not delete a liquidation because it produces a large gain or loss. Resolve the event and attach evidence before relying on the report.
18. Airdrops, governance rewards and spam
Not every unsolicited token is legitimate income. Spam tokens can appear automatically and may contain malicious links. Do not interact with a token merely to discover its value or remove it.
For a legitimate reward, document when the user obtained control, amount, price and program. For spam, preserve the hash and use the platform’s supported exclusion or ignore workflow rather than fabricating a sale.
19. Gas and protocol fees
Fees should be connected to the activity that generated them. A swap fee, bridge fee, staking claim fee and simple wallet-transfer fee may not share the same treatment. Verify which asset paid the fee and whether CoinLedger already incorporated it into proceeds, basis or the transaction record.
Adding a fee manually without checking the import can count it twice. Likewise, deleting a small gas-only line may break the audit trail between the wallet and the classified event.
20. Missing prices and unknown tokens
A missing market price can create zero proceeds, zero income or exaggerated gains. Confirm the token contract, chain, decimal precision and ticker before entering a value. Different assets can share the same symbol.
Use a reproducible price source appropriate to the date and market. Save a screenshot or export, calculation and time-zone assumption. If no reliable market existed, document that fact and obtain professional guidance instead of choosing a convenient value.
21. Missing cost basis
A missing-basis warning often points upstream. Search for an earlier purchase, reward, bridge, transfer or unsupported-chain history. Import the missing source before adding manual basis.
When manual correction is necessary, retain the original statement, transaction hash, acquisition date, quantity, currency and calculation. A manually entered number without provenance is difficult to defend later.
22. Tax Settings and non-taxable treatment
CoinLedger allows certain transactions—including trades, multi-asset swaps, bridges and add/remove liquidity—to be marked non-taxable in supported workflows. It also offers broader tax settings that can affect a year or account.
A software toggle does not establish the law. Before changing it:
- identify the exact protocol mechanics;
- document asset continuity and ownership;
- review the applicable jurisdiction and tax year;
- obtain professional advice for material or uncertain positions;
- save the rationale and before/after reports;
- apply the position consistently.
23. Individual override versus global setting
An individual override changes one event. A global setting can change many historical calculations. Prefer the narrowest change supported by the facts. Before changing a global setting, export the current report and record which years will be affected.
Afterward, compare gains, income, ending holdings and warnings. A large unexplained change is a signal to investigate, not proof that the new result is better.
24. End-of-year inventory check
Compare CoinLedger’s ending quantities with wallet and exchange balances at year-end. Explain differences using transactions after the snapshot, locked positions, unsupported assets or incomplete imports.
Reconcile material assets by quantity, not only total dollar value. Two offsetting errors can leave the portfolio value looking reasonable while individual basis records remain wrong.
25. Evidence pack for a tax professional
A reviewer needs more than a final PDF. Create a folder containing:
- source inventory and ownership labels;
- original CSV files and API coverage notes;
- wallet addresses and relevant hashes;
- bridge and protocol receipts;
- manual price evidence;
- list of edited or excluded transactions;
- tax settings by year and rationale;
- unresolved warnings and questions;
- draft reports before and after material changes.
This pack lets a CPA evaluate assumptions without reconstructing the entire account from memory.
26. Troubleshooting matrix
| Symptom | Likely cause | First action |
|---|---|---|
| Bridge shows a sale and income | Two sides were not paired | Import both chains and review potential bridge matches |
| Owned-wallet deposit has no basis | Source wallet is missing | Import source history and match as transfer |
| Staked principal appears as reward | Principal and earnings were combined | Separate stake/unstake from reward receipts |
| LP withdrawal shows unexplained assets | Position entry or LP token is missing | Reconstruct Add and Remove Liquidity together |
| Token value is enormous | Wrong contract or decimals | Verify chain, contract and precision |
| Transactions appear twice | Overlapping API, CSV or wallet import | Compare source and date coverage before deleting |
| Report changes after settings update | Global treatment affected prior events | Compare saved reports and review affected years |
| Unknown token appears | Spam or unsupported asset | Do not interact; verify contract and use safe exclusion workflow |
27. Final pre-filing workflow
- Import every relevant exchange, address and blockchain.
- Confirm coverage dates and remove only verified duplicates.
- Resolve owned-wallet transfers before missing basis.
- Review all potential bridge, trade and transfer pairs.
- Separate native staking, liquid staking and rewards.
- Match Add Liquidity with LP token or NFT positions.
- Match Remove Liquidity and partial exits correctly.
- Review lending, repayments and liquidations as lifecycles.
- Validate token contracts, prices and decimal precision.
- Review gas and protocol fees for duplication.
- Document every manual edit and non-taxable choice.
- Compare ending holdings by asset and location.
- Export evidence and reports before filing.
- Have uncertain material positions reviewed professionally.
Frequently asked questions
Does CoinLedger automatically classify every DeFi transaction?
CoinLedger supports many blockchains and protocols and automates substantial classification, but incomplete third-party data or complex contract interactions can require review. Confirm every material sequence.
Why does my bridge appear as two transactions?
The source withdrawal and destination receipt may have imported separately. Import both chains and review the Potential Bridges, Trades and Transfers area before creating manual records.
Are bridges always non-taxable?
No universal answer applies to every jurisdiction or structure. CoinLedger provides configurable treatment and educational explanations, but the factual and legal conclusion belongs to the taxpayer and adviser.
Does CoinLedger support staking?
Yes. Its official documentation describes native staking, liquid staking and staking rewards. How the transactions appear depends on the staking mechanism and imported data.
Why does liquid staking appear as a trade?
Liquid staking can exchange an original asset for a separate placeholder token. CoinLedger may import this as a Trade or Add Liquidity, unlike native staking where principal is locked without receiving the same kind of transferable token.
Can I mark a transaction non-taxable?
CoinLedger supports non-taxable treatment for certain transaction types. Use it only after confirming the facts, applicable rules and year; the toggle itself is not tax authority.
Should I delete spam tokens?
Do not interact with suspicious tokens. Verify their contracts and use the platform’s safe exclusion or ignore workflow while preserving the original on-chain record.
What should I do with missing cost basis?
Search upstream for the purchase, reward, transfer or bridge that delivered the asset. Import missing history first. Use manual basis only with evidence when the original record cannot be imported.
Final takeaway
Reliable DeFi reporting is built from transaction relationships, not isolated labels. A bridge needs both chains, liquid staking needs principal and representative token, and a liquidity position needs its entry, position asset, rewards and exit. When those relationships are complete, CoinLedger’s reports become easier to review and explain.
Use automation to locate patterns and warnings, but retain evidence for every material correction. Consistent classification, year-specific settings and a documented professional decision are more valuable than forcing every warning to disappear.
Official CoinLedger resources
- CoinLedger Blog — official tax education, product explanations and regulatory updates.
- CoinLedger DeFi Tax Guide — official overview of swaps, staking, liquidity, lending, wrapping and bridges.
- CoinLedger DeFi Tax Software — supported DeFi activity and import workflow.
- Supported blockchains, dApps and DeFi protocols — current integration coverage.
- Potential Bridges, Trades and Transfers — reviewing suggested transaction pairs.
- Importing bridge transactions — official manual bridge workflow and fee entry.
- CoinLedger staking support — native staking, liquid staking and reward classification.
- Marking transactions as non-taxable — supported overrides and tax settings.
Related One Crypto Library guides: CoinLedger Cost Basis Review, CoinLedger Pre-Filing Data Cleanup, CoinLedger Tax-Loss Harvesting Review and CoinLedger Account Security.