Zum Hauptinhalt springen

Wie importiere ich Trading-Bot-Daten manuell in Blockpit?

Dieser Artikel erklärt, wie du Exchange-native Trading-Bot-Daten (von Pionex, BingX und anderen) in Blockpit importierst – also Bot-Produkte, die direkt von einer Exchange angeboten und dort ausgeführt werden (z. B. Grid Bots, DCA Bots, Futures Bots etc.).

Nicht behandelt werden externe Drittanbieter-Bots, die per API mit einer Exchange verbunden sind. In diesen Fällen sind die Trades häufig bereits im normalen API- oder CSV-Import enthalten.

​

Exchange-native Trading-Bots können im Interface ähnlich aussehen, erzeugen im Hintergrund jedoch unterschiedliche Datentypen. Manche Bots generieren normale Spot-Käufe und -Verkäufe, andere arbeiten mit geliehenem Kapital (Spot Margin), wieder andere handeln Futures/Perpetuals/Optionen und erzeugen realisierte Gewinne/Verluste sowie Funding- und Gebühren-Einträge.

🏆 Dieser Leitfaden zeigt dir, wie du den Bot-Typ identifizierst und die Daten korrekt in Blockpit importierst – auch dann, wenn im Exchange-Interface nur ein finales Ergebnis sichtbar ist.

​

​

🔍 Schritt 1: Bot-Struktur verstehen

Bevor du mit dem Import beginnst, solltest du klären, welche Art von Bot verwendet wurde.

​

Entscheidend ist:

  • Was handelt der Bot im Hintergrund?

  • Welche Daten stellt die Exchange zur Verfügung (API, CSV/Excel-Export oder nur UI-Ergebnisse)?

  • Handelt es sich um Spot, Margin oder Derivate?

Sobald du diese Struktur kennst, wird der Import deutlich einfacher.

​

📈 Spot-Trading-Bots

Spot-Bots (z. B. Grid Bots, DCA-Strategien, Rebalancing Bots) führen reguläre Kauf- und Verkaufsorders am Spot-Markt aus. Aus steuerlicher Sicht entstehen normale Spot-Transaktionen.

​

Verwendetes Blockpit-Label:

Wenn dein Export eine vollständige Trade-Historie via API oder CSV enthält, kannst du diese wie jede andere Exchange-Aktivität importieren. Eine separate PnL-Berechnung ist nicht notwendig, da Spot-Besteuerung auf einzelnen Kauf- und Verkaufsereignissen basiert.

💡 Wenn der Export wie normale Buy-/Sell-Transaktionen inklusive Gebühren aussieht, handelt es sich sehr wahrscheinlich um Spot Market Handel.

​

💳 Spot-Margin-Bots

Spot-Margin-Bots kombinieren Spot-Trades mit geliehenem Kapital. Die Aktivität besteht typischerweise aus:

  • Spot-Käufen und -Verkäufen

  • Borrow-Events

  • Repay-Events

  • ggf. Zinsen

In Blockpit muss diese Struktur korrekt abgebildet werden.

​

Verwendete Blockpit-Labels:

Margin-Trading erfordert keine Derivate-PnL-Labels. Fehlende Loan- oder Repay-Einträge sind jedoch eine der häufigsten Ursachen für abweichende Balance (Assetmenge).

⚠️ Wenn nach dem Import negative Bestände erscheinen, prüfe zuerst, ob alle Borrow- und Repay-Transaktionen enthalten sind.

​

​

📊 Futures-, Perpetual- oder Options-Bots

Derivate-Bots handeln Kontrakte statt Spot-Assets. Typische UI-Elemente sind:

  • Realized PnL

  • Funding Fees

  • Positionsgröße

  • Liquidationspreis

Die steuerliche Bewertung basiert hier auf dem realisierten Gewinn oder Verlust.

​

Verwendete Blockpit-Labels:

Alleinige Spot-Trade-Einträge reichen hier nicht aus.

💡 Wenn die Exchange Funding-Zahlungen oder positionsbasierte PnL-Daten anzeigt statt einzelner Buy-/Sell-Transaktionen, handelt es sich um Derivate.

​

​

🔗 Schritt 2: Import per API oder CSV (empfohlen)

