§ 00 / produits / apigtbot

apigtbot. Un bot de trading qui montre son travail.

Deux stratégies — une grille achat-bas-vente-haut et un suiveur de tendance sur cassure — qui tournent en démons permanents sur des données de marché en direct, chaque exécution, réajustement et arrêt d'urgence consigné dans un journal lisible. Un seul portefeuille partagé les finance toutes, le capital va là où se trouve l'occasion, et chaque décision est notée selon ce qui s'est réellement passé. Mode papier par défaut : prix réels, exécutions simulées, aucune clé de bourse. Les plafonds de risque sont appliqués par le serveur, pas par la stratégie, et un agent IA peut régler la grille chaque heure — sans jamais toucher aux plafonds.

c'est quoi
plateforme auto-hébergée de bot de trading crypto
état
trading papier · argent réel derrière une porte de mise en service
licence
MIT · open source
plateforme
auto-hébergé PHP 8.4 · Binance
construit avec
GoatCheese
stratégies
grille · tendance · noyau optionnel, par symbole
mode par défaut
papier — prix réels, sans clés
IA
serveur MCP · routine d'agent horaire
§ 01 / stratégies

Deux moteurs, une exécution, un interrupteur.

Les marchés oscillent et les marchés tendent ; un bot qui ne connaît qu'un des deux a tort la moitié du temps. Les deux moteurs partagent la même interface : une exécution peut changer d'avis sans changer de portefeuille.

01/grille

Grille — retour à la moyenne

Une échelle de niveaux d'achat et de vente sur une plage de prix : espacement géométrique ou arithmétique, niveaux configurables et allocation par niveau. Achète les creux, vend les rebonds, se réancre quand la géométrie change et n'abandonne jamais l'inventaire lors d'un réajustement. La géométrie est fixée par l'agent ou tourne en mode mécanique : une bande fixe de ±x %, recentrée par minuterie.

02/tendance

Tendance — suiveur de cassure

Entrées à l'achat seulement quand le prix clôture au-dessus du récent sommet avec la moyenne rapide au-dessus de la lente ; sorties par un stop suiveur à cliquet dimensionné selon la volatilité, avec un plancher strict. L'activation du régime est mise à l'échelle par machine à partir de l'ADX et du ratio d'efficacité 4h et 1j, avec hystérésis pour qu'il ne clignote pas : le bras déploie toute sa tranche quand le régime passe à la hausse et sort proprement quand il s'essouffle.

03/noyau

Noyau — inventaire optionnel

Une position de noyau à croisement d'EMA 1j, bâtie par tranches échelonnées, achetée sur un repli ou après un délai — le livre long à côté du livre de transactions, pour qu'une grille ne vende jamais le dernier de ce que vous vouliez garder.

04/bascule

Une bascule par exécution

Basculez une exécution en cours entre grille et tendance depuis le tableau de bord. Le démon redémarre et passe le relais proprement : entrées ouvertes annulées avec les exécutions partielles comptabilisées, sorties en cours conservées comme ordres hérités, positions non protégées reprises au coût.

§ 02 / le capital suit l'occasion

Un portefeuille. Le capital va là où se passe le mouvement.

Un budget épinglé à un symbole reste inactif pendant que le mouvement se produit ailleurs. Ici, chaque exécution puise dans un portefeuille partagé, et un allocateur déplace les tranches — dans des limites qu'il s'impose lui-même.

01/bras

Des bras par symbole

Aucune répartition de budget fixe. Chaque symbole déclare ses bras grille et tendance ; un bras tendance est financé quand son régime passe à la hausse et libéré quand il s'essouffle.

02/allocateur

Un allocateur aux 15 minutes

Rééquilibre le bassin vers là où se trouve l'occasion, et garde une réserve qu'il refuse de dépenser — gtbot_pool_reserve_pct est une marge que les allocateurs ne peuvent pas toucher.

03/invariant

Jamais de surengagement

L'invariant du budget partagé est appliqué en trois couches — à l'enregistrement, dans l'allocateur et dans le démon — de sorte qu'un raté dans l'une est attrapé par la suivante.

04/cycle de vie

Cycle de vie d'une exécution

Retirez et purgez les exécutions terminées, scellez un portefeuille, ou laissez le plafond suivre la valeur du compte en mode « utiliser tous les fonds ». Un seul portefeuille, ensemencé multi-actifs, finance tout.

05/pourquoi

Il vous dit pourquoi

Un bras inactif en nomme la cause. Une grille silencieuse déclenche une alerte. Un bras où rien ne tourne doit s'expliquer au chien de garde, sinon il vous appelle.

06/conserver

Jamais de vente de panique

Par défaut, une position n'est jamais vendue sous le coût à moins que l'échelle n'ait plus rien à échanger. Liquider est une décision, pas un réflexe.

§ 03 / modes de trading

Le papier d'abord. L'argent réel s'active volontairement, deux fois.

01/papier

Papier — par défaut

