BTC Steuertool Web – Die Anleitung

Vom CSV-Export zum Finanzamt-Report — in 5 Minuten, komplett in deinem Browser

„Deine Transaktionsdaten verlassen nie deinen Rechner. Kein Upload, kein Account, kein Tracking — die komplette Berechnung läuft lokal in deinem Browser."

Das Video zeigt den Stand Juni 2026. Heute ist das Tool komplett kostenlos, ohne Zugangslink, und es gibt es zusätzlich als App für Android und Linux. Die Bilder auf dieser Seite zeigen den aktuellen Stand.

Schritt 0: Was du brauchst

Nur deine CSV-Exporte. Jeder Broker und die BitBox-App bieten einen Export an — einmal pro Jahr herunterladen reicht:

Käufe ohne CSV (Robosats, Bargeld, P2P) oder bei Brokern ohne eigenen Parser trägst du in eine einfache manual_buys.csv ein — Details weiter unten.

Schritt 1: Dateien laden

Öffne api.alien-investor.org/steuertool/. Ziehe alle CSV-Dateien gleichzeitig in die gestrichelte Zone — oder klicke sie an und wähle die Dateien aus. Die Reihenfolge ist egal, Dateinamen sind egal: Die App erkennt jeden Broker automatisch am Inhalt der Datei.

Die Startansicht: CSV-Dateien einfach in die gestrichelte Zone ziehen.

Schritt 2: Erkennung prüfen — und noKYC-Wallets markieren

Nach dem Laden zeigt die Tabelle jede Datei mit dem erkannten Typ. Orange markierte Einträge sind noKYC-Quellen — sie bleiben strikt vom Finanzamt-Report getrennt:

Alle Dateien erkannt — Bisq und manuelle Käufe automatisch als noKYC (orange). Die noKYC-Wallet der Beispieldaten ist über ihren Ordner schon markiert, bei eigenen Dateien stellst du sie selbst um.

Wird eine Datei nicht erkannt, ist die Berechnung gesperrt, bis du den Typ manuell wählst oder die Datei auf „Ignorieren" stellst — so entsteht nie ein unvollständiger Report. Fehlt dein Broker komplett? Schick die CSV-Kopfzeile (ohne echte Daten) an kontakt@alien-investor.org — Parser werden laufend ergänzt. In der Web-Version sind neue Broker sofort da, ohne Installation, in den Apps mit dem nächsten Update.

Schritt 3: Report berechnen

Ein Klick auf „Report berechnen". Beim allerersten Lauf lädt die App ihre Python-Umgebung in den Browser — das dauert einmalig ein paar Sekunden, danach geht es schnell. Das System-Log zeigt jeden Schritt:

Das System-Log: jede Datei, jede Transaktion, volle Transparenz.

Schritt 4: Die Ergebnisse verstehen

Pro Steuerjahr bekommst du mehrere Dokumente, umschaltbar über die Tabs:

Jahres-Tabs oben, Dokument-Tabs darunter — hier der Steuerreport 2024.

Schritt 5: noKYC intern — nur für dich

Bisq-Käufe, manuelle P2P-Käufe und noKYC-Wallets landen in einem separaten internen Dokument mit eigenem FiFo-Pool. Es beginnt mit einem unübersehbaren Warnhinweis:

Der rote Banner sagt alles: Diese Datei ist nur für deine eigene Buchführung.

Wichtig: Die Trennung dient deiner Privatsphäre und sauberen internen Buchführung — auch Gewinne aus noKYC-Verkäufen sind steuerpflichtig und gehören in die Steuererklärung. Das Dokument zeigt dir dafür FiFo-Zuordnung, Haltefristen und Gewinne.

Schritt 6: Herunterladen und einreichen

Über die Download-Buttons holst du dir jedes Dokument einzeln oder alle auf einmal. Beim Finanzamt reichst du zwei Dinge ein:

• den Steuernachweis (steuernachweis_JAHR.txt) und
• die Original-CSVs deiner Broker als Beleg, dass die Käufe echt sind.

