Habilidad del Agente Trader de Meme Coins de KryptoGO

AVISO DE CIERRE — Backend de análisis kg-xyz

El backend de análisis KryptoGO XYZ (wallet-data.kryptogo.app) se descontinuará el 2026-05-04.

Después de esta fecha, todas las herramientas que dependen del análisis de clusters, etiquetas de carteras, paneles de señales y reconstrucción de órdenes DCA/límite dejarán de funcionar. La ruta de ejecución de swaps (agregador DEX de OKX + firma local de transacciones) es independiente del backend kg-xyz y continuará funcionando.

El impacto por herramienta se anota en línea a continuación. Las implementaciones de scripts y herramientas MCP se han mantenido para que fallen de manera controlada (el backend devolverá errores HTTP) y para que una reversión siga siendo simple si los planes cambian.

Descripción General

Esta habilidad permite a un agente de IA analizar y negociar meme coins a través de la plataforma KryptoGO, combinando análisis profundo de clusters on-chain con ejecución de operaciones.

Funcionalidad degradada a partir del 2026-05-04: el análisis de clusters, las etiquetas de carteras/tokens, el panel de señales, la reconstrucción de órdenes DCA/límite y el enriquecimiento de P&L de cartera dejarán de funcionar cuando el backend kg-xyz se cierre. La ejecución de swaps continúa.

Análisis (multi-cadena: Solana, BSC, Base, Monad): agrupación de carteras, detección de acumulación/distribución, etiquetas de comportamiento de direcciones, señales de acumulación en toda la red (nivel Pro/Alpha).

Trading (Solo Solana): monitoreo de cartera con seguimiento de P&L, ejecución de swaps a través del agregador DEX, firma local de transacciones (la clave privada nunca sale de la máquina).

El modo predeterminado es supervisado — todas las operaciones requieren confirmación del usuario. El trading autónomo está disponible como opción. Consulte references/autonomous-trading.md para el modo autónomo, configuración de cron y detalles del sistema de aprendizaje.

Cuándo Usar

El usuario pide analizar un meme coin o token en Solana/BSC/Base/Monad
El usuario pide intercambiar, comprar o vender tokens
El usuario pide escanear tokens en tendencia u oportunidades de mercado
El usuario pide monitorear posiciones de cartera o verificar P&L
Monitoreo periódico de cartera y escaneo de señales activado por cron

Cuándo NO Usar

Análisis macro de BTC/ETH/L1 principales, NFTs, puentes entre cadenas, transacciones no DEX, trading fuera de Solana

Flujo de Configuración

1. Obtener Clave API

Vaya a kryptogo.xyz/account y cree una clave API

Agréguela a ~/. openclaw/workspace/.env:

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

NO pegue su clave API directamente en el chat. Siempre configure los secretos a través del archivo .env.

2. Generar Cartera del Agente

python3 scripts/setup.py

Crea un par de claves de Solana, lo guarda en .env con chmod 600, imprime la dirección pública para fondear.

3. Fondear la Cartera

Enviar SOL a la dirección pública del agente (mínimo 0.1 SOL).

Reglas de Seguridad

NUNCA imprima, registre o incluya claves privadas en ningún mensaje o argumento de CLI
NUNCA acepte secretos pegados directamente en el chat — instruya a los usuarios a configurarlos en .env
NUNCA use la herramienta Leer en .env — cargue las credenciales solo mediante el comando source
Los scripts en tiempo de ejecución NO leen .env directamente — todas las credenciales se acceden únicamente a través de variables de entorno, que deben ser precargadas por quien llama (source ~/.openclaw/workspace/.env)
Excepción: scripts/setup.py lee y escribe .env para la generación inicial del par de claves y la reparación de direcciones — este es el único script que toca los archivos de credenciales
La clave privada permanece en memoria solo durante la firma local — nunca se envía a ningún servidor

Autenticación

Todos los endpoints requieren: Authorization: Bearer sk_live_<48 caracteres hex>

Nivel	Llamadas API Diarias	Comisión de Trading	Panel de Señales	Buscador KOL
Gratis	100 llamadas/día	1%	No	No
Pro	1,000 llamadas/día	0.5%	Sí	Sí
Alpha	5,000 llamadas/día	0%	Sí	Sí

