Compétence Agent KryptoGO Meme Trader

AVIS D'ARRÊT — Backend d'analyse kg-xyz

Le backend d'analyse KryptoGO XYZ (wallet-data.kryptogo.app) sera arrêté le 2026-05-04.

Après cette date, tous les outils qui dépendent de l'analyse de clusters, des étiquettes de portefeuille, des tableaux de bord de signaux et de la reconstruction d'ordres DCA/limit ne fonctionneront plus. Le chemin d'exécution des swaps (agrégateur DEX OKX + signature locale de transaction) est indépendant du backend kg-xyz et continuera de fonctionner.

L'impact par outil est annoté en ligne ci-dessous. Les scripts et implémentations d'outils MCP ont été conservés pour qu'ils échouent gracieusement (le backend renverra des erreurs HTTP) et qu'un retour en arrière reste simple si les plans changent.

Aperçu

Cette compétence permet à un agent IA d'analyser et trader des meme coins via la plateforme KryptoGO, combinant une analyse approfondie des clusters on-chain avec l'exécution d'ordres.

Fonctionnalité dégradée à partir du 2026-05-04 : l'analyse de clusters, les étiquettes de portefeuille/token, le tableau de bord de signaux, la reconstruction d'ordres DCA/limit et l'enrichissement P&L du portefeuille cesseront de fonctionner lorsque le backend kg-xyz sera arrêté. L'exécution des swaps continue.

Analyse (multi-chaînes : Solana, BSC, Base, Monad) : clustering de portefeuilles, détection d'accumulation/distribution, étiquettes de comportement d'adresses, signaux d'accumulation à l'échelle du réseau (niveau Pro/Alpha).

Trading (Solana uniquement) : surveillance de portefeuille avec suivi PnL, exécution de swaps via agrégateur DEX, signature locale de transaction (la clé privée ne quitte jamais la machine).

Le mode par défaut est supervisé — tous les trades nécessitent une confirmation de l'utilisateur. Le trading autonome est disponible en opt-in. Voir references/autonomous-trading.md pour le mode autonome, la configuration cron et les détails du système d'apprentissage.

Quand l'utiliser

L'utilisateur demande d'analyser un meme coin ou token sur Solana/BSC/Base/Monad
L'utilisateur demande de trader, acheter ou vendre des tokens
L'utilisateur demande de rechercher des tokens tendance ou des opportunités de marché
L'utilisateur demande de surveiller les positions du portefeuille ou de vérifier le PnL
Surveillance périodique du portefeuille et analyse des signaux déclenchée par cron

Quand NE PAS l'utiliser

Analyse macro de BTC/ETH/L1 majeurs, NFT, ponts inter-chaînes, transactions non-DEX, trading hors Solana

Flux de configuration

1. Obtenir une clé API

Allez sur kryptogo.xyz/account et créez une clé API

Ajoutez à ~/.openclaw/workspace/.env :

echo 'KRYPTOGO_API_KEY=sk_live_VOTRE_CLÉ' >> ~/.openclaw/workspace/.env && chmod 600 ~/.openclaw/workspace/.env

Ne collez PAS votre clé API directement dans le chat. Définissez toujours les secrets via le fichier .env.

2. Générer un portefeuille agent

python3 scripts/setup.py

Crée une paire de clés Solana, la sauvegarde dans .env avec chmod 600, affiche l'adresse publique à approvisionner.

3. Approvisionner le portefeuille

Envoyez SOL à l'adresse publique de l'agent (minimum 0,1 SOL).

Règles de sécurité

NE JAMAIS imprimer, journaliser ou inclure des clés privées dans un message ou un argument CLI
NE JAMAIS accepter des secrets collés directement dans le chat — demandez aux utilisateurs de les définir dans .env
NE JAMAIS utiliser l'outil Read sur .env — chargez les identifiants via la commande source uniquement
Les scripts d'exécution ne lisent PAS .env directement — tous les identifiants sont accessibles uniquement via des variables d'environnement, qui doivent être préchargées par l'appelant (source ~/.openclaw/workspace/.env)
Exception : scripts/setup.py lit et écrit .env pour la génération initiale de la paire de clés et la réparation d'adresse — c'est le seul script qui touche aux fichiers d'identifiants
La clé privée reste en mémoire uniquement pendant la signature locale — jamais envoyée à un serveur

Authentification

