TokenMix Crypto Intelligence Agent

TokenMix Crypto Intelligence Agent

Un agent d'intelligence crypto personnalisé et d'aide à la décision, alimenté par TokenMix.

TokenMix Crypto Intelligence Agent est un outil open source de recherche crypto. Il lit des données de marché publiques, des données d'exchanges, des données DeFi, des actualités et des signaux développeur, puis les combine avec votre profil de risque, votre watchlist et votre horizon de temps pour générer des rapports fondés sur des preuves.

Ce guide explique comment configurer votre clé API TokenMix pour que l'agent puisse appeler les modèles via TokenMix.

Important : c'est un outil de recherche et d'aide à la décision. Ce n'est pas un robot de trading, il ne passe pas d'ordres et ne doit pas être considéré comme un conseil financier.

Avant de commencer

Vous avez besoin de :

  1. Un compte TokenMix.
  2. Une clé API TokenMix.
  3. Un ordinateur ou serveur avec Node.js ou Docker.
  4. Un actif crypto à analyser, par exemple BTC, ETH ou SOL.

Si vous n'avez pas encore de clé API, connectez-vous à TokenMix, ouvrez la page API Key du tableau de bord et créez une nouvelle clé. Copiez la clé complète. Elle commence généralement par sk-tm-.

Étape 1 : télécharger le projet

Dans un terminal :

git clone https://github.com/TokenMixAi/tokenmix-crypto-intelligence-agent
cd tokenmix-crypto-intelligence-agent
npm install
cp .env.example .env

Un fichier .env est créé. Vous y ajouterez votre clé API TokenMix.

Étape 2 : remplir les paramètres TokenMix

Ouvrez .env et trouvez :

TOKENMIX_API_KEY=
TOKENMIX_BASE_URL=https://api.tokenmix.ai/v1
TOKENMIX_MODEL=claude-opus-4.7
TOKENMIX_ROUTING=balanced
REQUIRE_TOKENMIX_KEY=true

Modifiez ainsi :

TOKENMIX_API_KEY=sk-tm-your-tokenmix-key
TOKENMIX_BASE_URL=https://api.tokenmix.ai/v1
TOKENMIX_MODEL=<model-short-id>
TOKENMIX_ROUTING=balanced
REQUIRE_TOKENMIX_KEY=true

Notes :

  1. Gardez TOKENMIX_BASE_URL sur https://api.tokenmix.ai/v1.
  2. Vérifiez que la clé API n'a pas d'espaces en trop.
  3. TOKENMIX_MODEL doit être un ID de modèle pris en charge par TokenMix.
  4. Pour les rapports complexes, utilisez un modèle plus puissant.

Étape 3 : définir votre profil

L'agent adapte son rapport à votre rôle et à votre profil de risque. Un trader court terme et un chercheur long terme ne doivent pas recevoir le même angle d'analyse.

Exemple :

npm run dev -- profile --role crypto_researcher --risk balanced --horizon weekly --interests "AI agents,Solana,DeFi" --style standard

Pour un test rapide, vous pouvez ignorer cette étape et garder le profil par défaut.

Étape 4 : analyser un actif

Commencez avec BTC :

npm run dev -- analyze BTC

Ou analysez SOL :

npm run dev -- analyze SOL

Une exécution réussie affiche un rapport Markdown avec contexte de marché, preuves, qualité des données, score de risque, observations personnalisées et signaux de confirmation ou d'invalidation.

Action Bias n'est pas une instruction d'achat ou de vente. C'est seulement une orientation de recherche : surveiller, attendre confirmation, suivre une opportunité, rester prudent ou réduire le risque.

Étape 5 : définir une watchlist

npm run dev -- watchlist BTC ETH SOL TAO VIRTUAL

Puis générez un brief quotidien :

npm run dev -- daily

Étape 6 : utiliser l'interface web

Démarrez l'API et l'interface web :

npm run dev:api

Ouvrez :

http://localhost:3000

Au premier lancement en production, si APP_AUTH_PASSWORD est vide, le navigateur vous demandera de créer un mot de passe de déploiement. L'application stocke uniquement un hash dans data/auth.json.

Optionnel : lancer avec Docker

cp .env.example .env

Remplissez .env, puis lancez :

docker compose up --build

Ouvrez :

http://localhost:3000

Problèmes fréquents

Clé API TokenMix manquante

Vérifiez que .env contient :

TOKENMIX_API_KEY=sk-tm-your-tokenmix-key

Si REQUIRE_TOKENMIX_KEY=true, les rapports IA nécessitent une clé TokenMix.

Modèle non disponible

Vérifiez que TOKENMIX_MODEL est un ID de modèle actuellement pris en charge par TokenMix.

Génération lente

L'agent récupère plusieurs sources publiques et demande au modèle de générer un long rapport. Commencez par BTC pour tester.

Le rapport ressemble à un conseil financier

Traitez-le uniquement comme du matériel de recherche. L'agent ne donne pas d'instructions d'achat, de vente, de short ou de hausse garantie, et ne contrôle pas les wallets ni les trades.

Résumé

Mettez votre clé TokenMix sk-tm-... dans TOKENMIX_API_KEY, gardez TOKENMIX_BASE_URL=https://api.tokenmix.ai/v1, choisissez un modèle TokenMix, puis lancez npm run dev -- analyze BTC pour générer un rapport crypto alimenté par TokenMix.