§ 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. 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
licence
MIT · open source
stratégies
grille · tendance, commutables par exécution
mode par défaut
papier — prix réels, sans clés
bourse
Binance
IA
serveur MCP · routine d'agent horaire
§ 01 / stratégies

Deux moteurs, une exécution.

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 et allocation par niveau configurables. 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.

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 sur un stop suiveur à cliquet dimensionné par la volatilité ; un délai avant réentrée. Chaque tranche d'entrée est dimensionnée et revue pour le risque individuellement.

03/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 / 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.

  • vos clés
  • verrouillé
§ 03 / garde-fous

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 des tranches dans un seul budget. Le surengagement est refusé à l'enregistrement, et bloque les entrées au démon s'il passe entre les mailles. Un arrêt de perte maximale au niveau du portefeuille tue toutes les exécutions quand l'équité franchit le plancher.
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.
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 walk-forward sur l'historique de chandeliers collecté — espacement, largeur, politique de déploiement, paramètres de tendance — valident un réglage avant qu'on lui confie une exécution réelle. Les garde-fous qui en découlent sont intégrés à chaque proposition de réajustement.
alertes
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 par cycle pour qu'une rafale soit un message, pas dix.
§ 04 / 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 est pilotable par un agent IA via le Model Context Protocol, au nom d'un utilisateur connecté : état, signal de marché, aperçu et réglage de la grille, démarrage, arrêt, arrêt d'urgence, rapport de P/L, backtest, journal de décisions.

  • gtbot_status
  • gtbot_set_grid
  • gtbot_pnl_report
  • +11
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 contre ce que le marché a réellement fait. L'agent relit 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
§ 05 / dans la boîte

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

01

Dashboard

Graphiques par exécution — transactions, historique des prix, ligne de tendance, bande de grille, marqueurs de cycle de vie — avoirs, tuile du portefeuille partagé, démarrer / pause / recharger par exécution.

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 le portent : une vraie répétition se distingue d'un double envoi.

04

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.

05

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.

06

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.

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.