Données de marché en direct, exécutions simulées localement, soldes dans un portefeuille simulé. Aucun compte de bourse, aucune clé. Chaque stratégie, graphique, alerte et garde-fou se comporte exactement comme avec de l'argent en jeu.

  • sans clés
  • prix réels
02/testnet

Réel — testnet

Les ordres partent vers le bac à sable de la bourse avec des clés testnet. Même chemin de code que le réel : ce que vous voyez ici est ce que vous obtiendrez là.

  • clés bac à sable
03/en ligne

Réel — en direct

Ordres sur le réseau principal avec vos propres clés. Verrouillé à dessein : l'interrupteur de l'exécution et les drapeaux d'environnement du serveur doivent tous concorder ; une incohérence est refusée au démarrage, et le démon s'arrête net sans identifiants. La porte de mise en service (gtbot-golive) lit les registres et ne passe que si toutes les vérifications passent ; l'audit du compte (gtbot-audit) vérifie que le compte de bourse réel les appuie, et une constatation ne vous appelle que si elle survit à deux audits consécutifs.

  • vos clés
  • verrouillé
§ 04 / garde-fous de risque

La stratégie propose. Les garde-fous décident.

Un bot n'est jamais plus sûr que ce qui peut lui dire non. Chaque garde-fou ci-dessous s'applique à l'identique en mode papier, testnet et réel.

profils de risque
Un seul menu — NoLoss, Cautious, Balanced, Aggressive, Max — pilote chaque plafond comme un ratio vivant du budget de l'exécution : limite de perte journalière, arrêt sur perte latente, plafonds de position et d'ordres, politique de cassure, multiplicateurs de stop suiveur. NoLoss refuse structurellement tout chemin qui réalise une perte.
portefeuille partagé
Toutes les exécutions puisent leurs tranches dans un seul bassin de budget. Un surengagement est refusé à l'enregistrement, et bloque les entrées au démon s'il passe quand même. Un plancher de retrait au niveau du portefeuille arrête toutes les exécutions quand l'avoir passe dessous et y reste pendant trois cycles.
vendre à perte
Un interrupteur par exécution, désactivé par défaut. Tant qu'il est éteint, le bot garde l'inventaire plutôt que de réaliser une perte — un choix délibéré, pas un oubli. sell_when_starved ne vend sous le coût que lorsque l'échelle n'a plus rien à échanger, et Flatten prend les offres et poursuit le prix jusqu'à ce que la position soit à zéro.
côté serveur
Les plafonds vivent hors de la stratégie et hors de l'agent. Un bogue de stratégie ou une proposition d'IA trop zélée ne peut ni relever une limite, ni effacer un arrêt d'urgence, ni liquider une position.
preuves
Des balayages par marche avant sur l'historique de chandeliers recueilli — espacement, largeur, politique de déploiement, paramètres de tendance — valident un réglage avant qu'on lui confie une exécution réelle. Seize sections de preuves de réajustement et ça continue ; les idées que les données ont réfutées restent réfutées et sont consignées comme telles. Les garde-fous qui en découlent sont calculés dans chaque proposition de réajustement.
alertes
Les arrêts d'urgence, blocages sur cassure, arrêts de perte et inventaire orphelin arrivent sur votre téléphone immédiatement ; les cycles clos dès qu'ils sont comptabilisés, avec le P/L réalisé ; les exécutions courantes regroupées en résumés pour qu'une rafale soit un message, pas dix. Une alerte d'arrêt n'est jamais retenue par la limitation.
§ 05 / un agent dans la boucle

Réglé par une IA. Borné par le serveur.

La géométrie d'une grille est fastidieuse à régler à la main, et les marchés bougent. Alors un assistant comme Claude s'en charge à heure fixe — dans des limites qu'il ne peut pas changer, avec un tableau de scores auquel il ne peut pas échapper.

01/mcp

Serveur MCP

Tout le système peut être piloté par un agent IA via le Model Context Protocol, comme un utilisateur connecté : état, résumé horaire de routine, aperçu et réglage de la grille, propositions de réajustement, marché et backtest, rapport de P/L, décisions et événements, budget et mode d'allocation, création, démarrage, arrêt, arrêt d'urgence, retrait et purge d'une exécution.

  • gtbot_routine_brief
  • gtbot_refit_proposal
  • gtbot_alloc_mode
  • +15
02/routine

Routine horaire de réajustement

Une fois par heure, un agent prend un seul résumé compact de chaque exécution — digest du signal, régime et seuils, grille candidate, historique, un bit « changement significatif » — et réajuste plage, niveaux et déploiement des exécutions signalées, en réallouant des tranches de budget là où c'est utile.

  • gtbot_routine_brief
  • 1 lecture / heure
03/noté

Des décisions qui sont notées

Chaque décision de l'agent est consignée avec son raisonnement, puis notée par le serveur selon ce que le marché a réellement fait : chaque décision enregistre ses plafonnements et son écart candidat, et reçoit un verdict contrefactuel calculé à partir de l'OHLC intra-barre. L'agent lit son propre historique dans le résumé suivant et en tire des leçons.

  • gtbot_decisions
  • noté