Wann immer möglich, solltest du API oder offizielle CSV-Exporte verwenden.

  • Spot-Bots → Trade-Historie

  • Margin-Bots → Trade-Historie + Margin-Ledger (Borrow/Repay)

  • Derivate-Bots → Realisierte PnL-Daten + Funding-/Gebühren-Historie

Manche Exchanges teilen die Daten auf mehrere Exporte auf oder stellen sie über einen Sub-Account-API-Key bereit, zum Beispiel:

  • Trade-Historie

  • Income-Historie

  • Funding-Historie

  • Margin-Ledger

Stelle sicher, dass alle relevanten Dateien berücksichtigt werden.

​

Wenn die Daten bereits alle zugrunde liegenden Transaktionen enthalten, kannst du sie direkt hochladen oder in die Blockpit Excel Vorlage migrieren.

​

​

​

📝 Schritt 3: Manueller Import mit der Blockpit Excel-Vorlage

Falls kein geeigneter Export verfügbar ist, kannst du die offizielle Blockpit Excel-Vorlage verwenden und deine Daten manuell übertragen.

​

Spot-Bots (manuell)

Jede Kauf- und Verkaufsorder einzeln erfassen als:

Gebühren entsprechend berücksichtigen.

​

Spot-Margin-Bots (manuell)

Folgende Einträge sind erforderlich:

Gebühren entsprechend berücksichtigen. Fehlende Loan-Einträge führen in der Regel zu abweichender Balance (Assetmenge).

​

Derivate-Bots (manuell)

Für Derivate-Aktivitäten erfassen:

⚠️ Wichtig: Exchanges berechnen PnL unterschiedlich. Realisierte PnL-Werte können bereits enthalten:

  • Teilgewinnmitnahmen

  • Positionsaufstockungen

  • Mehrere Teil-Schließungen

  • Funding Fees

  • Trading Fees

Prüfe immer, ob Funding und Gebühren bereits im PnL-Wert berücksichtigt sind, um doppelte Erfassung zu vermeiden.

​

​

🖥️ Sonderfall: Nur finales Bot-Ergebnis im Interface sichtbar

Manche Exchanges stellen keine detaillierte Transaktionshistorie bereit, sondern zeigen lediglich ein finales Strategie-Ergebnis (z. B. „Total Profit“ oder „Net PnL“) im Dashboard an.

​

Wenn keine detaillierte Historie verfügbar ist, kannst du das Ergebnis abstrahiert in Blockpit erfassen.

​

Verwendete Blockpit-Labels:

In diesem Fall ist es in der Regel sinnvoll, das Ergebnis dem Steuerjahr zuzuordnen, in dem der Bot geschlossen und der Gewinn oder Verlust realisiert wurde.

💡 Wenn detaillierte Transaktionsdaten verfügbar sind, sollte diese Variante immer bevorzugt werden.

​

​

🔧 Wenn die Asset Balance nicht übereinstimmt

Abweichungen der Balance (Assetmenge) entstehen häufig durch unvollständige Exporte, zum Beispiel:

  • fehlende Receive Loan / Repay Loan-Einträge

  • fehlende Funding Fees

  • begrenzte Exportzeiträume

  • nicht berücksichtigte Bot-Subaccounts

  • fehlende historische Anfangsbestände

Blockpit bietet eine Auto-Balancing-Funktion, die Ausgleichstransaktionen generieren kann, wenn historische Daten fehlen. Diese Transaktionen sollten sorgfältig geprüft und gegebenenfalls angepasst werden (z. B. Relabeling als nicht steuerpflichtige Einzahlung bei fehlendem Startbestand).

​

In vielen Fällen führt das manuelle Ergänzen fehlender Historien (Loans, Funding, Transfers) zum genauesten und revisionssichersten Ergebnis.

​

​

✅ Checkliste vor Abschluss

  • Bot-Typ korrekt identifiziert (Spot, Margin oder Derivate)

  • Richtige Labels verwendet: Trade (spot), Kreditaufnahme, Kreditrückzahlung, Derivate-Gewinn, Derivate-Verlust, Derivate-Gebühr

  • Funding und Gebühren nicht doppelt erfasst

  • Nur realisierte Ergebnisse importiert

  • Keine unerklärten negativen Bestände im Portfolio

Hat dies deine Frage beantwortet?