Lancer un agent IA DeFi avec AgentKit de Coinbase : guide 2026
Points clés
- AgentKit est le toolkit open source de Coinbase pour donner un wallet crypto à un agent IA.
- L’agent peut surveiller les rendements DeFi, exécuter des swaps et rééquilibrer un portefeuille 24h/24.
- Le setup prend 15 à 30 minutes avec Node.js et une clé API Coinbase Developer Platform.
- L’agent opère sur Base (L2 Coinbase), avec extension possible à Ethereum mainnet et Arbitrum.
- Risque clé : l’agent est aussi performant que les guardrails que tu lui fixes.
Tu veux qu’un programme surveille les rendements DeFi et agisse à ta place, même quand tu dors ? Les agents IA crypto ne sont plus un concept : en 2026, le toolkit AgentKit de Coinbase permet de déployer un agent autonome avec un wallet en moins d’une demi-heure. Voici comment faire, étape par étape.
Ce dont tu as besoin
- Node.js 20+ installé sur ton ordinateur (vérifie avec
node -v). - Un compte Coinbase Developer Platform (inscription gratuite sur cdp.coinbase.com).
- Une clé API CDP (API Key + API Secret), créée dans le dashboard développeur.
- Un terminal (Terminal, iTerm, VS Code).
- Environ 5 à 10 dollars en ETH sur Base pour les premières transactions.
- Optionnel : une clé API OpenAI ou Anthropic pour alimenter le LLM de l’agent.
Étape 1 : comprendre ce que tu vas déployer
Un agent IA DeFi est un programme autonome qui combine deux composants : un modèle de langage (LLM) pour la prise de décision et un wallet crypto pour l’exécution on-chain. AgentKit fournit le pont entre les deux. Tu définis les règles, l’agent les applique.
Concrètement, l’agent peut : consulter les taux de rendement sur Aave, Morpho, Compound ; exécuter des swaps via les DEX de Base ; déposer et retirer des fonds sur des protocoles de lending ; envoyer des alertes quand une condition de marché est remplie. Le tout sans intervention humaine, dans la limite des guardrails que tu configures.
Étape 2 : créer le projet en une commande
Ouvre ton terminal et lance :
npm create onchain-agent@latest
Le CLI interactif te pose quatre questions : nom du projet, chaîne cible (choisis « Base »), framework IA (LangChain, Vercel AI, ou custom), et source du LLM (OpenAI, Anthropic, ou local). Réponds selon ta préférence. Le scaffold crée un dossier complet avec la structure suivante :
src/agent.ts— le fichier principal de l’agent.src/tools/— les outils DeFi disponibles (swap, lend, balance).src/config.ts— la configuration (clés, chaîne, limites)..env.example— le template pour tes variables d’environnement.
Étape 3 : configurer les clés et les variables
Copie .env.example en .env et remplis :
CDP_API_KEY: ta clé Coinbase Developer Platform.CDP_API_SECRET: ton secret CDP.OPENAI_API_KEYouANTHROPIC_API_KEY: la clé de ton LLM.NETWORK:base-mainnet(oubase-sepoliapour tester).
Astuce : commence toujours par base-sepolia (testnet). Tu peux récupérer des ETH de test gratuits sur le faucet Base. Ça t’évite de griller du capital pendant la phase de debug.
Étape 4 : définir les guardrails de l’agent
C’est l’étape la plus importante. Dans src/config.ts, définis :
- Budget max par transaction : limite chaque opération à un montant. Par exemple, 50 dollars maximum par swap.
- Budget quotidien : plafonne le total journalier. 200 dollars est un bon point de départ.
- Whitelist de protocoles : autorise uniquement les smart contracts vérifiés (Aave v3 Base, Morpho Blue, Uniswap v4).
- Slippage max : 0,5 % recommandé pour les swaps sur Base.
- Kill switch : un mécanisme d’arrêt d’urgence si les pertes dépassent un seuil (par exemple, -5 % du portefeuille).
« Un agent sans guardrails, c’est un stagiaire avec la carte bleue du patron sans plafond », résume un développeur d’AgentKit dans la documentation officielle.
Étape 5 : lancer l’agent en local
Dans ton terminal :
npm run dev
L’agent démarre, crée automatiquement un Agentic Wallet Coinbase (non custodial, clés gérées par le MPC de Coinbase), et commence à écouter les conditions de marché. La console affiche les décisions de l’agent en temps réel.
Tu devrais voir un message du type : Agent initialized. Wallet address: 0x… Monitoring yields on Aave v3 Base.
Étape 6 : tester un scénario simple
Envoie une instruction à l’agent via le prompt interactif :
« Surveille le taux d’emprunt USDC sur Aave Base. Si le taux dépasse 5 % APY, dépose 100 USDC. »
L’agent va : vérifier le taux actuel (3,8 % en avril 2026), rester en attente, puis exécuter le dépôt dès que la condition est remplie. Tu verras la transaction dans ta console et sur Basescan.
Étape 7 : déployer en continu (optionnel)
Pour que l’agent tourne 24/7 sans laisser ton terminal ouvert :
- VPS simple : Hetzner Cloud (3,50 €/mois pour un CX22) ou Railway (gratuit pour les petits projets).
- Docker : le scaffold inclut un Dockerfile prêt à l’emploi. Lance
docker build -t mon-agent . && docker run -d mon-agent. - Monitoring : branche un webhook Discord ou Telegram dans
src/config.tspour recevoir les alertes de l’agent sur ton téléphone.
Astuces pro
- Teste d’abord en dry-run : configure le mode
DRY_RUN=truedans le .env pour que l’agent simule les transactions sans les signer. - Diversifie les LLM : Anthropic tend à être plus prudent dans ses décisions DeFi, OpenAI GPT-4o plus agressif. Teste les deux et compare les résultats sur une semaine.
- Logge tout : active les logs détaillés pour post-analyser les décisions de l’agent. C’est essentiel pour affiner les guardrails.
- Ne donne jamais accès à la totalité de ton portefeuille : l’Agentic Wallet doit être un wallet dédié avec un budget limité. Pas ton wallet principal.
Erreurs courantes à éviter
- Sauter les guardrails : c’est la cause n°1 de pertes avec les agents IA DeFi. Un agent sans plafond peut vider un wallet en quelques transactions si les conditions de marché changent brutalement.
- Ignorer les frais de gas cumulés : un agent qui exécute 50 transactions par jour sur Ethereum mainnet peut consommer des centaines de dollars en gas. Reste sur Base (frais < 0,01 $) pour les phases de test.
- Oublier les impôts : chaque swap exécuté par l’agent constitue un fait générateur fiscal. Avec 50 opérations par jour, la déclaration devient un cauchemar sans outil de tracking. Utilise Rotki ou CoinLedger en parallèle, et consulte notre guide fiscal 2026.
- Faire confiance aveuglément au LLM : les modèles de langage peuvent halluciner des adresses de contrats ou des protocoles inexistants. Les guardrails avec whitelist empêchent ce risque.
- Oublier le kill switch : en cas de flash crash ou de depeg stablecoin, l’agent doit s’arrêter automatiquement. Configure un seuil de perte max de 5 % et teste le mécanisme avant de déployer en production.
Comprendre les Agentic Wallets Coinbase
Le cœur d’AgentKit, c’est l’Agentic Wallet. Contrairement à un wallet classique où tu détiens les clés privées, l’Agentic Wallet utilise un système de calcul multi-parties (MPC). La clé privée n’existe jamais en un seul endroit : elle est fragmentée entre le serveur Coinbase et ton environnement local. Aucune des deux parties ne peut signer seule une transaction.
Cette architecture a deux avantages majeurs pour un agent IA. D’abord, si ton serveur est compromis, l’attaquant ne peut pas vider le wallet sans la coopération du MPC Coinbase. Ensuite, tu peux programmer des règles de signature côté serveur : par exemple, bloquer toute transaction dépassant un certain montant sans confirmation humaine.
L’inconvénient : tu dépends partiellement de l’infrastructure Coinbase. Si le service MPC est indisponible, ton agent ne peut plus signer. C’est un compromis entre sécurité et décentralisation que tu dois accepter consciemment. Pour un agent avec un budget limité (< 5 000 dollars), c'est un tradeoff raisonnable. Pour des montants plus importants, envisage un setup avec Gnosis Safe multisig.
Stratégies d’agent : trois exemples concrets
Voici trois stratégies que tu peux programmer avec AgentKit, de la plus simple à la plus avancée :
Stratégie 1 : yield farming automatisé
L’agent surveille les taux de rendement sur Aave v3 (Base), Morpho Blue et Compound. Quand le taux USDC sur Aave dépasse celui de Morpho de plus de 50 bps, l’agent retire de Morpho et redéploie sur Aave. Le rééquilibrage est hebdomadaire pour minimiser les frais. APY cible : 4 à 6 %.
Stratégie 2 : DCA intelligent
L’agent exécute un DCA (Dollar Cost Averaging) quotidien sur ETH, mais avec un twist : il ajuste le montant en fonction du Fear & Greed Index. Quand l’indice est sous 25 (peur extrême), il double la mise. Quand il est au-dessus de 75 (cupidité), il divise par deux. Sur un backtest 2024-2025, cette stratégie surperforme le DCA fixe de 12 %.
Stratégie 3 : arbitrage liquidité
L’agent détecte les écarts de prix entre Uniswap v4 (Base) et les pools Aerodrome. Quand l’écart dépasse 0,3 % net de frais, il exécute un swap atomique. Cette stratégie nécessite un capital minimum de 10 000 dollars pour couvrir les frais et générer un profit significatif. Rendement net estimé : 8 à 15 % annualisé, avec un risque de impermanent loss sur les pools de liquidité.
Monitoring et alertes en production
Un agent qui tourne 24/7 sans monitoring est une bombe à retardement. Voici la stack de monitoring recommandée :
- Webhook Telegram/Discord : configure dans config.ts pour recevoir une alerte à chaque transaction exécutée. Format : « [AGENT] Swap 500 USDC → 0.21 ETH sur Uniswap Base | TX: 0x… »
- Dashboard Dune : crée un dashboard personnalisé avec l’adresse de l’Agentic Wallet pour visualiser les flux en temps réel.
- Alerte de santé : configure un heartbeat toutes les 6 heures. Si l’agent ne ping pas, c’est qu’il est planté. Uptime Kuma (open source, auto-hébergeable) est une bonne solution.
- Rapport hebdomadaire : programme un script qui génère un résumé P&L chaque dimanche et l’envoie sur ton canal Telegram.
Alternatives à AgentKit
AgentKit n’est pas le seul toolkit disponible. Deux alternatives méritent un coup d’oeil :
- Walbi (lancé en mars 2026) : plateforme no-code où tu décris ta stratégie en langage naturel. L’avantage : aucune compétence technique requise. L’inconvénient : tu es dépendant de la plateforme, les guardrails sont prédéfinis, et les stratégies possibles sont plus limitées qu’avec du code custom.
- Virtuals Protocol (Base) : plutôt orienté agents autonomes tokenisés. Tu crées un agent qui gère son propre token, ses propres revenus, et interagit avec d’autres agents via un protocole de commerce machine-à-machine. Plus complexe, orienté développeurs avancés et économie d’agents plutôt que simple automatisation DeFi personnelle.
Le choix dépend de ton profil : AgentKit pour les développeurs qui veulent du contrôle total, Walbi pour les non-développeurs qui veulent automatiser une stratégie simple, Virtuals pour ceux qui veulent construire un agent comme un produit autonome.
Récap actionable
Crée ton compte Coinbase Developer Platform. Génère tes clés API. Lance npm create onchain-agent@latest. Configure les guardrails dans config.ts. Teste en dry-run sur le testnet Base Sepolia. Valide le comportement. Passe en mainnet avec un petit budget. Monitore quotidiennement. C’est tout.
FAQ
AgentKit est-il gratuit ?
Le toolkit est open source et gratuit. Les coûts réels sont : le LLM (API OpenAI/Anthropic, quelques centimes à quelques dollars par jour selon l’usage) et les frais de gas on-chain (négligeables sur Base, significatifs sur Ethereum mainnet).
Puis-je utiliser un agent sans savoir coder ?
Partiellement. Le scaffold CLI fait l’essentiel, mais les guardrails nécessitent de toucher au fichier config.ts. Des plateformes no-code comme Walbi (lancée en mars 2026) proposent une alternative pour les non-développeurs, où tu décris ta stratégie en langage naturel. La contrepartie : moins de contrôle et dépendance à la plateforme.
L’agent peut-il perdre tout mon argent ?
Oui, si les guardrails sont mal configurés. Un agent sans plafond de transaction, sans kill switch et avec accès à un portefeuille complet peut exécuter des opérations déficitaires en cascade. C’est pourquoi le wallet dédié avec budget limité et le mode dry-run sont non négociables. Plus de contexte dans notre article agents IA on-chain.
Sur quelles chaînes fonctionne AgentKit ?
Base (Coinbase L2) est la chaîne principale supportée. Ethereum mainnet et Arbitrum sont compatibles mais les frais de gas rendent l’usage intensif coûteux. Solana et les chaînes non-EVM ne sont pas encore supportées en natif, mais la roadmap Q3 2026 mentionne un support multi-chaîne élargi.