04/garde-fous

Consultatif, avec garde-fous

L'agent peut réajuster la géométrie et déplacer des tranches. Il ne peut ni relever un plafond de risque, ni effacer un arrêt d'urgence, ni liquider l'inventaire — cela reste humain. Une tâche « homme mort » prend le relais avec des réajustements par quantiles si la routine se tait deux heures.

  • plafonds intouchables
  • homme mort
§ 06 / dans la boîte

Conçu pour être exploité, pas seulement lancé.

01

Tableau de bord

Des graphiques par exécution — transactions, historique des prix, ligne de tendance, bande de grille, repères du cycle de vie — les avoirs, la tuile du portefeuille partagé avec éditeur de budget en ligne, retenir / libérer des fonds, démarrer / pause / recharger par exécution. Un registre de VNI du portefeuille et un rapport de P&L comparé au HODL et à l'USDT.

02

Démons permanents

Un processus par exécution active, maintenu par un chien de garde ; données de marché collectées toutes les dix minutes ; une sauvegarde nocturne. Ni root ni gestionnaire de services requis.

03

Journal de décisions

Chaque exécution, réajustement, bascule, blocage et arrêt d'urgence est un événement avec un identifiant. Les alertes portent l'identifiant : une vraie répétition se distingue d'un double envoi. Les épisodes de régime et le suivi d'engagement montrent combien de temps chaque bras était admissible et pendant combien de ce temps il travaillait réellement. Les exécutions sont comptabilisées au prix auquel elles ont eu lieu.

04

Perspective de marché

Un détecteur de régime à long horizon 1j / 1s, avec hystérésis et résultats notés à 7 et 30 jours, avec un résumé Telegram quotidien optionnel. Un détecteur, pas un prédicteur : la version prédictive a été testée et réfutée.

05

Backtests et balayages

Testez une grille ou un réglage de tendance candidat depuis le tableau de bord ou l'agent ; scripts de balayage walk-forward pour les paramètres qui comptent.

06

API REST

Exécutions, ordres, événements, données de marché et portefeuille comme points d'accès documentés avec contrôle des rôles et journal d'audit — la même surface qu'utilisent le tableau de bord et le serveur MCP.

07

Mise en service réelle et audit

gtbot-golive lit les registres et ne sort avec le code 0 que si toutes les vérifications passent ; gtbot-audit vérifie que le compte de bourse réel les appuie. La réserve de frais en BNB est gérée, et les interrupteurs de bourse appartiennent à l'hôte, donc un déploiement ne les pousse jamais.

08

Manuel d'exploitation

Passage en réel, reprise après incident, alertes, le prompt et la conception de la routine d'agent, les preuves derrière les garde-fous — écrits, dans le dépôt.

Construit sur GoatCheese : l'administration, l'API et le serveur MCP sont générés à partir du modèle de données ; les moteurs de stratégie et les démons sont la partie sur mesure.

§ articles

Notes de l'atelier.

Ce qui a réellement fonctionné, ce que ça a coûté et où ça a cassé — écrit pendant que les détails sont encore frais.

01 /security ·

Un agent IA de bureau avec vos clés prend ses ordres d’inconnus

Un courriel, un document partagé, un formulaire sur votre site, un ticket de soutien. Le tour reste une phrase dans quelque chose que l’assistant allait lire. Ce qui a changé, c’est tout ce que vous lui aviez déjà ouvert.

#sécurité#ia#chatbot#mcp#logiciel sur mesure lire_
02 /ai ·

Mise à jour : l'agent IA local est maintenant une application de courriel. Le courriel reste sur la machine.

Le moteur de tri est maintenant une application de courriel pour le web, iPhone et Android : une seule boîte pour tous les comptes, le courriel classé par client et par mandat, des brouillons par l'IA, des dates tirées d'une photo. Le courriel est lu sur la machine. Le contrôle a écarté deux versions des instructions en chemin et en a laissé passer une troisième.

#ia#ia locale#automatisation#tests#confidentialité lire_
03 /security ·

Votre IA lit vos conversations. Puis elle appelle la police.

Claude et ChatGPT s'entraînent par défaut sur les conversations grand public. Des chercheurs ont ressorti des données d'entraînement d'un modèle en service pour quelques centaines de dollars. Le bouton de partage de Claude a mis des notes médicales et des numéros de téléphone d'enfants sur Google. La Loi 25 appelle ce collage une communication de renseignements personnels à l'extérieur du Québec.

#confidentialité#ia locale#ia#sécurité lire_

Tous les articles_

§ 07 / prochaine étape

Faites-le tourner vous-même, ou faites-en construire un.

Clonez-le, lancez l'installateur, créez une exécution papier et regardez-le travailler. Vous voulez votre propre stratégie, une autre bourse, ou une routine d'agent réglée sur vos règles ? Envoyez un brief.

Logiciel expérimental pour la recherche et le trading papier. Rien ici n'est un conseil financier ; si vous connectez des fonds réels, vous le faites à vos risques.