Tous les points de terminaison nécessitent : Authorization: Bearer sk_live_<48 caractères hex>

Niveau	Appels API quotidiens	Frais de trading	Tableau de bord de signaux	KOL Finder
Gratuit	100 appels/jour	1%	Non	Non
Pro	1 000 appels/jour	0,5%	Oui	Oui
Alpha	5 000 appels/jour	0%	Oui	Oui

Comportement de l'agent

Initialisation de session

À chaque début de session (y compris heartbeat/cron), l'agent DOIT charger les identifiants AVANT d'exécuter des scripts :

source ~/.openclaw/workspace/.env

Ceci est OBLIGATOIRE — les scripts ne lisent pas .env directement. Tous les identifiants sont accessibles uniquement via des variables d'environnement.

Mode par défaut : supervisé

Par défaut, l'agent fonctionne en mode supervisé : il analyse les tokens, présente des recommandations et attend l'approbation de l'utilisateur avant d'exécuter un trade. Les conditions de stop-loss/take-profit sont signalées à l'utilisateur mais pas exécutées automatiquement.

Pour activer le trading autonome, définissez require_trade_confirmation: false dans les préférences. Voir references/autonomous-trading.md pour tous les détails.

Persistance (CRITIQUE)

IMMÉDIATEMENT après avoir soumis une transaction, l'agent DOIT :

Écrire les détails du trade dans memory/trading-journal.json avec status: "OPEN"
Inclure : token_symbol, token_address, entry_price, position_size_sol, tx_hash, timestamp

Préférences utilisateur

Stockez dans memory/trading-preferences.json :

Préférence	Valeur par défaut	Description
`max_position_size`	0,1 SOL	SOL max par trade
`max_open_positions`	5	Max de positions ouvertes simultanées
`max_daily_trades`	20	Max de trades par jour
`stop_loss_pct`	30%	Notifier/vendre quand la perte dépasse ce seuil
`take_profit_pct`	100%	Notifier/vendre quand le gain dépasse ce seuil
`min_market_cap`	500 000 $	Ignorer les tokens en dessous de ce seuil
`scan_count`	10	Tokens tendance par analyse
`risk_tolerance`	"conservative"	"conservative" (ignorer le risque moyen), "moderate" (demander pour le risque moyen), "aggressive" (trade automatique pour le risque moyen)
`require_trade_confirmation`	true	Mettre à false pour le mode autonome
`chains`	["solana"]	Chaînes à analyser

Garde-fous de sécurité

Limites de trading (plafonds durs)

Limite	Par défaut	Modifiable ?
Trade unique max	0,1 SOL	Oui, via `max_position_size`
Positions simultanées max	5	Oui, via `max_open_positions`
Nombre de trades quotidien max	20	Oui, via `max_daily_trades`
Abandon d'impact sur le prix	>10%	Non — toujours abandonner
Avertissement d'impact sur le prix	>5%	Non — toujours avertir

Si une limite est atteinte, l'agent doit s'arrêter et notifier l'utilisateur.

Isolation des identifiants

Les scripts d'exécution de cette compétence ne lisent PAS les fichiers .env directement. Tous les identifiants sont accessibles uniquement via des variables d'environnement, qui doivent être préchargées par l'appelant (source ~/.openclaw/workspace/.env). Cela garantit qu'aucun script d'exécution ne peut accéder ou exfiltrer indépendamment les fichiers d'identifiants.

Exception : scripts/setup.py lit et écrit .env — il charge les clés existantes pour éviter la régénération, sauvegarde .env avant les modifications et écrit les nouvelles entrées de paires de clés. C'est le seul script qui touche aux fichiers d'identifiants, et il s'exécute uniquement lors de la configuration initiale ou de la régénération explicite --force.

Surveillance automatisée (Cron)

Configuration rapide

# Mode supervisé (par défaut) : analyse + notifications, pas d'exécution automatique
source ~/.openclaw/workspace/.env && bash scripts/cron-examples.sh setup-default

# Mode autonome (opt-in) : achats et ventes automatiques
source ~/.openclaw/workspace/.env && bash scripts/cron-examples.sh setup-autonomous

# Supprimer tous les jobs cron
bash scripts/cron-examples.sh teardown

Job	Intervalle	Comportement par défaut
`stop-loss-tp`	5 min	Signaler les conditions déclenchées, NE PAS vendre automatiquement
`discovery-scan`	1 heure	Analyser et envoyer des recommandations, NE PAS acheter automatiquement

