2.4

🪙 Set Up Binance

Connect crypto account via API — Spot & Wallet in live sync

1. 🪙 Why Connect Binance?

Binance is the largest crypto exchange in the world and for many DACH-region traders the first port of call for spot trading and HODLing. sTraderZ.com connects to Binance via the official read-only API — meaning we only read trades, wallet balances, and order history. It is technically impossible for us to execute trades, withdraw funds, or transfer coins, because trade and withdrawal permissions are never requested.

⚠️ Tax notes upfront: Crypto gains in DE/AT/CH fall under private disposal transactions or speculation tax with their own rules (e.g. 1-year holding period in DE, BMF decree 2025 in AT). sTraderZ.com helps with tracking — the tax assessment itself must be reviewed by you or a tax advisor. More in the crypto tax deep dive: Crypto taxation (in German).

Binance is not a BaFin/FMA/FINMA-regulated exchange — it operates primarily through subsidiaries in Lithuania (BaFin license application pending) and Poland. For beginners: Crypto is not the right place for your first 100 EUR of your trading career. But if you have made a conscious decision to trade crypto and already have an account, the API connection is done in 5–10 minutes.

2. Prerequisites

  • Existing Binance account with completed KYC verification ("Verified" or higher). Without verification, the API feature is locked.
  • Two-factor authentication (2FA) — either Google Authenticator, Yubikey, or Binance/Authy. Required for API creation.
  • Static IP address or VPS (recommended) — if you want to use IP whitelisting (highly recommended, see Step 3).
  • 10 minutes — setup is quick, but should be done carefully.

Step-by-Step Guide

1

Creating an API Key on Binance

1. Log in to Binance → click your profile icon in the top right → API Management.

2. Create a new API key → click "Create API" → select type "System generated" (not Self-Generated, which is for advanced use cases).

3. Set a label: e.g. "sTraderZ Read-Only".

4. 2FA confirmation: Confirm via Google Authenticator + email code.

5. API Key + Secret are displayed — you will only see the Secret ONCE. Store it securely (password manager).
2

Setting Permissions Correctly

IMPORTANT — Only enable this one permission:

✅ "Enable Reading" (Read-Only Permission)

Leave all other permissions disabled:

❌ Enable Spot & Margin Trading
❌ Enable Withdrawals
❌ Enable Internal Transfers
❌ Enable Universal Transfer
❌ Permit Universal Transfer

This ensures: even if the API key falls into the wrong hands, nobody can place trades or withdraw coins — only read the history.
4

Connecting to sTraderZ.com

1
🏦 Create account
Accounts → + New Account → Select broker: "Binance" → Save.
2
🔑 Enter API credentials
Account overview → click Binance account → Tab Configuration → paste API Key and Secret from your password manager → Save.
3
🔄 Start sync
Click "Sync now". The initial sync loads the last 12 months — depending on trade volume this takes 30 sec to 2 min.
✓
⏰ Automatic sync active
From now on, sync runs regularly in the background. New trades, wallet movements, and conversions are captured automatically.

7. What Gets Synced?

Data type Status Notes
Spot trades✅Full — Buy/Sell, all pairs (BTC/USDT, ETH/EUR, …)
Wallet balance✅Spot wallet live balances converted to EUR
Conversions✅Convert API (e.g. BTC → USDT directly) is recorded as a trade
Earn / Staking rewards✅Flexible & Locked Earn are flagged as taxable income
Deposits / Withdrawals✅Deposits and withdrawals tracked in cash flow
Futures / Margin⚠️Beta — requires separate permission, can be enabled in account setup
P2P trades❌API does not provide P2P — can be imported manually via CSV
NFTs❌Not (yet) supported

8. CSV-Import (Altbestände & P2P)

Der API-Sync ist inkrementell und greift nur auf aktuell gehaltene Symbols zu. Zwei Lücken schließt der CSV-Import:

  • Altbestände — Käufe, die vor der API-Verknüpfung liegen, oder Coins, die du inzwischen komplett verkauft hast.
  • P2P-Trades — die Binance-API liefert P2P-Geschäfte grundsätzlich nicht.
  • Earn-/Staking-Historie — vollständige Erträge zum Nachimport.

Du findest den Import auf der Binance-Konto-Konfigurationsseite unter „📥 Altbestände importieren (CSV)" — er ist auch ohne aktive API-Verbindung nutzbar.