Der Nachweis zeigt unter „Quelle" genau, welcher Broker welches Lot geliefert hat — jeder Verkauf ist lückenlos rückverfolgbar.

Häufige Fragen

Was ist mit Käufen in CHF oder USD (Swissquote, Pocket)?

Die App rechnet sie automatisch mit dem EZB-Referenzkurs des Kauftags in EUR um. Die Kurstabelle (seit 2010) liegt gebündelt in der App — es wird kein Kursdienst angefragt, auch nicht für Datum oder Währung. Liegt ein Kauf nach dem Datenstand der Tabelle, bricht die App mit einer Erklärung ab statt einen alten Kurs zu nehmen.

Was passiert mit Überträgen zwischen meinen Wallets — und deren Gebühren?

Der übertragene Bestand bleibt steuerneutral und behält sein Kaufdatum. Seit Version 1.2 (Oktober 2026) rechnet die App FiFo je Wallet (BMF-Schreiben vom 06.03.2025, Rn. 62): Die abgebende Wallet gibt ihre ältesten Einheiten ab, Kaufdatum und Einstand wandern mit in die empfangende Wallet. Überträge erkennt die App an der Transaktions-ID, sonst an Betrag und Zeitpunkt; ein Abgang ohne passenden Eingang wird gemeldet, nie still als Verkauf gebucht — lade deshalb die Exporte aller Wallets. Die Netzwerk- oder Auszahlungsgebühr in Bitcoin dagegen bucht die App seit August 2026 als kleine Veräußerung des Gebührenanteils (BMF-Schreiben vom 06.03.2025, Rn. 54, 60): FiFo-Zuordnung, Bewertung zum Tagesschlusskurs, eigener Abschnitt „GEBÜHREN IN BITCOIN" im Report. Meist sind das Cent-Beträge — aber so stimmt der ausgewiesene Bestand mit deiner Wallet überein. Die Kurstabelle liegt im Tool, dein Browser fragt dafür nichts im Netz an.

Ich habe Bitcoin verschenkt oder gespendet — wie erfasse ich das?

Trag in der BitBox-App vor dem Export ein Wort wie „Spende", „Geschenk" oder „Schenkung" in die Notiz der Transaktion ein. Die App stuft die Zeile dann als unentgeltliche Übertragung ein: kein Verkauf, kein Gewinn — aber die Coins verlassen deinen Bestand, und der Report listet je Lot Kaufdatum und Einstand, weil beides beim Empfänger weitergilt (§ 23 Abs. 1 Satz 3 EStG). Jede so eingestufte Zeile steht sichtbar unter „UNENTGELTLICHE ÜBERTRAGUNGEN" und das System-Log nennt die Anzahl — kurz gegenprüfen.

Mein Broker fehlt — was nun?

Übergangslösung: Käufe in manual_buys.csv eintragen (date,btc_amount,eur_amount,note,kyc — bei KYC-Brokern wie Coinbase die Spalte kyc auf ja setzen). Und parallel die CSV-Kopfzeile an kontakt@alien-investor.org schicken — neue Parser sind meist in wenigen Tagen drin.

Kann ich das Tool erst mit Beispieldaten ausprobieren?

Ja. In der Dropzone kannst du die Beispieldaten als ZIP herunterladen und selbst per Drag & Drop reinziehen — genau wie mit deinen echten Dateien. Oder du nimmst den 1-Klick-Button „Mit Beispieldaten testen". Die Beispieldaten sind fiktiv und decken alle unterstützten Broker ab.

Was kostet die Web-Version?

Nichts. Seit dem 2. Oktober 2026 gibt es keinen Bezahlzugang mehr — die Web-Version ist wie das CLI frei. Der eine Unterschied: die Web-Version lädt ihren Code bei jedem Aufruf vom Server. Wer maximale Kontrolle will, nimmt das CLI aus dem Repo, das nach dem Klonen vollständig offline läuft.