Lancer un agent IA DeFi avec AgentKit Coinbase : guide

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 vous lui fixez.

Vous voulez qu’un programme surveille les rendements DeFi et agisse à votre place, même quand vous dormez ? 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 vous avez besoin

• Node.js 20+ installé sur votre ordinateur (vérifiez 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 vous allez 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. Vous définissez 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 vous configurez.

Étape 2 : créer le projet en une commande

Ouvrez votre terminal et lancez :

npm create onchain-agent@latest

Le CLI interactif vous pose quatre questions : nom du projet, chaîne cible (choisissez « Base »), framework IA (LangChain, Vercel AI, ou custom), et source du LLM (OpenAI, Anthropic, ou local). Répondez selon votre 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 vos variables d’environnement.

Étape 3 : configurer les clés et les variables

Copiez .env.example en .env et remplissez :

• CDP_API_KEY : votre clé Coinbase Developer Platform.
• CDP_API_SECRET : votre secret CDP.
• OPENAI_API_KEY ou ANTHROPIC_API_KEY : la clé de votre LLM.
• NETWORK : base-mainnet (ou base-sepolia pour tester).

Astuce : commencez toujours par base-sepolia (testnet). Vous pouvez récupérer des ETH de test gratuits sur le faucet Base. Ça vous é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éfinissez :

• 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 votre 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.

Vous devriez voir un message du type : Agent initialized. Wallet address: 0x… Monitoring yields on Aave v3 Base.

Étape 6 : tester un scénario simple

Envoyez une instruction à l’agent via le prompt interactif :

« Surveillez le taux d’emprunt USDC sur Aave Base. Si le taux dépasse 5 % APY, déposez 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. Vous verrez la transaction dans votre console et sur Basescan.

Étape 7 : déployer en continu (optionnel)

Pour que l’agent tourne 24/7 sans laisser votre 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. Lancez docker build -t mon-agent . && docker run -d mon-agent.
• Monitoring : branchez un webhook Discord ou Telegram dans src/config.ts pour recevoir les alertes de l’agent sur votre téléphone.

Astuces pro

• Testez d’abord en dry-run : configurez le mode DRY_RUN=true dans le .env pour que l’agent simule les transactions sans les signer.
• Diversifiez les LLM : Anthropic tend à être plus prudent dans ses décisions DeFi, OpenAI GPT-4o plus agressif. Testez les deux et comparez les résultats sur une semaine.
• Loggez tout : activez les logs détaillés pour post-analyser les décisions de l’agent. C’est essentiel pour affiner les guardrails.
• Ne donnez jamais accès à la totalité de votre portefeuille : l’Agentic Wallet doit être un wallet dédié avec un budget limité. Pas votre 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. Restez 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. Utilisez Rotki ou CoinLedger en parallèle, et consultez 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. Configurez un seuil de perte max de 5 % et testez 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ù vous détenez 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 votre 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 votre serveur est compromis, l’attaquant ne peut pas vider le wallet sans la coopération du MPC Coinbase. Ensuite, vous pouvez 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 : vous dépendez partiellement de l’infrastructure Coinbase. Si le service MPC est indisponible, votre agent ne peut plus signer. C’est un compromis entre sécurité et décentralisation que vous devez accepter consciemment. Pour un agent avec un budget limité (< 5 000 dollars), c'est un tradeoff raisonnable. Pour des montants plus importants, envisagez un setup avec Gnosis Safe multisig.

Stratégies d’agent : trois exemples concrets

Voici trois stratégies que vous pouvez 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 : configurez 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éez un dashboard personnalisé avec l’adresse de l’Agentic Wallet pour visualiser les flux en temps réel.
• Alerte de santé : configurez 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 : programmez un script qui génère un résumé P&L chaque dimanche et l’envoie sur votre 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ù vous décrivez votre stratégie en langage naturel. L’avantage : aucune compétence technique requise. L’inconvénient : vous êtes 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. Vous créez 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 votre 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éez votre compte Coinbase Developer Platform. Générez vos clés API. Lancez npm create onchain-agent@latest. Configurez les guardrails dans config.ts. Testez en dry-run sur le testnet Base Sepolia. Validez le comportement. Passez en mainnet avec un petit budget. Monitorez 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ù vous décrivez votre 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.