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.
📌 Wie importiere ich meine CSV/Excel-Historie?
📌 Basiswissen für das Labeling und Merging von Transaktionen
📌 Derivative P&L Transaktionen aus dem Futures- oder Kontrakthandel manuell importieren?
📝 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:
Geliehener Betrag →
Receive LoanRückzahlung →
Repay LoanTrades →
Trade (spot)
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:
Positives realisiertes Ergebnis →
Derivative ProfitNegatives realisiertes Ergebnis →
Derivative LossFunding- und Trading-Kosten →
Derivative Fee
⚠️ 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:
Positives Ergebnis →
Derivative ProfitNegatives Ergebnis →
Derivative LossSeparat ausgewiesene Funding- oder Gebühreneinträge →
Derivative Fee
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ägefehlende 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),Receive Loan,Repay Loan,Derivative Profit,Derivative Loss,Derivative FeeFunding und Gebühren nicht doppelt erfasst
Nur realisierte Ergebnisse importiert
Keine unerklärten negativen Bestände im Portfolio