magicbeans

Cryptocurrency tax tracking and reporting tools for the Beancount platform.

An example generated report: data/magicbeans_example.pdf

Overview

Goals:

Accurate importing of crypto transactions from exchanges or wallet software
Accurate and traceable capital gains/loss tracking and computation
Handle mining/staking/farming income
Handle taxable asset exchanges (e.g., USDT for BTC)
Tax optimization options beyond HIFO/FIFO
Flexibility between automatic and manual lot selection
Scale to hundreds or thousands of transactions and cost-basis lots
Generation of reports suitable for preparing (US) taxes

Magicbeans is not standalone software, it consists of modules, extensions, and tools that operate on the Beancount platform. For more information see: https://github.com/beancount .

No warranty is expressed or implied; in fact I can almost guarantee you that Magicbeans behaves incorrectly in many situations.

Status

Magicbeans currently can:

Import crypto activity data from a few sources (Coinbase csvs, CoinbasePro csvs, Gate.IO csvs, and the Chia default wallet) into Beancount format (and transaction semantics)
Run standard Beancount functionality, including balancing transactions, flagging discrepencies, cost-basis lot tracking, computing capital gains
Generate PDF reports containing high-level summaries of capital gains (similar to IRS 8949) and income, as well as very detailed reports tracking individual lots from acquisition through inventory through disposition, to enable auditing

However, Magicbeans is underexercised and undertested. It is badly in need of more beta-testers/developers who are willing to try to use it with their data, debug where it breaks, and contribute fixes.

TODO

Enable collaborators & alpha testers

Write some introductory documentation
Document requirements (pip packages, and beancount plugins)
Write some more detailed documentation with tips, tricks, gotchas, examples, and war stories of real-life data

Necessary and missing functionality

Verify that price and acquisition date tracking transfers is working (background)
Write tax-minimizing booking algo Ref: minimizegains and match_trades
Figure out plan for saving booking decisions and applying in the future

Cleanup

Existing price fetcher isn't ideal, see if we can get higher-resolution historical data, and corroborate across multiple sources
Set up continuous integration w/ typechecking and unit tests
Use @dataclass where appropriate
Make a clear decision on the use of terms "Buy", "Sell", and "Swap"
Create a canonical way to automatically apply registered fix-ups on imported data
Address TODOs throughout code
Get zerosum plugin working, report these and other errors somewhere in the build pipeline
Use filter_txns() throughout rather than filter() with isinstance()

ericaltendorf / magicbeans