Pour la configuration cron complète, la configuration manuelle, l'alternative heartbeat et les détails du flux de travail de surveillance, voir references/autonomous-trading.md.

Cadre d'analyse on-chain (Pipeline en 7 étapes)

⚠️ Indisponible après le 2026-05-04 : Les étapes 1 à 6 frappent toutes wallet-data.kryptogo.app et cesseront de fonctionner lorsque le backend kg-xyz sera arrêté. L'étape 7 (exécuter un trade via swap.py) continue de fonctionner, car le chemin d'échange passe par l'agrégateur DEX OKX et signe localement.

Étape 1 : Aperçu du token et filtre de capitalisation boursière

/token-overview?address=<mint>&chain_id=<id> — obtenir le nom, le prix, la capitalisation boursière, les détenteurs, le niveau de risque. Ignorer si la capitalisation boursière < min_market_cap.

Étape 2 : Analyse de clusters

/analyze/<mint>?chain_id=<id> — clusters de portefeuilles, principaux détenteurs, métadonnées.

≥30-35% = "contrôlé" — entité majeure présente
≥50% = risque de concentration élevé
Cluster unique >50% → ignorer (risque de rug pull)

Limitation du niveau gratuit : L'analyse de clusters ne renvoie que les 2 premiers clusters. Pour voir les données de cluster complètes, passez à un niveau supérieur sur kryptogo.xyz/pricing.

Étape 3 : Tendance du cluster (Multi-période)

/analyze-cluster-change/<mint> — cluster_ratio + changes sur 15m/1h/4h/1j/7j.

Insight clé : Le prix et les avoirs du cluster DIVERGENT est le signal clé.

Prix en hausse + % du cluster en baisse = distribution (baissier)
Prix en baisse + % du cluster en hausse = accumulation (haussier)

Étape 4 : Étiquettes d'adresses + Vérification de la pression de vente

/token-wallet-labels → identifier les portefeuilles dev/sniper/bundle
/balance-history pour chaque adresse risquée → vérifier si elle détient toujours
Calculer risky_ratio = avoirs risqués actifs / total des avoirs du cluster
30% = risque élevé, 10-30% = moyen, <10% = faible

Les étiquettes représentent l'historique comportemental, pas les avoirs actuels. Vérifiez toujours via /balance-history.

Étape 5 : Analyse approfondie (Optionnelle)

/balance-history, /balance-increase/<mint>, /top-holders-snapshot/<mint>, /analyze-dca-limit-orders/<mint>, /cluster-wallet-connections

Étape 6 : Décision

Appliquez la liste de vérification haussière de references/decision-framework.md.

Étape 7 : Exécuter le trade

Utilisez scripts/swap.py pour l'exécution — il gère l'injection de l'adresse du portefeuille, la vérification des erreurs et la journalisation.

✓ Continue de fonctionner après le 2026-05-04 : l'exécution des swaps passe par l'agrégateur DEX OKX avec signature locale et est indépendante du backend kg-xyz.

source ~/.openclaw/workspace/.env && python3 scripts/swap.py <token_mint> 0.1
source ~/.openclaw/workspace/.env && python3 scripts/swap.py <token_mint> <amount> --sell

Référence rapide de l'API

⚠️ Après le 2026-05-04 : Chaque point de terminaison ci-dessous est servi par wallet-data.kryptogo.app et sera arrêté. L'outil de swap (swap_tokens / scripts/swap.py) contourne ces points de terminaison et route directement vers l'agrégateur DEX OKX, il continue donc de fonctionner.