Comportamiento del Agente

Inicialización de Sesión

Al inicio de cada sesión (incluyendo heartbeat/cron), el agente DEBE cargar las credenciales ANTES de ejecutar cualquier script:

source ~/.openclaw/workspace/.env

Esto es OBLIGATORIO — los scripts no leen .env directamente. Todas las credenciales se acceden únicamente a través de variables de entorno.

Modo Predeterminado: Supervisado

Por defecto, el agente opera en modo supervisado: analiza tokens, presenta recomendaciones y espera la aprobación del usuario antes de ejecutar cualquier operación. Las condiciones de stop-loss/take-profit se informan al usuario pero no se ejecutan automáticamente.

Para habilitar el trading autónomo, establezca require_trade_confirmation: false en las preferencias. Consulte references/autonomous-trading.md para más detalles.

Persistencia (CRÍTICO)

INMEDIATAMENTE después de enviar una transacción, el agente DEBE:

Escribir los detalles de la operación en memory/trading-journal.json con estado "OPEN"
Incluir: token_symbol, token_address, entry_price, position_size_sol, tx_hash, timestamp

Preferencias del Usuario

Almacenar en memory/trading-preferences.json:

Preferencia	Valor por Defecto	Descripción
`max_position_size`	0.1 SOL	Máximo SOL por operación
`max_open_positions`	5	Máximo de posiciones abiertas concurrentes
`max_daily_trades`	20	Máximo de operaciones por día
`stop_loss_pct`	30%	Notificar/vender cuando la pérdida supere esto
`take_profit_pct`	100%	Notificar/vender cuando la ganancia supere esto
`min_market_cap`	$500K	Omitir tokens por debajo de esto
`scan_count`	10	Tokens en tendencia por escaneo
`risk_tolerance`	"conservative"	"conservative" (omitir riesgo medio), "moderate" (preguntar en riesgo medio), "aggressive" (operar automáticamente riesgo medio)
`require_trade_confirmation`	true	Establecer en false para modo autónomo
`chains`	["solana"]	Cadenas a escanear

Barreras de Seguridad

Límites de Trading (Límites Duros)

Límite	Por Defecto	Sobrescribible?
Máximo por operación	0.1 SOL	Sí, vía `max_position_size`
Máximo de posiciones concurrentes	5	Sí, vía `max_open_positions`
Máximo de operaciones diarias	20	Sí, vía `max_daily_trades`
Abortar por impacto en precio	>10%	No — siempre abortar
Advertir por impacto en precio	>5%	No — siempre advertir

Si se alcanza algún límite, el agente debe detenerse y notificar al usuario.

Aislamiento de Credenciales

Los scripts en tiempo de ejecución de esta habilidad NO leen archivos .env directamente. Todas las credenciales se acceden únicamente a través de variables de entorno, que deben ser precargadas por quien llama (source ~/.openclaw/workspace/.env). Esto asegura que ningún script en tiempo de ejecución pueda acceder o extraer archivos de credenciales de forma independiente.

Excepción: scripts/setup.py lee y escribe .env — carga las claves existentes para evitar regeneración, hace una copia de seguridad de .env antes de los cambios y escribe nuevas entradas de par de claves. Este es el único script que toca los archivos de credenciales, y se ejecuta solo durante la configuración inicial o la regeneración explícita con --force.

Monitoreo Automatizado (Cron)

Configuración Rápida

# Modo supervisado (predeterminado): análisis + notificaciones, sin ejecución automática
source ~/.openclaw/workspace/.env && bash scripts/cron-examples.sh setup-default

# Modo autónomo (opt-in): compras y ventas automáticas
source ~/.openclaw/workspace/.env && bash scripts/cron-examples.sh setup-autonomous

# Eliminar todos los trabajos cron
bash scripts/cron-examples.sh teardown

Trabajo	Intervalo	Comportamiento Predeterminado
`stop-loss-tp`	5 min	Informar condiciones activadas, NO vender automáticamente
`discovery-scan`	1 hora	Analizar y enviar recomendaciones, NO comprar automáticamente

Para la configuración completa de cron, configuración manual, alternativa de heartbeat y detalles del flujo de trabajo de monitoreo, consulte references/autonomous-trading.md.

