> For the complete documentation index, see [llms.txt](https://docs.goodcrypto.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/ai-agents.md).

# Agents IA

Connecte Claude Desktop, Claude Code, Codex, Cursor ou toute app MCP à ton installation goodcryptoX, avec des clés pour lire, proposer ou trader dans tes limites.

goodcryptoX intègre un serveur MCP et une API : Claude Desktop, Claude Code, Codex, Cursor ou toute app MCP peut lire tes positions, proposer des ordres et trader sur les exchanges que tu connectes dans tes limites, sur ton installation, sans compte goodcryptoX. Un programme utilise l'[API](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/api.md). Ton goodcryptoX est privé, sur ordinateur, NAS ou serveur ; serveur MCP et API rejoignent cette installation. Nous n'offrons aucun serveur MCP ni API de trading publics auxquels te connecter.

Notre relais est le moyen par défaut d'atteindre ton installation depuis un autre appareil. Il ne peut lire ni ta clé d'accès, ni les requêtes, ni les réponses. Un ordinateur peut utiliser un [tunnel SSH](#use-an-ssh-tunnel-instead) à la place, en contournant le relais ; un [téléphone](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/readme/phone-access.md) peut aussi se connecter via le relais.

Les comptes de démonstration et la vue Bybit pour développeurs, y compris les exemples d'envoi avec une clé en lecture seule et de rétablissement, sont réservés aux personnes connectées au panneau. Les clés d'accès et MCP ne peuvent pas utiliser `demoBybitView` ni `demo=1`.

## Ce qu'un agent peut faire <a href="#what-an-agent-can-do" id="what-an-agent-can-do"></a>

Ces actions existent par MCP et API. La clé fixe ce que goodcryptoX autorise ; les règles de l'agent IA peuvent autoriser moins. Un paiement depuis ton wallet, comme l'achat de crédits, reste le tien : l'agent peut t'expliquer comment le faire.

Avec toute clé, il peut :

* **Comptes et avoirs** : lire comptes, soldes, positions, ordres ouverts, bots et états des comptes et de goodcryptoX. L'outil `portfolio` identifie les coins connus d'un compte à l'autre et les actifs d'exchange non associés, avec le prix de chaque avoir et les prix manquants ([API](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/api.md#portfolio-identities)).
* **Réglages du collatéral** : lire les réglages du collatéral de chaque compte dans l'instantané `balances` (`perCoinCollateral`). Il indique la wallet, si l'exchange accepte chaque coin et s'il est utilisé comme collatéral ; une valeur absente ne signifie pas désactivé. Seule la personne peut changer les réglages du collatéral dans goodcryptoX ; les clés API et les outils MCP peuvent les lire. Les comptes démo et leurs réglages ne sont disponibles que dans une session de personne.
* **Volume de trading** : consulter le montant de tes trades depuis que tu as connecté chaque compte, tes exécutions, tes frais et ton PnL réalisé, par compte et selon qui a passé l'ordre, sur toute la période ou par jour UTC. La réponse indique où il manque de l'historique ou des prix ([API](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/api.md#trading-volume)).
* **Ordres et historique** : lire détails et ordres terminés, et interroger l'exchange sur un ordre à l'instant, comme le fait Actualiser sur la carte de l'ordre (rien ne change sur l'exchange).
* **Détails du bot** : lire plans, ordres, résultats et paiements de funding.
* **Paiements de funding** : lire ce qu'un compte a payé ou reçu sur un marché, le coin du paiement et la part de chaque bot.
* **Marchés** : lire marchés disponibles, règles, prix et volumes des bougies.
* **Devise de référence** : lire la devise choisie pour goodcryptoX et son cours face au dollar.
* **Crédits** : lire tes crédits, le volume de départ restant sur CEX (`remaining` ; ajoute le volume que `balance` achète au tarif `rate` pour obtenir le volume total restant sur CEX affiché dans le panneau), les frais, lesquels de tes exchanges paient en crédits, s'ils s'épuisent ou si les nouveaux ordres et bots sont en pause et comment en ajouter. Sur Solana, les crédits peuvent aussi se payer en $GOOD, détenus ou achetés avec n'importe quel coin dans le même paiement, avec la remise $GOOD ; un programme peut chiffrer un paiement avec `POST /api/v1/credits/pay` (`input`, le montant du coin, ou `amount`, avec `build: false`) ; le paiement lui-même reste le tien, depuis ton wallet. Le même outil `credits` renvoie `totals` : USD payés, crédits issus des paiements, crédits offerts, volume CEX et frais depuis le début ; moyennes quotidiennes et mensuelles sur 30 jours du volume et des frais ; période, indication des coûts estimés et différence de solde. Les lectures par jour avec `before` restent disponibles.
* **Code de parrainage** : lire le code avec lequel tu as rejoint et tes frais, tes trois codes, ce qu'ils ont rapporté, combien d'amis les ont utilisés et combien ont passé un ordre depuis, et ton versement.
* **Sa propre clé** : lire sa portée, ses comptes, marchés et limites, et ce qu'elle a déjà utilisé des 24 heures.
* **Clés API de l'exchange** : revérifier la clé API d'un compte Binance après que tu as changé ses permissions sur Binance, et lire ce qu'elle peut faire maintenant.
* **Aperçus et rapports** : prévisualiser ordres et bots sans trader et examiner les événements.

Avec une clé **Trader**, il peut aussi :

* **Ordres** : placer des ordres avec take profit et stop loss, modifier les siens et annuler les ordres hors bots des comptes autorisés.
* **Effet de levier** : régler levier et mode de marge.
* **Garder la clé API active** : il voit si Garder ma clé API active est activé pour un compte Binance ; toi seul peux l'activer ou le désactiver.
* **Payer les frais en BNB**: voit si un compte Binance paie ses frais en BNB ; toi seul peux l'activer ou le désactiver.
* **Marge isolée**: ajouter ou retirer de la marge sur une position isolée.
* **Bots** : créer et lancer des bots, modifier, arrêter ou fermer ceux qu'il a créés.
* **Actions groupées** : annuler des ordres hors bots, arrêter ses bots ou fermer des positions filtrées, y compris les tiennes. Les avoirs des bots restent sauf s'il arrête aussi ses bots en fermant leurs positions.

Les trades suivent tes [comptes, marchés et limites](#keys-and-limits) ; les annulations touchent les ordres hors bots des comptes autorisés, quel que soit le marché. Tu mets ses bots en pause ou les reprends via **Suspendre** et **Reprendre** de la clé dans goodcryptoX ; l'agent ne peut pas le faire directement.

Une clé **Proposer** ou **Trader** peut préparer ordres et bots à vérifier et lancer dans goodcryptoX. Les [propositions](#proposals) ne tradent pas avant ton lancement. Il peut retirer une de ses propositions en attente.

Aucune clé ne peut retirer ou transférer de fonds, changer tes réglages ni créer une clé. Une clé de trading ne modifie que ses ordres et bots mais peut annuler tout ordre hors bot sur les comptes autorisés. Elle ne peut annuler directement les ordres de bots, même arrêtés.

Les **Proposition d'ordre**, **Proposition de bot** et l'état **À sa limite** arrivent dans Telegram au nom de la clé. **Ordre accepté**, **Annulation acceptée** et **Bot créé** aussi, sauf désactivation de **Me prévenir dans Telegram** dans ses détails, activé au départ. Tes actions dans le panneau n'envoient rien. Ses détails dans **Paramètres › MCP & API** gardent l'activité dans **Ce qu'elle a fait** : les ordres qu'elle a placés et annulés, l'effet de levier qu'elle a réglé et la marge qu'elle a ajoutée ou retirée.

## Connecter toute app MCP ou un programme <a href="#connect-any-mcp-app-or-program" id="connect-any-mcp-app-or-program"></a>

Ouvre **Paramètres › MCP & API**. Appuie sur **Créer une clé**, nomme-la et choisis ses droits :

* **Lire** lit ordres, positions et bots, sans changement.
* **Proposer** lit et propose ordres et bots à lancer dans le panneau. Rien ne trade sans toi.
* **Trader** lit, place et annule des ordres et gère ses bots dans tes [comptes, marchés et limites](#keys-and-limits).

Appuie encore sur **Créer la clé**, puis **Copier** et **Terminé**. Pour revoir la clé, ouvre sa ligne : **Clé** la masque, avec **Afficher** et **Copier**. Une clé par app ou programme permet des révocations indépendantes.

Sous les clés, le bloc de connexion a deux côtés, **Agents IA** et **API**, et en haut à droite la clé qu'il insère : la dernière créée est déjà choisie ; sélectionne-en une autre dans la liste. Chaque app a une ligne indiquant où va sa configuration : copie-la et colle-la à cet endroit. Ta clé, l'adresse de ton installation et le moyen de l'atteindre depuis un autre ordinateur sont déjà inclus, sans rien à remplir. Copiée via notre relais, la même ligne fonctionne sur l'ordinateur qui héberge goodcryptoX et sur tout autre ([Depuis un autre ordinateur](#from-another-computer)). Les lignes sont adaptées au système du navigateur où tu les copies : copie-les sur l'ordinateur qui héberge l'app.

Claude Code, Codex et Cursor lancent le connecteur avec Node.js 18 ou plus récent sur leur ordinateur ; Claude Desktop fournit le sien. Si l'app ne trouve pas `npx`, installe Node.js depuis [nodejs.org](https://nodejs.org/) puis redémarre l'app. Le premier démarrage récupère le connecteur, parfois en quelques secondes.

### Claude Desktop <a href="#claude-desktop" id="claude-desktop"></a>

Sur Mac et Windows.

1. Appuie sur **Télécharger** près de **Claude Desktop** et double-clique le fichier nommé d'après ta clé. Claude Desktop ouvre l'installation.
2. Appuie sur **Installer**. Claude Desktop affiche ceci pour tout connecteur hors de son répertoire. Le nôtre parle seulement à goodcryptoX avec ta clé et ne lit rien d'autre sur l'ordinateur.
3. Claude Desktop demande ta **clé d'accès goodcryptoX**. Appuie sur **Copier** près de **Télécharger** dans goodcryptoX, colle la clé et appuie sur **Enregistrer**.
4. Active l'extension : Claude Desktop l'installe désactivée jusqu'à l'enregistrement de sa clé.
5. Chaque outil goodcryptoX commence en **Ask** : Claude Desktop demande avant usage. Sur sa ligne, appuie sur **Configure**, puis passe les outils voulus de **Ask** à **Allow**, au moins ceux **Read …**, pour consulter sans demandes répétées.
6. Demande « Quels ordres ai-je ouverts ? ». La clé fixe le maximum dans goodcryptoX ; les permissions de Claude Desktop fixent ses demandes.

### Claude Code <a href="#claude-code" id="claude-code"></a>

Dans le terminal, l'IDE et l'onglet Code.

1. Appuie sur **Copier** près de **Claude Code**.
2. Ouvre un terminal sur son ordinateur (Terminal sur Mac/Linux, PowerShell sur Windows ; celui de l'IDE convient), colle la ligne et appuie sur Entrée. Claude Code répond `Added stdio MCP server gcx … to user config`. Une fois suffit pour terminal, IDE et onglet Code. Pour remplacer plus tard, lance d'abord `claude mcp remove <name>` avec le nom après `--scope user` dans la ligne : un second nom identique est refusé.
3. Lance `claude mcp list` : goodcryptoX indique `✓ Connected`. Dans une session, `/mcp` le liste avec ses outils.
4. Demande tes ordres. Claude Code demande au premier usage d'un outil : **Oui** ou **Yes, and don't ask again** pour cet outil ; `/permissions` affiche et modifie les autorisations sans demande.

### Codex <a href="#codex" id="codex"></a>

1. Appuie sur **Copier** près de **Codex**.
2. Le plus simple : colle les lignes dans Codex et demande leur ajout à sa configuration. Il le fait et demande de redémarrer ; relance-le.
3. Ou ajoute-les toi-même dans son fichier de configuration, à créer au besoin : `~/.codex/config.toml` sur Mac/Linux, `%USERPROFILE%\.codex\config.toml` sur Windows. Le dossier `.codex` est caché : dans le dialogue **Ouvrir** de l'éditeur sur Mac, Cmd+Shift+G puis `~/.codex` ; sur Windows, saisis le chemin dans le champ de nom. Colle les lignes à la fin en gardant l'existant, sauvegarde et relance Codex : nouveau `codex` au terminal ou fermeture et réouverture de l'app.
4. `codex mcp list` affiche goodcryptoX comme `enabled` ; en session, `/mcp` liste ses outils.
5. Demande tes ordres. Les demandes avant outil dépendent du réglage d'approbation de Codex (`/approvals` en session).

### Cursor et autres apps <a href="#cursor-and-other-apps" id="cursor-and-other-apps"></a>

1. Appuie sur **Copier** près de **Cursor et autres apps**.
2. Le plus simple : colle les lignes dans le chat Cursor et demande leur ajout aux réglages MCP.
3. Ou ouvre **Cursor Settings** (Cmd+Shift+J sur Mac, Ctrl+Shift+J sur Windows/Linux), puis **Tools & MCPs**, **Add Custom MCP**. Cursor ouvre `mcp.json`. Vide : colle les lignes ; avec des serveurs : colle seulement l'entrée goodcryptoX dans `"mcpServers"`. Sauvegarde.
4. Dans **Tools & MCPs**, goodcryptoX apparaît avec ses outils et un interrupteur.
5. Demande tes ordres à l'agent. Cursor demande avant usage sauf si tu autorises les outils automatiques dans ses réglages.

Toute app lançant des serveurs MCP par entrée et sortie standard prend la même entrée : commande, arguments et environnement. Le connecteur n'est pas une adresse web de chat hébergé.

## Depuis un autre ordinateur <a href="#from-another-computer" id="from-another-computer"></a>

La ligne copiée via notre relais fonctionne depuis tout ordinateur. Quand goodcryptoX ne tourne pas sur l'ordinateur de ton app, le connecteur atteint ton installation via notre relais, qui ne peut lire ni ta clé d'accès, ni les requêtes, ni les réponses. Ouvre goodcryptoX sur cet ordinateur via notre relais, copie la ligne de ton app et colle-la comme ci-dessus.

Au premier lancement, le connecteur associe l'ordinateur avec le code à usage unique de la ligne. Il vaut jusqu'à utilisation, un jour maximum, page goodcryptoX ouverte ou non ; redémarrer goodcryptoX l'expire aussi. Ensuite, toutes les apps de cet ordinateur se connectent seules. Il apparaît dans **Paramètres › Appareils** comme **Programs on …**, avec **Retirer**.

Si l'app affiche **This connector has expired. Download it again from goodcryptoX**, un jour n'est pas forcément passé : redémarrer goodcryptoX ou utiliser le code sur un autre ordinateur rend aussi l'ancienne ligne inutilisable. Copie une nouvelle ligne depuis **Paramètres › MCP & API** et remplace l'entrée de ton app en suivant ses étapes ci-dessus (dans Claude Code, retire d'abord l'ancienne avec `claude mcp remove`) ; pour Claude Desktop, retélécharge son fichier. Si la connexion enregistrée ne peut pas être ouverte, suis les étapes ci-dessous.

Le connecteur utilise l'adresse de ton installation quand il peut confirmer que ton goodcryptoX y répond. Sinon, il se connecte via notre relais. Sur un autre ordinateur, passer par le relais est normal.

Si l'app affiche **Can't open or save the connection on this computer**, vérifie d'abord que tu es connecté avec le compte utilisateur de l'ordinateur qui a établi la première connexion. Ce message peut aussi indiquer qu'un fichier est endommagé, que l'accès est refusé ou que Windows ne peut pas l'ouvrir ou l'enregistrer. Copier une nouvelle ligne ne suffit pas à réparer les fichiers enregistrés.

Si les fichiers enregistrés doivent être remplacés, suis ces étapes. Elles remplacent les connexions enregistrées de ton utilisateur actuel sur l'ordinateur ; elles ne résolvent ni un blocage de PowerShell ni les problèmes d'autorisations du dossier.

1. Ferme les apps d'IA qui utilisent goodcryptoX et arrête tout `gcx connect` en cours.
2. Ouvre le dossier qui contient les fichiers : sous Windows, saisis `%LOCALAPPDATA%\goodcryptoX` dans la barre d'adresse de l'Explorateur de fichiers ; sur Mac, utilise **Aller au dossier** du Finder avec `~/Library/Application Support/goodcryptoX` ; sous Linux, ouvre `~/.local/share/goodcryptoX` dans ton gestionnaire de fichiers.
3. Renomme `connect` avec un nom qui n'est pas utilisé, comme `connect-old`. Si tu ne peux pas le renommer, règle d'abord l'accès au dossier.
4. Copie une nouvelle ligne depuis **Paramètres › MCP & API**, remplace l'entrée d'une app en suivant ses étapes ci-dessus et lance cette app. Pour Claude Desktop, retélécharge son fichier.
5. Répète pour chaque installation goodcryptoX que tu utilises. Les autres apps du même utilisateur de l'ordinateur et de la même installation réutilisent ensuite cette connexion enregistrée.

Si l'app affiche **The connection took too long. Try again in a minute**, réessaie dans une minute. Un connecteur en marche réessaie tout seul ; si ton app d'IA a arrêté le connecteur, redémarre l'app. Si cela continue, il faut examiner le problème de plus près.

Garde les lignes privées : elles contiennent ta clé et, un jour, le code d'association. Le fichier Claude Desktop contient le code mais pas la clé, qu'il demande. Le code seul ne lit ni ne trade ; une clé reste nécessaire.

Un connecteur en marche se reconnecte après veille ou coupure réseau ; l'installation trade tant qu'elle tourne et reste connectée à l'exchange. Sans relais, utilise [un tunnel SSH](#use-an-ssh-tunnel-instead).

Depuis une [adresse domestique](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/readme/set-up-on-your-mac.md#your-home-network), la ligne copiée connecte ton app IA ou programme directement à l'installation qui l'a créée, avec la clé choisie, sans jamais passer par notre relais. Utilise-la sur un réseau de confiance ou via ta propre adresse HTTPS de confiance : en HTTP, quelqu'un qui lit le trafic peut copier la clé.

## Utiliser plutôt un tunnel SSH <a href="#use-an-ssh-tunnel-instead" id="use-an-ssh-tunnel-instead"></a>

Tu peux remplacer le relais par un tunnel SSH ; si tu ne sais pas ce que c'est, tu n'en as pas besoin. Il relie directement ton ordinateur à celui qui héberge goodcryptoX.

<details>

<summary>Connexion par SSH</summary>

1. Ouvre Terminal (PowerShell sous Windows) et redirige un port local vers celui de goodcryptoX sur l'autre ordinateur. Par exemple pour le port 8128 :

   ```sh
   ssh -N -L 8128:127.0.0.1:8128 <user>@<server-address>
   ```

   Utilise ton utilisateur et ton adresse SSH, avec `-i <private-key-file>` si nécessaire. Mets le vrai port goodcryptoX des deux côtés et dans l'adresse ci-dessous. Garde la commande active.
2. Ouvre `http://127.0.0.1:8128/gcx` via le tunnel avec le port goodcryptoX. Pour te connecter, lance `gcx open --print` sur l'installation (`docker exec gcx gcx open --print` dans Docker) et ouvre son lien sous 60 secondes. Voir [serveur](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/readme/set-up-on-a-server.md#sign-in) ou [NAS](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/readme/set-up-on-a-nas.md#sign-in) pour les détails.
3. Dans **Paramètres › MCP & API**, copie la ligne de l'app. Tant que le tunnel tourne, le connecteur trouve goodcryptoX à cette adresse locale et lui parle directement.

Les programmes utilisent la même adresse et leur propre clé. Fermer SSH coupe l'accès de cet ordinateur ; bots et ordres continuent sur l'installation.

</details>

## Appareils et suppression <a href="#devices-and-removal" id="devices-and-removal"></a>

**Paramètres › Appareils** liste navigateurs et ordinateurs associés. Chaque ligne **Programs on …** couvre apps et programmes d'une session de l'ordinateur ; renomme-la ou utilise **Retirer**. Les navigateurs ont leurs propres lignes.

**Retirer** coupe les connexions de programmes, pas les clés. Réassocie pour reconnecter. Les autres ordinateurs restent connectés. Les ordres déjà envoyés peuvent terminer ; supprimer n'annule pas d'ordres, n'arrête pas de bots et ne ferme pas de positions. Révoque séparément la clé pour enlever son accès partout.

## Statistiques de la clé <a href="#key-statistics" id="key-statistics"></a>

Chaque clé montre sa propre activité dans les paramètres et le Dashboard. **Actifs** compte ses ordres ouverts et bots en cours. **Volume** est la valeur négociée par ses ordres et bots, pas le solde du compte.

**PnL réalisé** est le gain ou la perte réalisé des trades de cette clé et du funding de ses bots, après frais. Il exclut le PnL non réalisé changeant des positions ouvertes. Par exemple, 20 de gain clôturé, moins 2 de frais et 1 de funding payé, contribuent pour 17. Le funding reçu s'ajoute au résultat.

Les chiffres montrent un total et les dernières 24 heures. Quand une clé négocie dans plusieurs devises, les résultats restent séparés ; un gain dans une devise n'est pas ajouté silencieusement à un gain dans une autre.

## Clés et limites <a href="#keys-and-limits" id="keys-and-limits"></a>

Chaque ligne de clé dans **Paramètres › MCP & API** montre ordres et bots ouverts, volume et PnL. Ouvre-la pour les limites, puis **Modifier** pour modifier droits et limites. Les propositions attendent dans **Propositions** sur Trading ([Propositions](#proposals)).

Pour **Trader**, choisis **Comptes** et **Marchés** (**Tous**, **Spot**, **Perps** ou **Personnalisé**, avec recherche et résultats cochés), puis tes limites. **Tous**, **Spot** et **Perps** incluent les marchés ajoutés plus tard. Comptes et marchés limitent les trades, pas lecture et propositions. Sans comptes ou marchés définis, aucun trade.

Chaque limite monétaire commence désactivée et affiche **Sans limite** : active celles que tu veux et saisis leur valeur. Les limites sont dans ta devise de base (**Paramètres › Général › Devise de référence**, dollar américain tant que tu n'en choisis pas une autre) : une clé garde la devise dans laquelle ses limites ont été fixées. Un marché coté en stablecoin compte à parité avec le dollar ; un marché coté en coin comme BTC est évalué au cours de ce coin. Une limite borne la valeur de ce que l'agent trade, jamais la marge utilisée : à 5x, un ordre de 1,000 USD utilise environ 200 USD de marge.

Choisir une autre devise de base convertit une fois les limites de chaque clé au taux du jour, et elles restent des montants dans la nouvelle devise : une limite de 1,000 USD devient 900 EUR à 0.9, et la limite appliquée reste 900 EUR quel que soit le taux ensuite. Les limites sur 24 heures additionnent ordres et bots de la clé sur les marchés cotés en différentes devises, chacun évalué dans la devise des limites à la vérification de l'ordre ; changer de devise ne réécrit rien des dernières 24 heures. Un bot dimensionné près de sa limite peut être retenu par un mouvement du taux ; **Réessayer** le lance dès qu'il rentre dans la limite. Au-delà, le refus donne les deux montants dans la devise des limites (« La valeur de l'ordre 945.00 EUR dépasse la limite de cette clé de 900.00 EUR »). Avec BTC ou ETH comme base, les limites sont des montants en coins et les dollars permis suivent leur cours.

| Section    | Limite                      | Ce que tu autorises                                                                                                                                            |
| ---------- | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Ordres** | **Max. par ordre**          | Valeur d'un ordre de l'agent, modifications comprises. Ses propres sorties ne comptent pas.                                                                    |
|            | **Volume max. sur 24 h**    | Ses ordres sur 24 heures, exécutés ou ouverts. Sorties de ses trades et ordres de bots exclus.                                                                 |
| **Bots**   | **Peut lancer des bots**    | Activé par défaut : tous les types ou ceux cochés. Désactivé : ordres seulement.                                                                               |
|            | **Max. par bot**            | Argent d'un bot : entrée et moyennages DCA, investissement total Grid.                                                                                         |
|            | **Volume max. sur 24 h**    | Argent des bots démarrés sur 24 heures. DCA compte au début du cycle ; Grid au lancement et aux hausses d'investissement.                                      |
| **Perps**  | **Max. par position**       | Valeur de sa position sur un marché après l'ordre. Visible avec marchés perpétuels.                                                                            |
|            | **Max. toutes positions**   | Valeur totale de ses positions après l'ordre.                                                                                                                  |
|            | **Marge**                   | **Isolée uniquement** par défaut ou **Toute**. Isolée limite chaque perte à sa marge ; croisée peut perdre tout le compte.                                     |
|            | **Effet de levier maximal** | Commence à 5x : levier maximal à régler ou utiliser. Bots vérifiés au lancement et à leur modification par la clé. Visible avec Marge si perpétuels autorisés. |

Un ordre réduisant une position est toujours permis, quelles que soient les limites de position. La clé partage ses limites entre toutes ses apps et appareils.

Une clé Trader peut placer des ordres et lancer des bots sur les comptes et marchés que tu autorises, dans ses limites. Bybit prend en charge le spot, les futures USDT et USDC et les futures inverses ; Bybit EU, le spot uniquement. Sur Binance et Bybit, la clé peut régler le levier des futures dans **Effet de levier maximal** et changer le mode de marge dans **Marge** lorsque l'exchange le permet. Change le mode de marge d'un Bybit Unified Trading Account sur Bybit. Les trades sur Binance, Bybit et Bybit EU paient les frais de goodcryptoX avec des [crédits](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/supported-exchanges/trading-credits.md) ; les nouveaux ordres et bots ont besoin de crédits comme les tiens. Sur les marchés à marge en crypto, l'API et les outils MCP fournissent les tailles en contrats, avec la valeur du contrat à côté ; le panneau affiche les mêmes tailles en USD et en coin.

Dans ce guide, le volume d'ordres maximal sur 24h est 10,000 USD, dont 9,800 utilisés. Ajouter 400 ferait 10,200 : goodcryptoX refuse. Choisis tes limites, copie la clé et [connecte agent ou programme](#connect-any-mcp-app-or-program).

Traite la clé comme un mot de passe : son détenteur peut utiliser ses droits partout où l'installation est accessible.

* **Suspendre** bloque le trading et annule ses ordres en attente ouvrant ou augmentant une position. Ses bots passent en pause : entrées, moyennages ou ouvertures Grid annulés, aucun nouveau cycle. Positions et sorties restent, take profits et stop losses actifs. La lecture reste possible.
* **Reprendre** réautorise le trading et reprend ses bots en restaurant les ouvertures ou moyennages annulés par la pause. Les ordres isolés annulés le restent, sans nouvelle clé ni association. Vérifie marché et bot avant reprise.
* **Révoquer** coupe définitivement la clé, lecture comprise, avec mêmes pauses et annulations. Ses bots restent en pause jusqu'à ton arrêt. Crée une clé pour redonner accès. Une clé révoquée sans ordre, bot ni proposition est supprimée ; sinon elle reste sous **Révoquées** avec son historique. **Actives** liste celles utilisées.

### Ce qu'une clé de trading peut faire <a href="#what-a-trading-key-can-do" id="what-a-trading-key-can-do"></a>

Elle place ordres au marché, limite, stop et trailing avec take profit et stop loss sur ses comptes et marchés. Modifier ses ordres exige le respect des limites à la nouvelle valeur.

Elle annule les ordres hors bots sur ses comptes : tiens, autres clés, hors goodcryptoX et siens. Elle utilise les commandes permises sur ses bots ; tu peux annuler toi-même le reliquat d'un bot arrêté.

Elle peut vendre tes coins ou trader contre ta position dans ses limites. Vendre 0.1 ETH contre ton long de 1 ETH sur un compte à positions combinées laisse 0.9 ETH long. Sépare les trades sans lien sur un autre compte pour l'éviter.

### Ce que les limites ne bornent pas <a href="#what-the-limits-do-not-bound" id="what-the-limits-do-not-bound"></a>

Elles bornent l'exposition, pas la perte. Elles ne plafonnent pas les pertes sur plusieurs jours, n'empêchent ni mauvais timing ni déplacement ou annulation de son stop loss. Plusieurs clés sur un compte cumulent l'exposition.

Utilise un sous-compte séparé avec seulement les fonds à risquer. Cela sépare les fonds de l'agent du reste, sans rendre sa stratégie sûre.

### Ses bots <a href="#its-bots" id="its-bots"></a>

Un bot suit ses propres limites, jamais celles d'ordres : entrée, moyennages et grille sont son plan. **Max. par bot** est vérifié au lancement ou à la modification, puis à chaque début de cycle DCA. Au-delà, lancement refusé et aucun bot créé.

Le **Volume max. sur 24 h** des bots compte chaque cycle DCA au départ et l'investissement Grid au lancement et à chaque hausse. Trois bots DCA avec entrée de 500 USD et quatre moyennages de 300 USD font 1,700 USD par cycle. Sous 5,000 USD, les deux premiers partent ; le troisième est créé et attend, avec alerte Telegram. Il part seul quand le premier départ date de 24 heures. Les sorties existantes continuent.

Une requête de création qui omet `leverage` ou `marginMode` reprend ceux de la position ouverte, sinon marge isolée et 5x, comme l'indique la référence de l'API. Si l'exchange refuse le levier ou le mode de marge, la requête de création est refusée et aucun bot ne démarre.

La clé modifie seulement ses bots créés directement. Une fiche stratégie, exemple à la fin de [Propositions](#proposals), permet de préparer et vérifier un plan complet avant l'autorisation.

Une ancienne clé conserve l'ancienne règle jusqu'au nouvel enregistrement des limites : chaque ordre de bot respecte l'ordre maximal, chaque cycle consomme d'avance l'unique allocation de 24 heures partagée avec ses ordres.

### Quand une clé atteint une limite <a href="#when-a-key-meets-a-limit" id="when-a-key-meets-a-limit"></a>

Le Dashboard affiche **À sa limite**, Telegram nomme agent et limite. Ouvre la clé dans **Paramètres › MCP & API**, vérifie activité et utilisation. Réduis la requête, attends du quota ou change toi-même les limites ; l'agent ne peut pas les augmenter. Les baisser ne ferme pas l'exposition existante. Vérifie **Ordres → Ouverts**, **Positions** et **Bots** pour réduire ce qui tourne.

### Vérifier d'abord un ordre <a href="#checking-an-order-first" id="checking-an-order-first"></a>

Demande un aperçu avant placement : taille, prix, valeur et avertissements sans envoi. Les limites sont vérifiées au placement. L'aperçu vérifie le plan, sans approuver le trade.

L'aperçu d'un bot DCA contient, pour chaque côté, `liquidation.price` : le prix auquel l'exchange liquiderait la position à mesure que les ordres du bot sont exécutés. En marge croisée, c'est une estimation qui suppose que rien d'autre ne change dans le compte. `"0"` signifie qu'il n'y a pas de prix de liquidation (le compte couvre entièrement la position) ; `liquidation` vaut `null` quand l'exchange n'en donne pas pour la position (marge de portefeuille).

L'aperçu d'un bot DCA contient aussi `margin` : `survive` est ce dont le compte a besoin pour que le bot atteigne son stop loss, et `toLast` ce dont il a besoin pour exécuter son dernier moyennage, frais compris dans les deux cas et dans la devise de règlement du marché, comme les montre **Marge approx.** dans le formulaire. La taille de chaque ordre est arrondie au pas de l'exchange ; `margin.range`, `position.range` et `stop.range` donnent donc les bornes entre lesquelles le chiffre bouge avec le prix ; le chiffre de la page est ce qui serait envoyé maintenant. Ils sont absents quand les deux bornes sont identiques. L'aperçu d'une grille ne porte pas encore son besoin : un agent lit celui du DCA.

L’aperçu d’un bot Grid contient aussi `maxLoss`, la ligne **Perte max.** du formulaire : pour Stop en dessous et Stop au-dessus, le maximum que le grid peut perdre quand ce stop se déclenche, frais compris (`loss` en argent, `lossPct` un pourcentage de l’investissement (la valeur des ordres), tel que l'affiche le formulaire ; `by` dit si c’est le stop, un stop loss, le drawdown maximal ou une liquidation qui l’arrête en premier). `by: none` avec un `reason` veut dire qu’il n’y a pas de maximum, par exemple avec le suivi dans les deux sens. C’est une estimation au prix actuel ; voir [Perte max. à un stop](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/grid-bot/grid-setup.md#max-loss-at-a-stop).

Les ordres d'une clé de trading passent avec les avertissements du formulaire ; l'exchange peut toujours refuser. Demande une explication avant trading. Une clé Proposer laisse la décision entre tes mains.

## Propositions <a href="#proposals" id="proposals"></a>

Une proposition est un ordre ou bot préparé par une clé **Proposer** ou **Trader**. Elle attend ton lancement ou ton rejet ; rien ne trade avant et toi seul peux lancer.

Elle arrive dans Telegram avec **Ouvrir** après association d'un appareil, et attend en haut du Dashboard dans **À regarder**. Pour agir :

1. Appuie sur **Ouvrir** dans Telegram ou le Dashboard. Trading ouvre **Propositions**, où figurent toutes les propositions en attente.
2. Le formulaire contient la proposition et une note nommant l'agent. Modifie à ta guise.
3. Lance avec le bouton nommé dans la note ou appuie sur **Écarter**, aussi disponible sur le Dashboard.

Une proposition se lance une fois. Le résultat t'appartient, la clé ne le modifie pas. Passer la clé en **Lire** ou la révoquer supprime ses propositions en attente.

Un programme peut retirer sa proposition en attente avec `withdraw_proposal` ou [l'API](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/api.md#withdrawing-a-proposal). Elle quitte aussitôt liste et **À regarder** sans message ; sa fiche la marque retirée. Il ne peut retirer celle d'une autre clé ni une proposition lancée.

<details>

<summary>Exemple : d'une fiche stratégie à un bot DCA</summary>

Ici, un agent IA transforme une fiche décrivant les bots souhaités en bot DCA dans goodcryptoX.

1. **Choisis l'approbation.** Une clé **Proposer** te laisse vérifier et lancer chaque bot. **Trader** laisse l'agent créer dans tes comptes, marchés et limites. Commence par Proposer pour vérifier sa lecture.
2. **Connecte-le** avec [Connecter toute app MCP ou un programme](#connect-any-mcp-app-or-program). Si goodcryptoX est ailleurs, [Depuis un autre ordinateur](#from-another-computer) associe via relais ; un tunnel SSH convient aussi.
3. **Donne fiche et choix.** Commence par un profil : « Prépare ce profil ETH sur mon sous-compte de trading. Montre les réglages avant création. » Précise les profils ; plusieurs sur un marché cumulent l'exposition.
4. **Compare aperçu et fiche.** Demande l'aperçu de bot goodcryptoX. Vérifie entrée, chaque moyennage, investissement total, sorties et répétition. Avec Proposer, [ouvre la proposition](#proposals) et vérifie avant **Lancer**. Avec Trader, dis quand créer. La perte au stop de l'aperçu (`stop.loss`) inclut les frais : ceux de chaque ordre et celui du stop. La perte max. d'un bot DCA est `slMaxLossPct`, un pourcentage de son investissement. Un bot créé avant 3.2.1 peut contenir `slLossPct` à la place, un pourcentage de la marge : affiche-le comme `slLossPct ÷` la valeur `leverage` de la ligne, arrondi vers le bas à 0,01 (20 à 10x donne 2), et envoie `slMaxLossPct` pour le changer.
5. **Vérifie le résultat.** Ouvre **Bots** et les détails, puis l'activité de la clé dans **Paramètres › MCP & API**.

Voici un profil DCA ETH : entrée et quatre moyennages de 359.35 USDC chacun, cinq ordres totalisant 1,796.75 USDC par cycle. Take profit à 1.61% au-dessus de la moyenne. Cela ne garantit ni profit après tous frais ni exécution à la cible.

| Réglage de la fiche                                                      | À vérifier dans goodcryptoX                                                                                                         |
| ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| Signal d'achat, bougies de 15 minutes                                    | **Condition d'entrée : Signal** ; dans **Démarrer quand**, note TA Achat sur 15m ; Achat inclut Achat fort                          |
| Long, suivant le signal                                                  | **Mode entrée : Direct**                                                                                                            |
| Entrée au marché                                                         | **Type entrée : Marché**                                                                                                            |
| 359.35 USDC par ordre                                                    | **Taille entrée : 359,35**, en USDC                                                                                                 |
| Quatre moyennages égaux                                                  | **Ordres de moyennage : 4**, **1er ordre de moyennage : Manuel**, **Taille 1er moyennage : 359,35**, **Mult. taille moyennage : 1** |
| Premier écart 0.96% ; ensuite 1.1712%, multiplié par 1.22                | **Écart 1er moyennage : 0,96%**, **Écart prix moyennage : 1,1712%**, **Mult. écart moyennage : 1,22**                               |
| Active chaque moyennage quand le prix atteint le niveau prévu précédent. | **Sur l'exchange : Une par une**, **Post only** désactivé                                                                           |
| Take profit 1.61% depuis l'entrée moyenne                                | **Take profit** activé à 1.61%, **Type TP : Limite**, **Fixer TP en % du prix d'entrée** désactivé                                  |
| Stop 2.197609% sous le dernier moyennage prévu                           | **Stop loss** activé à 2.197609% ; **Stop loss exprimé en : Depuis dernier ordre moy., %**.                                         |
| Un cycle                                                                 | **Répéter après :** **TP** et **SL** désactivés                                                                                     |

Une virgule décimale désigne le même nombre : 0,96% devient 0.96%. Compare prix et montants de l'aperçu. Ici, les moyennages sont environ 0.960%, 2.120%, 3.519% et 5.200% sous l'entrée. Choisis levier et marge consciemment avant lancement.

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-4cbccfddbb1c69f7df536c890fcfea0d2d5ae3f0%2Fstrategy-sheet-form-entry.webp?alt=media" alt="Formulaire DCA rempli depuis la fiche stratégie, flèche sur Investissement" width="300"><figcaption></figcaption></figure>

<figure><img src="https://3693185778-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRRny6wdcxTQtpNhn4lG%2Fuploads%2Fgit-blob-3b40082342a80336ec091fb0a958283ca3968d15%2Fstrategy-sheet-form-exits.webp?alt=media" alt="Sorties et liste des ordres du même formulaire, flèche sur Total" width="300"><figcaption></figcaption></figure>

Demande de signaler les règles non prises en charge. Réglages d'indicateurs d'autres plateformes, perte modélisée, déplacement d'un stop au break-even ou durée depuis la première exécution peuvent ne pas avoir d'équivalent. L'agent doit expliquer l'écart avant trading.

Les [permissions](#keys-and-limits) décident de lire, proposer ou trader ; ni retrait ni hausse de quota. En lancement direct **Trader**, les [limites de bots](#its-bots) couvrent tout l'argent : 1,796.75 USDC par cycle dépasse **Max. par bot** de 1,000 USD ; aucun bot créé. Modifie toi-même profil ou limite. Une proposition reste possible pour ta vérification et ton lancement.

</details>

## Questions fréquentes <a href="#questions" id="questions"></a>

### Claude peut-il trader pour moi ? <a href="#can-claude-place-trades-for-me" id="can-claude-place-trades-for-me"></a>

Oui, avec **Trader** : lecture, placement et annulation d'ordres et ses propres bots dans tes comptes, marchés et limites. Avec **Proposer**, rien ne trade sans toi.

### goodcryptoX a-t-il un serveur MCP ? <a href="#does-goodcryptox-have-an-mcp-server" id="does-goodcryptox-have-an-mcp-server"></a>

Oui : il relie Claude Desktop, Claude Code, Codex, Cursor et autres apps à ton installation avec une clé de **Paramètres › MCP & API**. Aucun serveur MCP public chez nous auquel te connecter.

### Ma clé ou mes trades passent-ils par les serveurs goodcryptoX ? <a href="#does-my-key-or-my-trading-go-through-goodcryptoxs-servers" id="does-my-key-or-my-trading-go-through-goodcryptoxs-servers"></a>

Seulement depuis un autre appareil, via le relais incapable de lire clé, requêtes et réponses. Un [tunnel SSH](#use-an-ssh-tunnel-instead) l'évite.

### L'agent peut-il retirer des fonds ? <a href="#can-the-agent-withdraw-funds" id="can-the-agent-withdraw-funds"></a>

Non : aucune clé ne retire ou transfère de fonds, ne modifie tes réglages ni ne crée une clé.

### Quelles apps fonctionnent : Claude, Codex, Cursor, autres ? <a href="#which-apps-work-claude-codex-cursor-others" id="which-apps-work-claude-codex-cursor-others"></a>

Claude Desktop, Claude Code, Codex et Cursor ont chacun leur ligne dans **Paramètres › MCP & API**, sans rien remplir. Toute app lançant MCP via entrée/sortie standard prend la même entrée.

### Y a-t-il une API ? <a href="#is-there-an-api" id="is-there-an-api"></a>

Oui : ton programme lit et trade via l'API goodcryptoX avec les mêmes clés, permissions et limites qu'un agent IA ([API](https://docs.goodcrypto.app/goodcryptox-fr/goodcryptox-3.0/api.md)).
