TaxMyCrypto
A local, self-hosted crypto tax engine built around one question: can I trust the numbers before they land on Form 8949? It ingests exchange CSVs and on-chain history, reconciles prices and balances across independent sources, computes capital gains under FIFO / LIFO / HIFO, detects wash sales under IRC §1091, flags scam tokens, and exports IRS Form 8949, Schedule D, and an accountant-friendly summary as real PDFs. It runs on your laptop against a SQLite database, so wallet history never leaves the machine.
- Role
- Solo Engineer
- Period
- 2026
- Status
- Production
How the system fits together.
The calls that shaped it.
- 01
Prices reconciled, not trusted
Queries CoinGecko, CoinMarketCap, and CryptoCompare in parallel, takes the median, and only marks a price verified when two sources agree within 2% — falling through a six-channel chain (CoinPaprika → Birdeye → DexScreener → on-chain → implied), each source stored as its own auditable row.
- 02
Balances checked two ways
One ledger is recomputed from the raw transaction stream, a second summed from tax-lot remainders, reconciled per wallet+asset to 1e-8 — any drift surfaces as a data-integrity issue, so cost basis can never quietly disagree with what moved on-chain.
- 03
Cost basis you can defend
A decimal.js FIFO/LIFO/HIFO lot matcher plus full IRC §1091 wash-sale detection, a 13-check cross-validation gauntlet, and Form 8949 / Schedule D filled against the real 2025 IRS PDF templates via pdf-lib.
- 04
Internal transfers stay off the ledger
Three-pass transfer matching — same-chain tx_hash, cross-chain bridge (wrapped↔native within 1% / 2h), and hashless Coinbase-CSV ↔ on-chain — preserves the original cost basis instead of opening a phantom disposal.
- 05
On-chain scam defense
An algorithmic scorer weighs ten signals; an investigator then goes on-chain — Blockscout deployer profiling (serial-scammer detection), Solana RPC mint/freeze authority, Token-2022 honeypot extensions — and flagged tokens are dropped before the 8949 is computed.
The interesting work isn't the stack. It's the boundaries.