Aller au contenu

Crypto : paires spot et perpétuels

Toutes les offres pour les trades saisis à la main et les imports (Free un fichier par jour) ; les clés d’API des exchanges à partir de Trader.

La crypto est à côté des futures, des actions et des options dans le même journal : les mêmes listes, le même calendrier, les mêmes statistiques, checklists et revues IA. Une paire spot s’achète et se vend (BTCUSDT) ; un perpétuel va long et short, avec funding (BTCUSDT.P). Le filtre Marché a Crypto pour les deux. Un trade d’une plateforme connectée trace sur sa page les barres d’une minute de la plateforme, avec MFE et MAE à la minute près (Graphiques, MFE et MAE).

La page du trade d’un perpétuel : le short sur les barres d’une minute de la plateforme, son funding, l’effet de levier et le prix de liquidation

TakeJournal nomme une paire par sa crypto et sa devise de cotation, quelle que soit la façon dont l’exchange l’écrit : BTC-USD, XBT/USD et XXBTZUSD sont tous BTCUSD, donc le même marché sur deux exchanges est un seul instrument. Un perpétuel reçoit .P à la fin, comme sur TradingView (ETHUSDT.P), car les exchanges nomment de la même façon la paire spot et le perpétuel. Les statistiques rangent les deux sous la crypto (BTC).

Les quantités ont des décimales (0,015 BTC), les prix autant de chiffres qu’il leur faut (0,00001234). Une paire spot se détient, elle ne se vend jamais à découvert.

Les cryptos arrivées sur le compte d’ailleurs, un dépôt ou une récompense que signale la clé de l’exchange, forment une position à part sur la crypto en dollars (BTCUSD), ouverte à leur valeur à l’arrivée. Une vente sur une paire en dollars au-delà des cryptos que TakeJournal a vu acheter là les prend, donc le trade montre le mouvement du prix depuis leur entrée ; vos allers-retours sur la paire restent des trades à part. Les cryptos qui quittent le compte ferment ce qui est entré, puis la plus ancienne position de la crypto sur une paire en dollars. Une vente de cryptos que TakeJournal n’a jamais vues ferme ce qui est détenu et n’ouvre rien, et une vente sur une paire cotée en euros ou en une crypto ne prend pas les cryptos déposées.

Un compte compte dans sa propre devise : le dollar, sauf si vous en choisissez une autre, comme pour un compte Kraken en euros. USDT, USDC et les autres stablecoins en dollars comptent comme des dollars. Une paire cotée dans une autre devise que celle du compte (BTC/EUR sur un compte en dollars, BTCUSDT sur un compte en euros) est évaluée au taux de référence de la Banque centrale européenne du jour de sa clôture (un week-end, à celui du vendredi). Une paire cotée en une crypto (ETH/BTC) ne montre son résultat qu’en points. Des frais prélevés dans la crypto achetée, en BNB ou dans une autre devise sont évalués en dollars à l’entrée du trade, puis dans la devise du compte au taux de leur jour. Un achat qui paie ses frais dans la crypto achetée détient les cryptos que la plateforme a créditées, la quantité moins les frais, si bien que les vendre toutes clôt le trade.

Une position ouverte, achetée ou déposée, est évaluée au prix horaire de la crypto tiré des données de marché publiques de Binance (un perpétuel au prix spot, une paire en euros au taux du jour), dans toutes les offres ; le trade montre de quelle heure il date. Un prix que vous saisissez sur la page du trade vaut jusqu’à celui de l’heure suivante. Une crypto que Binance ne liste pas garde le prix que vous saisissez.

La crypto se traite tous les jours, week-end compris, donc un trade crypto compte le jour calendaire de votre fuseau horaire (celui de votre profil) : un trade du vendredi soir à New York reste le vendredi. Le calendrier montre le samedi et le dimanche quand un mois a des trades ces jours-là. Les futures gardent leur séance (à partir de 18:00 heure de New York), les actions et les options le jour de New York (voir le calendrier).

Perpétuels : funding, effet de levier, liquidation

Section intitulée « Perpétuels : funding, effet de levier, liquidation »

Les paiements de funding comptent dans le résultat de la position ouverte au moment où ils ont été payés, comme des frais : la page du trade montre le funding à côté des frais, et l’onglet Exécutions liste les paiements. Sur un compte que vous remplissez vous-même, ajoutez-y un paiement (Ajouter un funding : l’heure et le montant dans la devise du compte, négatif quand il est payé).

L’effet de levier et le prix de liquidation peuvent être notés sur n’importe quel perpétuel (Levier · liquidation sur la page du trade) ; la page montre à quelle distance de l’entrée était le prix de liquidation.

Nouveau trade → Crypto ou Perpétuel : la paire telle que l’exchange l’écrit, la quantité, l’ouverture et la clôture avec leurs prix, les frais dans la devise du compte. Voir trades à la main.

