TokenMix Crypto Intelligence Agent

TokenMix Crypto Intelligence Agent

Un agente de inteligencia cripto personalizada y apoyo a decisiones, impulsado por TokenMix.

TokenMix Crypto Intelligence Agent es una herramienta open source de investigación cripto. Lee datos públicos de mercado, datos de exchanges, datos DeFi, noticias y señales de desarrollo, y los combina con tu perfil de riesgo, watchlist y horizonte temporal para generar informes con evidencia.

Esta guía se centra en configurar tu API Key de TokenMix para que el agente pueda llamar modelos a través de TokenMix.

Importante: es una herramienta de investigación y apoyo a decisiones. No es un bot de trading, no ejecuta operaciones y no debe tratarse como asesoramiento financiero.

Antes de empezar

Necesitas:

  1. Una cuenta de TokenMix.
  2. Una API Key de TokenMix.
  3. Un ordenador o servidor con Node.js o Docker.
  4. Un activo cripto para analizar, como BTC, ETH o SOL.

Si aún no tienes API Key, inicia sesión en TokenMix, abre la página API Key del panel y crea una nueva clave. Copia la clave completa. Normalmente empieza por sk-tm-.

Paso 1: descargar el proyecto

En una terminal:

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

Esto crea un archivo .env. Ahí pondrás tu API Key de TokenMix.

Paso 2: completar la configuración de TokenMix

Abre .env y busca:

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

Cámbialo a:

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

Notas:

  1. Mantén TOKENMIX_BASE_URL como https://api.tokenmix.ai/v1.
  2. Asegúrate de que la API Key no tenga espacios extra.
  3. TOKENMIX_MODEL debe ser un ID de modelo compatible con TokenMix.
  4. Para informes complejos, usa un modelo más potente.

Paso 3: definir tu perfil

El agente ajusta el informe según tu rol y perfil de riesgo. Un trader de corto plazo y un investigador de largo plazo no deberían recibir el mismo enfoque.

Ejemplo:

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

Si solo quieres probar rápido, puedes omitir este paso y usar el perfil por defecto.

Paso 4: analizar un activo

Empieza con BTC:

npm run dev -- analyze BTC

O analiza SOL:

npm run dev -- analyze SOL

Si todo funciona, verás un informe Markdown con contexto de mercado, evidencia, calidad de datos, puntuación de riesgo, observaciones personalizadas y señales de confirmación o invalidación.

Action Bias no es una orden de compra o venta. Es solo una orientación de investigación: observar, esperar confirmación, vigilar oportunidad, actuar con cautela o reducir riesgo.

Paso 5: configurar una watchlist

npm run dev -- watchlist BTC ETH SOL TAO VIRTUAL

Luego genera un resumen diario:

npm run dev -- daily

Paso 6: usar la Web UI

Inicia la API y la interfaz web:

npm run dev:api

Abre:

http://localhost:3000

En el primer lanzamiento de producción, si APP_AUTH_PASSWORD está vacío, el navegador pedirá crear una contraseña de despliegue. La app solo guarda un hash en data/auth.json.

Opcional: ejecutar con Docker

cp .env.example .env

Completa .env y ejecuta:

docker compose up --build

Abre:

http://localhost:3000

Problemas frecuentes

Falta la API Key de TokenMix

Comprueba que .env contiene:

TOKENMIX_API_KEY=sk-tm-your-tokenmix-key

Si REQUIRE_TOKENMIX_KEY=true, los informes de IA requieren una Key de TokenMix.

Modelo no disponible

Comprueba que TOKENMIX_MODEL sea un ID de modelo actualmente compatible con TokenMix.

La generación es lenta

El agente obtiene varias fuentes públicas y pide al modelo generar un informe largo. Empieza con BTC para probar.

El informe parece asesoramiento financiero

Trátalo solo como material de investigación. El agente no da instrucciones de comprar, vender, hacer short o garantizar subidas, y no controla wallets ni ejecuta operaciones.

Resumen

Pon tu Key de TokenMix sk-tm-... en TOKENMIX_API_KEY, mantén TOKENMIX_BASE_URL=https://api.tokenmix.ai/v1, elige un modelo de TokenMix y ejecuta npm run dev -- analyze BTC para generar un informe cripto impulsado por TokenMix.