2.4

🪙 Configurer Binance

Connecter le compte crypto via API — Spot & Wallet en sync en direct

1. 🪙 Pourquoi Connecter Binance ?

Binance est la plus grande bourse crypto au monde et pour de nombreux traders de la région DACH le premier port d'escale pour le trading spot et le HODLing. sTraderZ.com se connecte à Binance via l'API officielle en lecture seule — ce qui signifie que nous lisons uniquement les trades, les soldes de portefeuille et l'historique des ordres. Il nous est techniquement impossible d'exécuter des trades, de retirer des fonds ou de transférer des coins, car les permissions de trading et de retrait ne sont jamais demandées.

⚠️ Notes fiscales d'emblée : Les gains crypto en DE/AT/CH relèvent des transactions de cession privées ou de la taxe spéculative avec leurs propres règles (p. ex. période de détention d'1 an en DE, décret BMF 2025 en AT). sTraderZ.com aide pour le suivi — l'évaluation fiscale elle-même doit être vérifiée par vous ou un conseiller fiscal. Plus d'informations dans le guide fiscal crypto : Fiscalité des cryptomonnaies (en allemand).

Binance n'est pas une bourse régulée par la BaFin/FMA/FINMA — elle opère principalement via des filiales en Lituanie (demande de licence BaFin en attente) et en Pologne. Pour les débutants : La crypto n'est pas le bon endroit pour vos premiers 100 EUR de votre carrière de trader. Mais si vous avez pris la décision consciente de trader des cryptos et que vous avez déjà un compte, la connexion API se fait en 5–10 minutes.

2. Prérequis

  • Compte Binance existant avec vérification KYC complétée (« Verified » ou supérieur). Sans vérification, la fonctionnalité API est verrouillée.
  • Authentification à deux facteurs (2FA) — soit Google Authenticator, Yubikey, ou Binance/Authy. Requis pour la création de l'API.
  • Adresse IP statique ou VPS (recommandé) — si vous souhaitez utiliser la liste blanche IP (fortement recommandé, voir Étape 3).
  • 10 minutes — la configuration est rapide, mais doit être effectuée avec soin.

Guide pas à pas

1

Créer une Clé API sur Binance

1. Connectez-vous à Binance → cliquez sur votre icône de profil en haut à droite → API Management.