Comptes → le compte → Importer des trades. L’export des trades de Kraken, l’historique des trades spot et des futures USDⓈ-M de Binance et les exécutions de Coinbase sont reconnus à leurs colonnes : pas d’IA. Le fichier de tout autre exchange s’associe comme l’export de n’importe quel broker. L’aperçu demande, pour chaque symbole qui ressemble à une paire, s’il s’agit d’une paire crypto spot, d’un perpétuel ou de pas de la crypto (le type du fichier décide de la valeur par défaut), et le range sous le nom de TakeJournal.

Un export d’OKX, de Bitget ou d’Hyperliquid : choisissez la plateforme sous D’où vient le relevé puis Associer le relevé. TakeJournal l’associe pour vous dans chaque plan, et dès que quelques utilisateurs ont importé le même format, il est reconnu à ses colonnes comme celui de Kraken.

Un fichier de paiements de funding (l’historique des revenus de Binance, un journal de transactions avec des lignes de funding) s’importe de la même façon : associé par les noms de ses colonnes, il ajoute les paiements aux perpétuels du compte. L’export du ledger de Kraken est aussi reconnu à ses colonnes : ses dépôts, retraits, transferts et récompenses vont dans le registre du compte (ses trades viennent de l’export des trades), et le relevé de dépôts de tout autre exchange s’associe comme n’importe quel export.

Connexions → Ajouter une connexion : Kraken (spot), Binance (spot et futures USDⓈ-M), Bybit (spot et perpétuels d’un Unified Trading Account) ou Coinbase (Advanced Trade, spot). Créez une clé qui ne peut que lire, comme expliqué ci-dessous pour chaque exchange. Tester l’identifiant sur la carte de la connexion dit quand une clé peut faire davantage (Binance, Bybit et Coinbase le disent, Kraken non) : créez une clé qui ne peut que lire et saisissez-la avec Modifier.

Un compte démo. Binance et Bybit, ainsi que les plateformes passant par CCXT qui ont une démo ou un testnet, demandent dans Compte quel compte la clé lit : le compte réel, ou Démo ou testnet avec une clé créée là-bas (chez Binance et Bybit, dans leur Demo Trading). Les comptes le portent dans leur nom, comme Bybit demo spot. La démo de Binance ne tient ni dépôts ni retraits : seuls ses trades arrivent.

  1. Sur kraken.com, le menu du compte › Settings › API, Create API key.
  2. Un nom, comme TakeJournal. Parmi les permissions, cochez seulement Query closed orders & trades et Query ledger entries (la seconde pour les dépôts et les retraits ; sans elle, les trades arrivent quand même). Laissez tout le reste décoché : ni ordres, ni dépôts, ni retraits.
  3. Aucune restriction d’IP n’est nécessaire. Generate key, puis copiez l’API key et la Private key dans la connexion ; Kraken ne montre la clé privée qu’une fois.

Kraken ne dit pas à une application ce qu’une clé peut faire : vérifiez vous-même les cases.

  1. Sur binance.com, le menu du profil › API Management, Create API, System generated, un nom et la vérification de sécurité.
  2. Parmi les API restrictions, gardez seulement Enable Reading, tel que Binance crée la clé. Ne cochez jamais Enable Spot & Margin Trading, Enable Futures, Enable Withdrawals ni Permits Universal Transfer.
  3. L’accès IP Unrestricted convient à une clé qui ne fait que lire (Binance ne demande des adresses IP qu’avant le trading et les retraits).
  4. Copiez l’API key et la Secret key dans la connexion ; Binance ne montre le secret qu’une fois.

Binance donne les trades d’un compte spot paire par paire : TakeJournal demande les paires des cryptos que vous détenez ; nommez dans la connexion toute autre paire que vous tradez.

  1. Sur bybit.com, le menu du profil › API, Create New Key, System-generated API Keys.
  2. API Transaction, un nom et les permissions Read-Only ; jamais Read-Write.
  3. Sans adresses IP, Bybit garde une clé trois mois ; créez-en alors une nouvelle et saisissez-la avec Modifier.
  4. Copiez l’API key et l’API secret dans la connexion.

Le compte doit être un Unified Trading Account. Les clients de Bybit EU (bybit.eu) choisissent Région : Europe (bybit.eu) : une clé créée là-bas ne fonctionne que sur les serveurs de Bybit EU. Bybit EU ne propose que le spot, la connexion n’y a donc pas de compte de perpétuels.

  1. Sur la Coinbase Developer Platform (portal.cdp.coinbase.com, connecté avec votre compte Coinbase), API keys, Create API key.
  2. Un nom ; dans les réglages avancés, le portefeuille dans lequel vous tradez, seulement View (jamais Trade ni Transfer) et l’algorithme de signature ECDSA, pas l’Ed25519 que propose Coinbase.
  3. Create, puis copiez le nom de la clé (organizations/…/apiKeys/…) et sa clé privée, avec sa première et sa dernière ligne, dans la connexion ; Coinbase ne les montre qu’une fois.

Le formulaire d’une nouvelle connexion à OKX : le type, un nom, la région, le compte sur la démo, la clé API, la clé secrète et la phrase secrète

Les plateformes lues via CCXT demandent la même chose : une clé en lecture seule, créée sur la plateforme. Où la créer, quoi autoriser et ce que la connexion demande en plus :