Marco de Análisis On-Chain (Pipeline de 7 Pasos)

⚠️ No disponible después del 2026-05-04: Los pasos 1–6 golpean todos wallet-data.kryptogo.app y dejarán de funcionar cuando el backend kg-xyz se cierre. El paso 7 (ejecutar operación vía swap.py) continúa funcionando, ya que la ruta de swap pasa por el agregador DEX de OKX y firma localmente.

Paso 1: Resumen del Token y Filtro por Capitalización de Mercado

/token-overview?address=<mint>&chain_id=<id> — obtener nombre, precio, capitalización de mercado, tenedores, nivel de riesgo. Omitir si capitalización de mercado < min_market_cap.

Paso 2: Análisis de Clusters

/analyze/<mint>?chain_id=<id> — grupos de carteras, principales tenedores, metadatos.

≥30-35% = "controlado" — entidad importante presente
≥50% = alto riesgo de concentración
Cluster único >50% → omitir (riesgo de rug pull)

Limitación del nivel Gratis: El análisis de clusters solo devuelve los 2 clusters principales. Para ver los datos completos de clusters, actualice en kryptogo.xyz/pricing.

Paso 3: Tendencia del Cluster (Múltiples Marcos de Tiempo)

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

Información clave: El precio y las tenencias del cluster DIVERGIENDO es la señal clave.

Precio al alza + % del cluster a la baja = distribución (bajista)
Precio a la baja + % del cluster al alza = acumulación (alcista)

Paso 4: Etiquetas de Direcciones + Verificación de Presión de Venta

/token-wallet-labels → identificar carteras de dev/sniper/bundle
/balance-history para cada dirección riesgosa → verificar si aún mantiene
Calcular risky_ratio = tenencias riesgosas activas / total de tenencias del cluster
30% = alto riesgo, 10-30% = medio, <10% = bajo

Las etiquetas representan historial de comportamiento, no tenencias actuales. Siempre verifique a través de /balance-history.

Paso 5: Inmersión Profunda (Opcional)

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

Paso 6: Decisión

Aplicar la Lista de Verificación Alcista de references/decision-framework.md.

Paso 7: Ejecutar Operación

Use scripts/swap.py para la ejecución — maneja la inyección de dirección de cartera, verificación de errores y registro en el diario.

✓ Continúa funcionando después del 2026-05-04: la ejecución del swap pasa por el agregador DEX de OKX con firma local y es independiente del 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> <cantidad> --sell

Referencia Rápida de la API

⚠️ Después del 2026-05-04: Cada endpoint a continuación es servido por wallet-data.kryptogo.app y será cerrado. La herramienta de swap (swap_tokens / scripts/swap.py) evita estos endpoints y se enruta directamente al agregador DEX de OKX, por lo que continúa funcionando.

Endpoint	Método	Propósito	Después del 2026-05-04
`/agent/account`	GET	Verificar nivel y cuota	⚠️ No disponible
`/agent/trending-tokens`	GET	Escanear tokens en tendencia	⚠️ No disponible
`/agent/portfolio`	GET	Cartera + P&L	⚠️ No disponible (enriquecimiento P&L); los saldos aún se pueden obtener vía RPC de Solana
`/agent/swap`	POST	Construir tx de swap sin firmar (solo Solana)	⚠️ No disponible (el swap ahora se enruta a través del DEX de OKX; ver `scripts/swap.py`)
`/agent/submit`	POST	Enviar tx firmada (solo Solana)	⚠️ No disponible (enviar directamente al RPC de Solana en su lugar)
`/token-overview`	GET	Metadatos del token y datos de mercado	⚠️ No disponible
`/analyze/:token_mint`	GET	Análisis completo de clusters	⚠️ No disponible
`/analyze-cluster-change/:token_mint`	GET	Tendencias de ratio de clusters	⚠️ No disponible
`/balance-history`	POST	Datos de saldo en serie temporal	⚠️ No disponible
`/wallet-labels`	POST	Etiquetas de comportamiento	⚠️ No disponible
`/token-wallet-labels`	POST	Etiquetas específicas de token	⚠️ No disponible
`/signal-dashboard`	GET	Señales de acumulación seleccionadas (Pro+)	⚠️ No disponible