2. Créez une nouvelle clé API → cliquez sur « Create API » → sélectionnez le type « System generated » (pas Self-Generated, qui est pour les cas d'utilisation avancés).

3. Définissez un libellé : p. ex. « sTraderZ Read-Only ».

4. Confirmation 2FA : Confirmez via Google Authenticator + code email.

5. Clé API + Secret sont affichés — vous ne verrez le Secret qu'UNE SEULE FOIS. Conservez-le en sécurité (gestionnaire de mots de passe).
2

Configurer les Autorisations Correctement

IMPORTANT — N'activez que cette seule permission :

✅ « Enable Reading » (Permission de lecture seule)

Laissez toutes les autres permissions désactivées :

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

Cela garantit : même si la clé API tombe entre de mauvaises mains, personne ne peut placer des trades ou retirer des coins — seulement lire l'historique.
3

Liste Blanche d'IP (Fortement Recommandé)

Si vous avez une IP statique (à domicile via la configuration du routeur ou VPS) :

• Sélectionnez « Restrict access to trusted IPs only »
• Entrez l'adresse IP de sTraderZ.com :
   185.xxx.xxx.xxx (IP exacte trouvée dans votre configuration de compte)
• Enregistrez

Si aucune IP statique n'est disponible : laissez « Unrestricted », mais alors la permission de lecture seule est votre seule couche de protection. C'est acceptable car aucun trade n'est possible de toute façon — mais une IP statique est la solution plus propre.
4

Connexion à sTraderZ.com

1
🏦 Créer un compte
Comptes → + Nouveau compte → Sélectionner courtier : « Binance » → Enregistrer.
2
🔑 Entrer les identifiants API
Aperçu du compte → cliquez sur le compte Binance → Onglet Configuration → collez la clé API et le Secret depuis votre gestionnaire de mots de passe → Enregistrer.
3
🔄 Lancer la synchronisation
Cliquez sur « Synchroniser maintenant ». La synchronisation initiale charge les 12 derniers mois — selon le volume de trades, cela prend 30 sec à 2 min.
✓
⏰ Synchronisation automatique active
Désormais, la synchronisation fonctionne régulièrement en arrière-plan. Les nouveaux trades, les mouvements de portefeuille et les conversions sont capturés automatiquement.

7. Qu'est-ce Qui Est Synchronisé ?

Type de données Statut Notes
Trades spot✅Complet — Buy/Sell, toutes paires (BTC/USDT, ETH/EUR, …)
Solde du portefeuille✅Soldes live du portefeuille spot convertis en EUR
Conversions✅API de conversion (p. ex. BTC → USDT directement) est enregistrée comme un trade
Récompenses Earn / Staking✅Flexible & Locked Earn sont marqués comme revenus imposables
Dépôts / Retraits✅Dépôts et retraits suivis dans le flux de trésorerie
Futures / Marge⚠️Bêta — nécessite une permission séparée, peut être activée dans la configuration du compte
Trades P2P❌L'API ne fournit pas P2P — peut être importé manuellement via CSV
NFTs❌Pas (encore) pris en charge

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.
✨

Bonnes Pratiques de Sécurité

Trois règles qui vous protègent contre 99 % des désastres API crypto :

1. N'activez jamais « Enable Withdrawals ». Même si un service vous le demande — dites non. Les retraits nécessitent de toute façon une liste blanche séparée côté Binance, mais si la clé est compromise et que vous avez activé les retraits, c'est terminé.

2. Traitez le Secret API comme un mot de passe — utilisez un gestionnaire de mots de passe (Bitwarden, 1Password, KeePass), ne le stockez jamais en texte clair nulle part, ne le partagez jamais par email/Slack/Telegram.

3. Rotation tous les 90 jours. Les clés Binance n'expirent techniquement pas, mais faites-les tourner par discipline. Supprimez l'ancienne clé, créez-en une nouvelle, mettez-la à jour dans sTraderZ.com — prend 3 minutes.

⚠️ Synchronisation Ne Fonctionne Pas — Que Faire ?

Erreur : « Invalid API-key, IP, or permissions for action »
Cause la plus courante : vous avez activé la liste blanche IP mais n'avez pas ajouté notre IP. Correction : allez dans Binance → API Management → liste blanche IP → ajoutez notre IP (voir configuration du compte).

Erreur : « Signature for this request is not valid »
Secret API entré incorrectement. Un espace de fin est souvent copié lors du copier-coller. Solution : copiez à nouveau le secret depuis votre gestionnaire de mots de passe, collez-le, enregistrez.

Erreur : « Account has insufficient permissions »
Vous avez créé la clé API sans « Enable Reading » — facile à manquer lors de la désactivation d'autres permissions. Solution : dans Binance → modifier la clé → activer « Enable Reading ».

Synchronisation initiale très longue (> 5 minutes) :
Pour les grands comptes avec > 10 000 trades, la synchronisation initiale prend genuinement plus de temps. Laissez-la tourner — après cela, la synchronisation incrémentale (toutes les 10 min) est très rapide.

11. Comparaison des Alternatives Crypto

Binance est le plus grand, mais pas le bon choix pour tout le monde. Une brève comparaison des trois courtiers crypto les plus pertinents pour la région DACH :

Fournisseur Localisation / Régulation Sync API Rapport Fiscal DE Force
Binance Global / LT, PL ✅ ⚠️ Manuel Plus grande sélection, frais les plus bas, conversions
Bitpanda AT / FMA ✅ ✅ Rapport DE/AT Régulé localement, convivial pour débutants, rapport fiscal inclus
Bitcoin Suisse CH / SBA ⚠️ CSV ✅ Rapport CH Premium, custody, OTC pour résidents CH
Kraken US / FinCEN, BaFin ✅ Roadmap ⚠️ Manuel Haute liquidité, compatible US, marge/futures
ℹ️ Mon argumentaire pour Bitpanda — si vous habitez en DE/AT, êtes nouveau dans la crypto et souhaitez une déclaration fiscale sans tracas, Bitpanda est presque toujours le meilleur choix par rapport à Binance. Binance est plus pertinent une fois que vous avez des volumes de trading plus élevés et avez besoin des frais les plus bas. Utiliser les deux simultanément est parfaitement légitime.

12. De la Synchronisation à Ton Premier Trade Crypto

Compte connecté ? Félicitations — la synchronisation fonctionne maintenant en arrière-plan.