Plateforme Où créer la clé N’autoriser que La connexion demande aussi
Binance US menu du profil › API Management la lecture ; ni Enable Spot Trading ni les retraits
BingX API Management Read
Bitget API Key Management Read-only, avec Orders et Holdings pour Futures et Trade pour Spot la phrase secrète choisie avec la clé
Bitstamp Settings › API access celles de consultation (solde, transactions) ; confirmez la clé depuis l’e-mail de Bitstamp
BloFin API (menu du compte) READ ; ni TRADE ni TRANSFER la phrase secrète choisie avec la clé
Crypto.com Settings › API Keys Can Read ; ni Can Trade ni Can Withdraw
Delta Exchange API Management Read Data ; pas Trading
Deribit Account › API Account, Trade et Wallet sur read le Client ID comme clé API, le Client Secret comme clé secrète
Gate APIv4 Keys read-only pour chaque produit, retraits désactivés
Gemini Settings › API le rôle Auditor
HTX API Management Read ; ni Trade ni Withdraw
Hyperliquid pas de clé l’adresse publique du portefeuille (0x…) : ses trades sont publics
KuCoin API Management General ; ni Trade, ni Transfer ni Withdrawal la phrase secrète choisie avec la clé
MEXC API Management les permissions de lecture (view) ; aucune d’écriture
OKX menu du profil › API Read ; ni Trade ni Withdraw la phrase secrète choisie avec la clé ; Région : Mondial (okx.com), Europe (my.okx.com) ou États-Unis (app.okx.com)
Phemex API Management la lecture seule
Upbit My page › Open API 자산조회, 주문조회, 입금조회, 출금조회 (les consultations) Upbit exige une adresse IP : saisissez celle de TakeJournal, 57.131.134.52
WOO X API (menu du compte) Read ; pas Enable trade

Une clé sans adresse IP expire au bout de 90 jours chez MEXC, HTX et BloFin : créez-en alors une nouvelle et saisissez-la avec Modifier. Bitget donne au plus ses 90 derniers jours à une synchronisation : la première ne lit pas plus loin. BingX, Bitget, BloFin, Crypto.com, Delta Exchange, Deribit, Gate, Gemini, Hyperliquid, OKX, Phemex et WOO X ont une démo ou un testnet : choisissez Compte : Démo ou testnet et utilisez une clé créée là-bas.

Chaque synchronisation lit les trades depuis la précédente ; les perpétuels apportent leur funding. Les dépôts, les retraits et les transferts entrent dans le registre du compte, où ils font bouger son solde (le registre), les cryptos à leur valeur du moment dans la devise du compte :

  • Kraken : les dépôts, les retraits, le staking et les transferts de futures, les récompenses et les ajustements du ledger.
  • Binance : les dépôts et les retraits de cryptos et de monnaie fiat, les transferts entre les portefeuilles spot et futures (une paire sur les deux comptes) et depuis le portefeuille de funding ; seulement les transferts des six derniers mois, tout ce que garde Binance.
  • Bybit : l’argent qui entre et sort du compte de trading depuis le compte de funding, sur le compte spot (spot et perpétuels partagent un portefeuille).
  • Coinbase : les dépôts et les retraits fiat de chaque portefeuille, les cryptos envoyées et reçues, les récompenses et les transferts vers et depuis Coinbase Pro ; les achats, ventes et conversions faits dans l’app Coinbase arrivent comme des trades. Les trades de Coinbase Pro ne sont plus dans l’API de Coinbase : importez son export des exécutions.

Les clés sont conservées chiffrées, et une clé qui ne peut que lire ne peut ni trader ni retirer. Dix-huit autres plateformes se lisent de la même façon, en lecture seule : Binance US, BingX, Bitget, Bitstamp, BloFin, Crypto.com, Delta Exchange, Deribit, Gate, Gemini, HTX, Hyperliquid (par l’adresse publique du portefeuille, sans clé), KuCoin, MEXC, OKX, Phemex, Upbit et WOO X (les autres plateformes).

Une position que les exécutions n’expliquent pas

Section intitulée « Une position que les exécutions n’expliquent pas »

Hyperliquid indique la position avant chaque exécution. Là où les exécutions du journal n’y mènent pas (une position ouverte avant l’historique que garde Hyperliquid, ou une position changée par ce que les exécutions ne montrent pas), la différence entre comme une exécution estimée juste avant cette exécution, à son prix, pour que le trade commence là où le dit la plateforme. Son résultat est alors une estimation : la page du trade le dit, et vous recevez l’alerte Une clôture manquante (avec push et e-mail, Profil › Notifications) et une ligne sur la carte de la connexion et la page du compte. Vérifiez le trade et choisissez Garder l’estimation : l’alerte prend fin et le trade compte tel qu’il est.

Les contrats sur marge en crypto (inverses), l’emprunt sur marge, Kraken Futures et les futures de Coinbase. Un trade saisi à la main ou importé n’a de graphique que là où une plateforme connectée a récupéré les barres de sa paire à son heure : notez à la main MFE et MAE des autres.