Anleitung zum Export der Transaktionshistorie bei der Börse CoinEx
Wenn Sie CoinEx nutzen und Ihre Historie exportieren müssen, damit Ihre Fachkraft bei colvence Ihre Krypto-Steuer berechnen kann, erklärt dieser Leitfaden, was Sie herunterladen müssen und wie.
Wir behandeln zwei Wege: das manuelle Herunterladen der CSV-Dateien und die Anbindung per API mit reinem Lesezugriff.
Wichtig: Für eine vollständige steuerliche Prüfung übergeben Sie idealerweise beides — die CSV-Dateien und den API-Schlüssel mit reinem Lesezugriff. Die CSV liefert die von CoinEx exportierte Historie, die API hilft beim Abgleich von Daten und Salden.
Warum Sie Ihre CoinEx-Historie brauchen
Um Veräußerungsgewinne und -verluste der Steuererklärung korrekt zu berechnen, müssen sämtliche Vorgänge rekonstruiert werden:
- das Datum jedes Kaufs, Verkaufs, Tauschs oder Umtauschs
- die erhaltene und die abgegebene Menge an Kryptowerten
- der Marktwert zum Zeitpunkt des Vorgangs
- die gezahlten Gebühren
- Ein- und Auszahlungen sowie Übertragungen zwischen Konten
CoinEx arbeitet als internationale Börse. Wenn Sie dort Kryptowerte halten, sollte das mit Blick auf Modelo 721 als ausländische Börse geprüft werden — vor allem, wenn der Gesamtwert auf ausländischen Börsen zum 31. Dezember 50.000 € übersteigt.
Erforderliche Dateien
Für einen vollständigen Export im Stil von Koinly müssen Sie diese Dateien aus CoinEx herunterladen:
| Datei | Pfad in CoinEx | Wann sie nötig ist |
|---|---|---|
| Deposit Records | Assets > Spot > Deposit Records | immer |
| Withdrawal Records | Assets > Spot > Withdrawal Records | immer |
| Spot history | Assets > History > Spot Trades | wenn Sie im Spot gekauft oder verkauft haben |
| Margin history | Assets > History > Margin | wenn Sie Margin-Handel genutzt haben |
| Futures history | Assets > History > Futures | wenn Sie Futures genutzt haben |
Wichtig: Der Zeitraum muss Ihre gesamte Historie bei CoinEx abdecken, nicht nur das zu erklärende Jahr. Fehlt ein früheres Jahr, kann die FIFO-Berechnung unvollständig bleiben.
CoinEx bietet unter Assets > History > Export Data außerdem einen allgemeinen Steuerexport an, der ein ZIP mit CSV-Dateien zu Spot, Margin, Futures und Finanzkonto erzeugt. Als Ergänzung kann das nützlich sein; für den steuerlichen Abgleich sollten Sie zusätzlich die einzelnen Dateien zu Einzahlungen, Auszahlungen und Handelsvorgängen herunterladen.
Weg 1: CSV-Export
Schritt 1: bei CoinEx anmelden
- Öffnen Sie den Browser und rufen Sie coinex.com auf
- Melden Sie sich mit Ihrem Konto an
- Bestätigen Sie die Sicherheitsprüfung, falls CoinEx sie verlangt
Schritt 2: Einzahlungen exportieren
- Wählen Sie oben rechts „Assets”
- Öffnen Sie im linken Seitenmenü unter Overview den Punkt Spot
- Wählen Sie „Deposit Records”
- Wählen Sie einen Zeitraum, der Ihre gesamte Historie bei CoinEx abdeckt
- Klicken Sie auf „Export” und speichern Sie die Datei
Schritt 3: Auszahlungen exportieren
Wiederholen Sie denselben Vorgang für die Auszahlungen:
- Gehen Sie auf Assets > Spot
- Öffnen Sie „Withdrawal Records”
- Wählen Sie denselben vollständigen Zeitraum
- Klicken Sie auf „Export”
- Speichern Sie die Datei, ohne sie zu öffnen oder zu verändern
Schritt 4: Spot-Historie exportieren
- Öffnen Sie oben rechts „Assets”
- Wählen Sie im Dropdown „History”
- CoinEx führt Sie zur Historie. Standardmäßig landen Sie meist im Bereich Spot Trades
- Wählen Sie einen Zeitraum, der Ihre gesamte Historie abdeckt
- Klicken Sie auf „Export”
- Speichern Sie die erzeugte CSV-Datei
Schritt 5: Margin und Futures exportieren, falls genutzt
Wenn Sie mit Margin oder Futures gehandelt haben, genügt die Spot-Historie nicht.
- Nutzen Sie unter Assets > History das linke Seitenmenü
- Wechseln Sie die Art der Historie zu Margin bzw. Margin History
- Wählen Sie den vollständigen Zeitraum und exportieren Sie die Datei
- Wiederholen Sie den Vorgang für Futures bzw. Futures History
Hinweis: Wenn Sie Margin oder Futures nie genutzt haben, brauchen Sie keine leeren Dateien zu erzeugen. Sind Sie unsicher, prüfen Sie beide Bereiche auf alte Bewegungen.
Schritt 6: allgemeiner Steuerexport von CoinEx
Zur zusätzlichen Kontrolle können Sie unter Assets > History > Export Data steuerliche Daten exportieren.
Auf diesem Bildschirm wählen Sie:
- Time Range: Ihre gesamte Historie
- Account Type: alle verfügbaren Konten
- Asset Type: sämtliche Werte
- Datei exportieren
Sobald CoinEx den Export fertiggestellt hat, erhalten Sie eine Nachricht per E-Mail und innerhalb der Plattform. Laden Sie das ZIP herunter und senden Sie es zusammen mit den übrigen CSV-Dateien, wenn Ihre Fachkraft darum bittet.
Wichtig: Öffnen oder verändern Sie die CSV-Dateien nicht, bevor Sie sie uns senden. Ein Öffnen in Excel kann Daten, Dezimalstellen oder Symbole verfälschen.
Wichtige Beschränkungen
| Beschränkung | Detail |
|---|---|
| Verfügbare Einträge | CoinEx bewahrt in der exportierbaren Historie bis zu den 50.000 jüngsten Einträgen auf |
| Exporte pro Monat | höchstens sechs Exporte je Kalendermonat |
| Gültigkeit des Links | Der Download-Link gilt sieben Tage |
| Erforderliche Dateien | Einzahlungen, Auszahlungen, Spot, Margin und Futures müssen getrennt heruntergeladen werden, sofern Sie diese Bereiche genutzt haben |
| Allgemeiner Steuerexport | Das offizielle ZIP von CoinEx trennt Spot, Margin, Futures und Finanzkonto |
| Konten ohne Aktivität | können leere CSV-Dateien erzeugen |
| CoinSet / LP | CoinSet- oder Liquiditätsvorgänge erfordern womöglich eine manuelle Rekonstruktion, wenn die Datei die Zahl der Anteile nicht ausweist |
Planen Sie die Exporte, bevor Sie sie anfordern — vor allem bei vielen Jahren Aktivität oder sehr vielen Vorgängen.
Weg 2: Anbindung per API
Ein API-Schlüssel mit reinem Lesezugriff erlaubt es, Konto- und Handelsdaten abzurufen, ohne Rechte zum Handeln oder zum Auszahlen von Guthaben zu erteilen.
Schritt 1: API Management öffnen
- Melden Sie sich unter coinex.com an
- Wählen Sie oben rechts „Account” oder das Symbol Ihres Kontos
- Öffnen Sie im Dropdown „API Management”
Schritt 2: einen neuen Schlüssel anlegen
- Klicken Sie auf „Create API”
- Vergeben Sie einen wiedererkennbaren Namen, etwa „colvence”
- Geben Sie Ihren TOTP-Code oder den von CoinEx verlangten Bestätigungscode ein
- Bestätigen Sie das Anlegen
Sicherheit: Aktivieren Sie keine Rechte für Handel oder Auszahlung. Für eine steuerliche Prüfung brauchen wir ausschließlich Lesezugriff.
Schritt 3: die Zugangsdaten kopieren
Sobald CoinEx den Schlüssel erzeugt hat, sichern Sie Folgendes:
- API Key bzw. Access ID
- API Secret bzw. Secret Key
Senden Sie diese Zugangsdaten über den sicheren Kanal, den man Ihnen nennt, an Ihre Fachkraft bei colvence.
Hinweis: Frisch angelegte API-Schlüssel brauchen mitunter einige Minuten, bis sie aktiv sind. Erscheint gleich nach dem Anlegen ein Fehler, warten Sie kurz und versuchen es erneut.
Grenzen der CoinEx-API
Die API liefert nicht immer die vollständige steuerliche Historie. Nach den Einschränkungen, die Koinly für CoinEx nennt, können manche Vorgänge nicht importiert werden, weil CoinEx sie über die API nicht bereitstellt:
- Instant Swaps
- Airdrops
- Provisionen aus Empfehlungen
Wenn Sie solche Bewegungen hatten, informieren Sie Ihre Fachkraft, damit sie mit den verfügbaren Unterlagen von Hand ergänzt werden.
Screenshots der Salden
Neben CSV und API können Screenshots der Salden nötig sein, wenn Ihre Mittel auf mehrere Konten oder Unterkonten verteilt sind:
- Spot-Konto
- Margin-Konto
- Futures-Konto
- Finanzkonto / Earn
- AMM oder andere Bereiche mit Guthaben
- Unterkonten, sofern Sie welche nutzen
Machen Sie Screenshots, auf denen Beträge, Währungen und Datum klar erkennbar sind. Das hilft bei der Prüfung von Vermögen, Schlusssalden und möglichen Pflichten aus Modelo 721.
Häufig gestellte Fragen
Lässt sich bei CoinEx die gesamte Historie exportieren?
CoinEx erlaubt Exporte aus mehreren Bereichen, sein allgemeiner Steuerexport nennt aber eine Grenze von 50.000 jüngsten Einträgen. Übersteigt Ihr Konto dieses Volumen, sagen Sie Ihrer Fachkraft Bescheid, damit Exporte nach Bereichen, Teilzeiträume oder der CoinEx-Support geprüft werden können.
Wie oft darf ich Daten exportieren?
CoinEx erlaubt bis zu sechs Exporte je Kalendermonat. Ist das Kontingent aufgebraucht, müssen Sie den Folgemonat abwarten.
Wie lange gilt der Download-Link?
Der Download-Link gilt sieben Tage. Laden Sie das ZIP herunter, sobald die Nachricht von CoinEx eintrifft.
Brauche ich CSV oder API?
Übergeben Sie nach Möglichkeit beides. Die CSV bewahrt den heruntergeladenen offiziellen Export, die API erlaubt einen automatischen Abgleich der Angaben.
Welche Dateien dürfen keinesfalls fehlen?
Laden Sie mindestens Deposit Records, Withdrawal Records und die Spot-Historie herunter. Wenn Sie Margin oder Futures genutzt haben, kommen Margin history und Futures history hinzu.
Kann ein Schlüssel mit reinem Lesezugriff Guthaben bewegen?
Nein. Ein im Nur-Lesen-Modus eingerichteter Schlüssel erlaubt es, Daten abzurufen, aber weder zu handeln noch Kryptowerte auszuzahlen.
Was ist mit Instant Swaps, Airdrops oder Empfehlungen?
Koinly weist darauf hin, dass die CoinEx-API weder Instant Swaps noch Airdrops oder Provisionen aus Empfehlungen liefert. Wenn Sie solche Bewegungen hatten, müssen sie mit Auszügen, Screenshots oder eigenen Aufzeichnungen von Hand ergänzt werden.
Was mache ich bei CoinSet- oder Liquiditätsvorgängen?
Weist die Datei die Zahl der Anteile nicht aus, lassen sich diese Vorgänge womöglich nicht korrekt importieren und müssen von Hand rekonstruiert werden. Senden Sie uns jeden weiteren Screenshot oder Auszug aus CoinEx, damit wir das prüfen können.
Ist CoinEx für Modelo 721 eine ausländische Börse?
In der Praxis ist CoinEx als ausländische Börse zu prüfen. Wenn Sie zum 31. Dezember auf ausländischen Börsen zusammen 50.000 € übersteigen, klären Sie, ob Sie Modelo 721 einreichen müssen.
Zusammenfassung
| Schritt | Aktion |
|---|---|
| 1 | coinex.com aufrufen und anmelden |
| 2 | Assets > Spot > Deposit Records öffnen und die gesamte Historie exportieren |
| 3 | Dasselbe unter Assets > Spot > Withdrawal Records wiederholen |
| 4 | Assets > History öffnen und die Spot-Historie exportieren |
| 5 | Bei genutztem Margin oder Futures auch Margin history und Futures history exportieren |
| 6 | Optional das Steuer-ZIP unter History > Export Data herunterladen |
| 7 | Einen Schlüssel mit reinem Lesezugriff unter Account > API Management anlegen, falls Ihre Fachkraft darum bittet |
| 8 | CSV-Dateien, API-Zugang und Screenshots der Salden senden, ohne die Dateien zu verändern |
Brauchen Sie Hilfe mit Ihrer CoinEx-Historie?
Bei colvence helfen wir Ihnen, an Ihre CoinEx-Historie zu kommen — Schritt für Schritt, wenn es hakt —, werten sie aus, berechnen sämtliche Gewinne und Verluste nach dem FIFO-Verfahren und bereiten Ihre Erklärung vor.
Kontaktieren Sie uns — wir übernehmen den Rest.
Víctor Lázaro
Steuerberatung, colvence.com