So exportierst du deine Daten aus dem Binance Download Center

Nutze das Download Center (binance.com → Profil → Download Center, direkt: /my/download-center). Anders als die „Export"-Schaltfläche in der normalen Ansicht (max. 3 Monate) sind hier Zeiträume über mehrere Jahre möglich. Wähle den Oberpunkt, im „Data Type"-Dropdown den Typ und den Zeitraum → „Generate" → kurz warten → „Download". Die heruntergeladene ZIP-Datei kannst du direkt hochladen — sie wird automatisch entpackt.

Export-Typ Pfad im Download Center
Spot-TradesOberpunkt „Trade History" → „Spot" → Variante „Trade History" (nicht „Order History" — anderes Format!) → Zeitraum → Generate → Download (ZIP: Binance-Spot-Trade-History-…)
Transaktionen
Ein-/Auszahlungen, Earn, Staking
Oberpunkt „Asset History" → Data Type „Transaction History" → Zeitraum → Generate → Download (ZIP: Binance-Transaction-History-…)
P2P-Trades
optional, nur falls vorhanden
Das Download Center führt P2P nicht separat. Falls du P2P-Käufe getätigt hast: Buy Crypto → P2P → Orders → „Export Order History" → Download

Was wird aus den CSVs importiert?

Vorgang Import Ziel / Hinweis
Spot Buy/Sell✅Als Krypto-Trade — Pair wird in Coin + Währung zerlegt
P2P (COMPLETED)✅Nur abgeschlossene Orders — offene/stornierte werden übersprungen
Ein-/Auszahlungen Euro & Stablecoins✅Deposit / Withdrawal im Cash-Flow
Ein-/Auszahlungen von Coins✅Als Depotübertrag — der Bestand stimmt, der Kaufpreis ist Binance aber unbekannt. Du trägst ihn in der Kontoansicht unter „Depotüberträge" nach.
Binance Convert, Kartenkauf, Staub-Umtausch✅Als Tausch — mit Euro oder Stablecoin auf einer Seite als Kauf/Verkauf zu diesem Preis, sonst geht der Kaufpreis auf den erhaltenen Coin über
ETH 2.0 Staking, BETH→WBETH, Umbenennungen (z. B. RNDR→RENDER, LUNA→LUNC)✅Bestand und Kaufpreis wandern auf den neuen Coin
Earn / Savings / Staking / Airdrops✅Coins als Bestandszugang, Euro/Stablecoins als Zins-Ertrag. Im Steuerreport zählen Staking und Earn zum Tageskurs als sonstige Einkünfte, Airdrops ohne Gegenleistung mit Kaufpreis 0 — die Einstufung kannst du je Vorgang ändern (siehe unten).
Earn Subscription / Redemption, Staking Purchase / Redemption❌Interne Umbuchung — bewusst ignoriert, der Coin bleibt in deinem Bestand
Futures / Margin❌Nicht in der Spot-CSV enthalten — eigenes Format
Unbekannte Vorgänge⚠️Werden nicht importiert, aber nach dem Upload mit Namen und Anzahl angezeigt
💶 Bewertung in Euro: Käufe gegen USDT, USDC oder andere Coins rechnet sTraderZ.com zum Kurs des Handelstags in Euro um (EZB-Referenzkurs bzw. Binance-Tagesschlusskurs). Deine Coins werden stündlich mit dem aktuellen Binance-Kurs bewertet. Für Coins, die Binance nicht mehr handelt, gibt es keinen Kurs — sie stehen dann mit ihren Anschaffungskosten im Depot.
🛡️ Duplikat-Schutz: Du kannst denselben Export mehrfach hochladen — bereits importierte Spot-/P2P-Trades und Transaktionen werden automatisch erkannt und nicht doppelt angelegt. Ein erneuter Upload ersetzt außerdem veraltete Buchungen früherer Importe im selben Zeitraum. API-Sync und CSV-Import dürfen sich überschneiden: Ein Trade, den der CSV-Export enthält (gleicher Coin, gleiche Richtung, gleiche Sekunde oder gleiche Order-Nummer), wird aus der API nicht noch einmal übernommen; beim Upload ersetzt der CSV bereits per API geholte Trades.

Bestandsabgleich mit Binance