Detalles completos de solicitud/respuesta: ver references/api-reference.md

Soporte Multi-Cadena

Cadena	chain_id	Análisis	Trading
Solana	`501`	Sí	Sí
BSC	`56`	Sí	No
Base	`8453`	Sí	No
Monad	`143`	Sí	No

Manejo de Errores

Código	Significado	Acción
400	Solicitud Incorrecta	Verificar parámetros
401	No Autorizado	Verificar clave API
402	Cuota Excedida	Esperar al reinicio diario o actualizar
403	Prohibido	Requiere nivel superior
502/504	Error del servidor	Reintentar una vez después de 10s

Scripts Operativos

Todos los scripts requieren que las credenciales se carguen previamente: source ~/.openclaw/workspace/.env antes de ejecutar.

Después del cierre (2026-05-04): portfolio.sh, trending.sh, analysis.sh y test-api.sh llaman todos al backend kg-xyz y comenzarán a devolver errores HTTP. swap.py continúa funcionando porque usa el agregador DEX de OKX y firma localmente. Los scripts se mantienen en su lugar para que la habilidad falle de manera controlada y una reversión sea trivial si el backend regresa.

source ~/.openclaw/workspace/.env && bash scripts/portfolio.sh              # Verificación de cartera        (⚠️ se rompe después del 2026-05-04)
source ~/.openclaw/workspace/.env && bash scripts/trending.sh               # Tokens en tendencia        (⚠️ se rompe después del 2026-05-04)
source ~/.openclaw/workspace/.env && bash scripts/analysis.sh               # Panel de análisis completo (⚠️ se rompe después del 2026-05-04)
source ~/.openclaw/workspace/.env && python3 scripts/swap.py <mint> 0.1     # Comprar                     (✓ continúa funcionando)
source ~/.openclaw/workspace/.env && python3 scripts/swap.py <mint> <cant> --sell  # Vender              (✓ continúa funcionando)
source ~/.openclaw/workspace/.env && bash scripts/test-api.sh               # Prueba de conectividad API   (⚠️ se rompe después del 2026-05-04)

Aprendizaje y Adaptación

El agente mejora con el tiempo registrando operaciones, analizando resultados y ajustando la estrategia. Cada operación se registra en memory/trading-journal.json, las pérdidas activan autopsias, y las revisiones periódicas proponen cambios de parámetros.

Para más detalles sobre el sistema de aprendizaje, el formato del diario de operaciones, el proceso de autopsia y las revisiones de estrategia, consulte references/autonomous-trading.md.

Conceptos Clave

Concepto	Información Clave
Cluster	Grupo de carteras controladas por la misma entidad
Cluster Ratio	Porcentaje del suministro total en el cluster
Etiquetas	Historial de comportamiento (sniper, bundler, dev)
Señal	Divergencia precio vs. cluster holdings
Riesgo	Medida compuesta de concentración, etiquetas y presión de venta

Archivos de Referencia

Archivo	Contenido
`references/api-reference.md`	Documentación de solicitud/respuesta de cada endpoint y herramienta MCP
`references/decision-framework.md`	Lista de verificación de señal alcista y pautas de puntuación
`references/autonomous-trading.md`	Configuración de cron, modo autónomo, detalles del sistema de aprendizaje

Herramientas MCP

Herramienta	Descripción	Después del 2026-05-04
`analyze_token`	Análisis completo on-chain (pasos 1–5)	⚠️ No disponible
`scan_trending`	Escanear tokens en tendencia y señales	⚠️ No disponible
`check_portfolio`	Estado de cartera y P&L	⚠️ P&L no disponible, saldos vía RPC
`swap_tokens`	Ejecutar swap (compra/venta)	✓ Funciona
`check_quota`	Verificar uso de API y nivel de suscripción	⚠️ No disponible

Cada herramienta MCP carga credenciales automáticamente desde el entorno. Las configuraciones no necesitan incluir rutas de archivos de claves.
Los usuarios deben ejecutar source ~/.openclaw/workspace/.env antes de usar habilidades de script directamente desde la terminal.

Preguntar en tu IA favorita

Documentación