Point de terminaison	Méthode	Objectif	Après le 2026-05-04
`/agent/account`	GET	Vérifier le niveau et le quota	⚠️ Indisponible
`/agent/trending-tokens`	GET	Analyser les tokens tendance	⚠️ Indisponible
`/agent/portfolio`	GET	Portefeuille + PnL	⚠️ Indisponible (enrichissement P&L) ; les soldes peuvent encore être récupérés via Solana RPC
`/agent/swap`	POST	Construire une tx de swap non signée (Solana uniquement)	⚠️ Indisponible (le swap passe maintenant par OKX DEX ; voir `scripts/swap.py`)
`/agent/submit`	POST	Soumettre une tx signée (Solana uniquement)	⚠️ Indisponible (soumettre directement au RPC Solana à la place)
`/token-overview`	GET	Métadonnées du token et données de marché	⚠️ Indisponible
`/analyze/:token_mint`	GET	Analyse complète des clusters	⚠️ Indisponible
`/analyze-cluster-change/:token_mint`	GET	Tendances du ratio de cluster	⚠️ Indisponible
`/balance-history`	POST	Données de solde chronologiques	⚠️ Indisponible
`/wallet-labels`	POST	Étiquettes comportementales	⚠️ Indisponible
`/token-wallet-labels`	POST	Étiquettes spécifiques au token	⚠️ Indisponible
`/signal-dashboard`	GET	Signaux d'accumulation organisés (Pro+)	⚠️ Indisponible

Détails complets requête/réponse : voir references/api-reference.md

Prise en charge multi-chaînes

Chaîne	chain_id	Analyse	Trading
Solana	`501`	Oui	Oui
BSC	`56`	Oui	Non
Base	`8453`	Oui	Non
Monad	`143`	Oui	Non

Gestion des erreurs

Code	Signification	Action
400	Requête incorrecte	Vérifier les paramètres
401	Non autorisé	Vérifier la clé API
402	Quota dépassé	Attendre la réinitialisation quotidienne ou passer à un niveau supérieur
403	Interdit	Nécessite un niveau supérieur
502/504	Erreur serveur	Réessayer une fois après 10s

Scripts opérationnels

Tous les scripts nécessitent que les identifiants soient préchargés : source ~/.openclaw/workspace/.env avant l'exécution.

Post-arrêt (2026-05-04) : portfolio.sh, trending.sh, analysis.sh et test-api.sh appellent tous le backend kg-xyz et commenceront à renvoyer des erreurs HTTP. swap.py continue de fonctionner car il utilise l'agrégateur DEX OKX et signe localement. Les scripts sont conservés pour que la compétence échoue gracieusement et qu'un retour en arrière reste trivial si le backend revient.

source ~/.openclaw/workspace/.env && bash scripts/portfolio.sh              # Vérification du portefeuille        (⚠️ ne fonctionne plus après le 2026-05-04)
source ~/.openclaw/workspace/.env && bash scripts/trending.sh               # Tokens tendance        (⚠️ ne fonctionne plus après le 2026-05-04)
source ~/.openclaw/workspace/.env && bash scripts/analysis.sh               # Tableau de bord d'analyse complet (⚠️ ne fonctionne plus après le 2026-05-04)
source ~/.openclaw/workspace/.env && python3 scripts/swap.py <mint> 0.1     # Achat                     (✓ continue de fonctionner)
source ~/.openclaw/workspace/.env && python3 scripts/swap.py <mint> <amt> --sell  # Vente              (✓ continue de fonctionner)
source ~/.openclaw/workspace/.env && bash scripts/test-api.sh               # Test de connectivité API   (⚠️ ne fonctionne plus après le 2026-05-04)

Apprentissage et adaptation

L'agent s'améliore au fil du temps en enregistrant les trades, en analysant les résultats et en ajustant la stratégie. Chaque trade est journalisé dans memory/trading-journal.json, les pertes déclenchent des analyses post-mortem, et des examens périodiques proposent des modifications de paramètres.

Pour tous les détails sur le système d'apprentissage, le format du journal de trades, le processus post-mortem et les revues de stratégie, voir references/autonomous-trading.md.

Concepts clés

Concept	Insight clé
Cluster	Groupe de portefeuilles contrôlés par la même entité
Ratio de cluster	Pourcentage de l'offre totale détenu par les clusters identifiés
Distribution	Prix en hausse, % du cluster en baisse — les initiés vendent
Accumulation	Prix en baisse, % du cluster en hausse — les initiés achètent
Ratio risqué	Part des avoirs du cluster détenue par des portefeuilles à comportement risqué
Impact sur le prix	Glissement estimé de l'exécution du swap — si >10%, abandonner automatiquement

Références

references/api-reference.md — Documentation complète de l'API (points de terminaison, payloads, exemples de réponses)
references/decision-framework.md — Liste de vérification d'analyse haussière/baissière et règles de décision
references/autonomous-trading.md — Mode autonome, configuration cron, système d'apprentissage, analyses post-mortem

Demander à votre IA préférée

Documentation