Mit verbundener API holt sTraderZ.com einmal täglich und bei jeder Synchronisation deinen Bestand direkt von Binance — Spot, Simple Earn und Funding zusammen. Auf der Binance-Seite deines Kontos siehst du dann je Coin laut Import, laut Binance und die Differenz mit der wahrscheinlichen Ursache: ein fehlender Export-Zeitraum, eine Einzahlung ohne Export, eine nicht erfasste Auszahlungsgebühr. Kleinstbeträge unter 1 € werden als solche markiert. Weicht ein Coin ab, erscheint in der Kontoansicht ein Hinweis. Korrigiert wird nichts automatisch — du ergänzt den fehlenden Export und lädst ihn hoch.

Der erste Abruf am 1. Januar ist dein Bestand zum 31.12. Er steht im Steuerreport im Kapitel „Kryptowerte" — das Finanzamt kann ihn anfordern.

Zuflüsse steuerlich einstufen

Staking, Earn und Zinsen sind Entgelt für eine Leistung: sonstige Einkünfte, bewertet zum Tageskurs, bis 256 € im Jahr steuerfrei. Airdrops und Distributions ohne Gegenleistung sind keine Einkünfte; die Coins stehen mit Kaufpreis 0 im Bestand. Musstest du für einen Airdrop etwas tun — eine Aufgabe erledigen, Werbung teilen, Daten angeben —, ist er eine Leistung. Auf der Binance-Seite stellst du das je Vorgangsart oder für einzelne Vorgänge um; der nächste Steuerreport rechnet mit deiner Einstufung und nennt die Zahl der geänderten Vorgänge.

⚠️ 3-Monats-Limit: Binance erlaubt pro CSV-Export maximal 3 Monate. Für längere Zeiträume erzeugst du mehrere Exporte und lädst sie gleichzeitig hoch (bis zu 20 Dateien je Import). Die Duplikat-Erkennung deckt überlappende Zeiträume ab.
✨

Security Best Practices

Three rules that protect you from 99% of crypto API disasters:

1. Never enable "Enable Withdrawals". Even if a service asks for it — say no. Withdrawals require a separate whitelist on the Binance side anyway, but if the key is compromised and you have enabled withdrawals, it's game over.

2. Treat the API Secret like a password — use a password manager (Bitwarden, 1Password, KeePass), never store it in plain text anywhere, never share it via email/Slack/Telegram.

3. Rotate every 90 days. Binance keys don't technically expire, but rotate them as a matter of discipline. Delete the old key, create a new one, update it in sTraderZ.com — takes 3 minutes.

⚠️ Sync Not Working — What Now?

Error: "Invalid API-key, IP, or permissions for action"
Most common cause: you have IP whitelisting enabled but have not added our IP. Fix: Go to Binance → API Management → IP whitelist → add our IP (see account configuration).

Error: "Signature for this request is not valid"
API Secret entered incorrectly. A trailing space is often copied along when copy-pasting. Solution: copy the secret again from your password manager, paste it, save.

Error: "Account has insufficient permissions"
You created the API key without "Enable Reading" — easy to miss when other permissions are being disabled. Solution: In Binance → edit key → enable "Enable Reading".

Initial sync running very long (> 5 minutes):
For large accounts with > 10,000 trades, the initial synchronization genuinely takes longer. Just let it run — after that, incremental sync (every 10 min) is very fast.

11. Crypto Alternatives Compared

Binance is the biggest, but not the right choice for everyone. A brief comparison of the three most relevant DACH-region crypto brokers:

Provider Location / Regulation API Sync DE Tax Report Strength
Binance Global / LT, PL ✅ ⚠️ Manual Largest selection, lowest fees, conversions
Bitpanda AT / FMA ✅ ✅ DE/AT Report Locally regulated, beginner-friendly, tax report included
Bitcoin Suisse CH / SBA ⚠️ CSV ✅ CH Report Premium, custody, OTC for CH residents
Kraken US / FinCEN, BaFin ✅ Roadmap ⚠️ Manual High liquidity, US-compatible, margin/futures
ℹ️ My pitch for Bitpanda — if you live in DE/AT, are new to crypto, and want hassle-free tax reporting, Bitpanda is almost always the better choice over Binance. Binance makes more sense once you have higher trading volumes and need the lowest fees. Running both simultaneously is perfectly legitimate.

12. From Sync to Your First Crypto Trade

Account connected? Congratulations — sync is now running in the background.