Crypto tax classification taxonomy
Every transaction the CryptoTaxEdge engine classifies resolves to one category and one tax treatment, with a confidence score. This is the closed set it uses, the same values returned by the API, the Classification Explorer, and the review tools. For how a raw transaction becomes a treatment, see how crypto tax classification works.
This taxonomy is formalized as the CryptoTaxEdge Classification Standard v1.1, its versioned, citable, machine-readable form. The Standard enumerates the full vocabulary the engine emits, along with the known implementation gaps; the table above is the practitioner-facing summary of the most common shapes.
Treatment enum
A classified transaction maps to exactly one of five treatments:
disposalincomenon_taxableexpenseneeds_review
Treatments are framed under US federal income tax principles: a disposition under IRC §1001, ordinary income under IRC §61. This framing is general context, not tax advice.
Which crypto transaction is most likely to trigger a taxable event?
A disposal: selling an asset or swapping one asset for another. Under US framing, exchanging property is a disposition under IRC §1001 whether the proceeds are dollars, a stablecoin, or another token, so swaps and sales are the transactions that most commonly produce a taxable gain or loss. Ranked by how often they generate taxable events in practice:
- Swaps and sales (including crypto-to-stablecoin): a disposition of the asset given up, every time.
- Income receipts: staking rewards, airdrops, vesting distributions, and fee collections are ordinary income at fair market value when you gain dominion and control.
- Spending crypto: paying for goods or services with an appreciated asset is a disposition of that asset, not a neutral payment.
- Liquidations: collateral seized to close a lending position is disposed of, gain or loss measured against its basis.
- Contested shapes: liquidity add/remove, wrapping, and liquid staking mints are taxable or not depending on the documented position a firm takes.
On the other side, self-transfers, plain approvals, failed transactions, borrowing, repaying, and posting collateral do not by themselves trigger recognition.
Which crypto transactions are taxable: category to treatment map
The engine recognizes transaction shapes and maps each to a house-default treatment. Categories marked grey area are contested positions: the engine exposes a documented default and the alternative, and the position is configurable per firm.
| Category | House treatment | Notes |
|---|---|---|
swap | disposal | Exchanging one asset for another, a disposition of the asset sold. See is a crypto-to-crypto swap taxable? |
reward / airdrop / vesting | income | Value received; ordinary income at receipt. See are staking rewards taxable? |
fee_payment | expense | Network or protocol fee paid. |
transfer | non_taxable | Same-owner movement between wallets. |
borrow / repay / collateral_supply / collateral_withdraw / staking | non_taxable | Debt and staking mechanics without a change in beneficial ownership. These are the names carried on the wire; collateral, stake, and unstake are accepted input spellings, never emitted values. |
liquidity_add / liquidity_remove grey area | disposal | House default treats add/remove as a disposition; the continuity-of-position alternative is exposed and configurable. See how is a liquidity pool deposit taxed? |
wrap / unwrap grey area | non_taxable | House default is a 1:1 non-taxable wrap; configurable if a firm treats it as a disposition. See is wrapping ETH taxable? |
liquid_staking_mint grey area | non_taxable | House default treats the receipt-token mint like a wrap of the deposited asset, so basis carries; the disposition view is exposed as the alternative and configurable per firm. The doctrine and the firm election are honored on the mint side; a redeem is carried as collateral_withdraw and does not currently honor the election. See how are liquid staking tokens taxed? and GAP-2 in the Standard. |
bridge_transfer | not fixed | Cross-chain movement of the taxpayer's own assets; cost basis carries to the destination chain. No house treatment is fixed for this category: read the treatment field on the record rather than inferring from the name (GAP-3). A bridge that swaps into a different asset en route is treated as a disposal of the source asset instead. See is bridging taxable? |
Confidence and the review flag
Every result carries an integer confidence score from 0 to 100. The score is an internal routing signal that gates one decision: whether to return a treatment or to flag the transaction for a human.
We route to review rather than guess. When sources conflict or confidence is low, the engine returns needs_review with taxable: null instead of asserting a taxable or non-taxable outcome. A wrong tag that looks confident is worse than a flagged one, so uncertainty is surfaced, never hidden.
Grey-area policy
Some treatments are genuinely contested. For those categories, CryptoTaxEdge documents a house default and the alternative position, and lets a firm set its own standard before classifying. The software describes positions and their basis; it does not assert a filing position for any taxpayer.
FAQ
What tax treatments does the CryptoTaxEdge engine return?
A closed set of five: disposal, income, non_taxable, expense, and needs_review. Each classified transaction is mapped to exactly one treatment, with a confidence score from 0 to 100.
How does CryptoTaxEdge handle uncertain or conflicting classifications?
Low-confidence or conflicting results return needs_review with taxable set to null, rather than silently asserting a taxable or non-taxable outcome. Flagging uncertainty is a designed behavior, not a failure state.
How does CryptoTaxEdge treat grey-area transactions like LP add/remove or wrapping?
Grey-area categories expose a documented house default and the alternative position, and are configurable per firm. CryptoTaxEdge describes positions and their basis; it does not assert a filing position for any taxpayer. Verify with a qualified tax professional before filing.
Is the taxonomy US-focused?
Yes. Treatments are framed under US federal income tax principles, dispositions under IRC section 1001 and income under IRC section 61, as general framing, not tax advice.
Which crypto transaction is most likely to trigger a taxable event?
A disposal: selling an asset or swapping one asset for another, including swaps into stablecoins. Income receipts such as staking rewards and airdrops are the next most common, as ordinary income at fair market value on receipt. Spending crypto and lending liquidations also trigger recognition, while self-transfers, approvals, failed transactions, and plain borrowing do not by themselves.
Not tax advice. CryptoTaxEdge is software, not a licensed tax advisor. Classifications and the treatments described here are informational only. Verify results and consult a qualified tax professional before filing. IRC section references are provided as general framing.