Mobula - Inteligencia de Criptodatos Multi-Cadena

¿Qué hace Mobula - Inteligencia de Criptodatos Multi-Cadena?

Datos del mercado de criptomonedas en tiempo real, seguimiento de carteras y análisis en cadena en más de 88 blockchains. Precios con grado de oracle confiables por Chainlink, Supra y API3.

Cuándo Usar Esta Habilidad

USA cuando el usuario:

• Pregunte sobre el precio, volumen, capitalización de mercado o cambio de precio de cualquier token
• Quiera verificar las tenencias o el valor de una cartera de wallet
• Necesite datos históricos de precios para gráficos o análisis
• Mencione una dirección de contrato y quiera información del token
• Pregunte sobre tokens en cadenas específicas (Base, Arbitrum, Solana, etc.)
• Quiera una visión general de cartera multi-cadena
• Necesite datos por lotes de múltiples tokens a la vez
• Pregunte sobre liquidez, ATH, ATL o volumen de trading de un token
• Quiera rastrear wallets de ballenas o monitorear transacciones significativas
• Necesite encontrar nuevos tokens que coincidan con criterios específicos

NO USES cuando:

• El usuario quiera ejecutar operaciones (usa la habilidad bankr)
• El usuario quiera cotizaciones de intercambio DEX (usa la habilidad defi)
• El usuario quiera datos específicos de intercambios (usa las habilidades okx/binance)

---

Capacidades Principales

1. Datos de Mercado (mobula_market_data)

Endpoint: GET https://api.mobula.io/api/1/market/data

Obtén precio en tiempo real, volumen, capitalización de mercado y liquidez de cualquier token en todas las cadenas compatibles.

Parámetros:

• asset (requerido): Nombre, símbolo o dirección de contrato del token
  • Ejemplos: "Bitcoin", "ETH", "0x532f27101965dd16442e59d40670faf5ebb142e4"
• blockchain (opcional): Cadena específica a consultar
  • Ejemplos: "base", "arbitrum", "ethereum", "solana", "polygon"

Devuelve:

• Precio actual (USD)
• Cambios de precio: 1h, 24h, 7d, 30d (porcentaje y absoluto)
• Volumen (24h)
• Capitalización de mercado
• Valoración totalmente diluida
• Liquidez
• Máximo histórico (ATH) y mínimo histórico (ATL) con fechas
• Suministro total, suministro circulante

Ejemplos de uso:

• "¿Cuál es el precio de Bitcoin?"
• "Muéstrame los datos de mercado de BRETT en Base"
• "Obtén datos del contrato 0x532f27101965dd16442e59d40670faf5ebb142e4"
• "¿Está ETH subiendo o bajando ahora?"
• "¿Cuál es la capitalización de mercado de PEPE?"

Cuándo usar:

• El usuario pregunta el precio de cualquier token
• El usuario quiere saber si algo está subiendo/bajando
• Analizar fundamentos del token (mcap, liquidez, volumen)
• Comparar tokens
• Configurar alertas de precio

---

2. Cartera de Wallet (mobula_wallet_portfolio)

Endpoint: GET https://api.mobula.io/api/1/wallet/portfolio

Obtén la cartera completa de cualquier wallet en las 88 cadenas en una sola llamada.

Parámetros:

• wallet (requerido): Dirección de wallet
  • Formato: "0x..." o nombre ENS (ej. "vitalik.eth")
• blockchains (opcional): Lista separada por comas para filtrar cadenas específicas
  • Predeterminado: todas las cadenas
• cache (opcional): Usar datos en caché (más rápido, ligeramente menos actualizados)

Devuelve:

• Todos los tokens en cartera con:
  • Nombre, símbolo, dirección del token
  • Saldo (cantidad y valor en USD)
  • Precio actual
  • Cambio de precio 24h
  • Ganancia/pérdida estimada
  • Cadena
• Valor total de la cartera (USD)
• Asignación de cartera por token (porcentajes)
• NFTs (si están presentes)

Ejemplos de uso:

• "Muestra la cartera para la wallet 0x123..."
• "¿Qué tokens tiene vitalik.eth?"
• "Revisa el saldo de mi wallet"
• "¿Cuál es el valor total de esta wallet?"
• "Muéstrame las 5 principales tenencias en esta wallet"

Cuándo usar:

• Seguimiento de cartera
• Análisis de wallet
• Revisar tenencias antes/después de operaciones
• Monitoreo de asignación
• Configurar alertas de cartera

---

3. Datos Históricos de Precio (mobula_market_history)

Endpoint: GET https://api.mobula.io/api/1/market/history

Obtén datos históricos de precio de cualquier token con marcos de tiempo flexibles.

Parámetros:

• asset (requerido): Nombre, símbolo o dirección del token
• from (opcional): Marca de tiempo de inicio (segundos Unix)
• to (opcional): Marca de tiempo de fin (segundos Unix)
• period (opcional): Granularidad de datos
  • Opciones: "1h", "1d", "1w"
  • Predeterminado: seleccionado automáticamente según el marco de tiempo

Devuelve:

• Arreglo de puntos de precio con marcas de tiempo
• Volumen en cada punto
• Capitalización de mercado en cada punto

Ejemplos de uso:

• "Muéstrame el precio de ETH de los últimos 30 días"
• "¿Cuál era el precio de este token el 1 de enero?"
• "¿Este token ha estado subiendo o bajando esta semana?"
• "Grafica el movimiento de precio de BTC en los últimos 7 días"

Cuándo usar:

• Analizar tendencias
• Calcular PnL histórico
• Comparar acción de precio en diferentes marcos de tiempo
• Identificar patrones (rupturas, soportes, resistencias)

---

4. Transacciones Recientes (mobula_market_trades)

Endpoint: GET https://api.mobula.io/api/1/market/trades

Feed de operaciones en vivo de cualquier token en todos los DEX y cadenas.

Parámetros:

• asset (requerido): Nombre, símbolo o dirección del token
• limit (opcional): Número de operaciones a devolver (predeterminado: 50, máximo: 300)

Devuelve:

• Arreglo de operaciones recientes con:
  • Marca de tiempo
  • Tipo (compra/venta)
  • Cantidad (tokens y USD)
  • Precio en la operación
  • Dirección de wallet (comprador/vendedor)
  • DEX y cadena
  • Hash de transacción

Ejemplos de uso:

• "Muestra transacciones recientes para este token"
• "¿Quién está comprando PEPE ahora?"
• "¿Hay movimientos de ballenas en este token?"
• "¿Cuáles son las últimas 10 operaciones de este token?"

Cuándo usar:

• Observación de ballenas
• Detectar actividad inusual (compras/ventas grandes)
• Verificación de volumen
• Análisis de sentimiento (más compras vs ventas)

---

5. Historial de Transacciones de Wallet (mobula_wallet_transactions)

Endpoint: GET https://api.mobula.io/api/1/wallet/transactions

Historial completo de transacciones de cualquier wallet en todas las cadenas.

Parámetros:

• wallet (requerido): Dirección de wallet
• from (opcional): Marca de tiempo de inicio
• to (opcional): Marca de tiempo de fin
• asset (opcional): Filtrar por token específico
• limit (opcional): Número de transacciones (predeterminado: 100)

Devuelve:

• Arreglo de transacciones:
  • Tipo (swap, transfer, mint, burn)
  • Tokens involucrados (de/a)
  • Cantidades
  • Valores en USD al momento de la transacción
  • Marca de tiempo
  • Cadena
  • Hash de transacción

Ejemplos de uso:

• "¿Qué compró recientemente esta wallet?"
• "Muéstrame las últimas 10 transacciones de 0x123..."
• "¿Cuándo vendió ETH esta wallet por última vez?"
• "Rastrea la actividad de esta ballena"

Cuándo usar:

• Monitoreo de wallet
• Seguimiento de ballenas
• Detección de patrones (qué compran/venden)
• Verificación de transacciones

---

6. Datos Multi-Activo (mobula_market_multi)

Endpoint: GET https://api.mobula.io/api/1/market/multi-data

Obtén datos de mercado de múltiples tokens en una sola solicitud (endpoint por lotes).

Parámetros:

• assets (requerido): Lista separada por comas de nombres/símbolos/direcciones de tokens
  • Ejemplo: "Bitcoin,Ethereum,Solana" o "BTC,ETH,SOL"
  • Máximo: 500 tokens por solicitud

Devuelve:

• Mismos datos que mobula_market_data pero para múltiples tokens
• Eficiente para análisis de cartera, listas de seguimiento, resúmenes de mercado

Ejemplos de uso:

• "Compara el rendimiento de BTC, ETH y SOL hoy"
• "Muéstrame los principales movimientos de mi lista de seguimiento"
• "Obtén precios de estos 10 tokens: [lista]"

Cuándo usar:

• Valoración de cartera
• Actualizaciones de lista de seguimiento
• Resumen de mercado (principales monedas)
• Verificaciones de precio por lotes

---

7. Metadatos del Token (mobula_metadata)

Endpoint: GET https://api.mobula.io/api/1/metadata

Obtén metadatos detallados de cualquier token.

Parámetros:

• asset (requerido): Nombre, símbolo o dirección del token

Devuelve:

• Nombre, símbolo, logo
• Descripción
• Enlaces a sitio web, Twitter, Telegram, Discord
• Direcciones de contrato en todas las cadenas
• Fecha de lanzamiento
• Categorías/etiquetas

Ejemplos de uso:

• "Cuéntame sobre este token"
• "¿Cuál es el sitio web de este proyecto?"
• "¿Dónde puedo encontrar su comunidad?"

Cuándo usar:

• Investigación de nuevos tokens
• Verificar legitimidad
• Encontrar enlaces oficiales

---

Autenticación

Requerida: Todas las solicitudes a la API requieren autenticación mediante clave API.

Configuración:

1. Obtén una clave API gratuita en https://mobula.io (100 solicitudes/minuto en el nivel gratuito)
2. Configura la variable de entorno:

   export MOBULA_API_KEY="tu_clave_aqui"
   

3. Reinicia el agente OpenClaw

Formato del encabezado:

Authorization: ${MOBULA_API_KEY}

Si falla la autenticación (401/403):

• Verifica que la clave esté configurada: echo $MOBULA_API_KEY
• Regenera la clave en https://mobula.io si ha expirado
• Revisa los límites de tasa (100 solicitudes/minuto gratis, actualiza para más)

---

Privacidad y Seguridad

IMPORTANTE - Lea Antes de Usar:

Qué Accede Esta Habilidad

• Solo datos de blockchain públicos: Direcciones de wallet, precios de tokens, historial de transacciones
• Sin claves privadas: Nunca proporciones claves privadas, frases semilla o contraseñas a esta habilidad
• Sin credenciales sensibles: La habilidad solo requiere clave API de Mobula (acceso a datos públicos)

Privacidad de Direcciones de Wallet

• Las direcciones de wallet consultadas mediante esta habilidad se envían a la API de Mobula (https://api.mobula.io)
• Consultar una dirección de wallet revela sus tenencias públicamente (los datos en cadena ya son públicos)
• Solo usa direcciones de wallet públicas con las que te sientas cómodo compartiendo
• Nunca ingreses direcciones que quieras mantener privadas o que te vinculen a tu identidad

Alcance de la Clave API

• Las claves API de Mobula proporcionan acceso solo lectura a datos de blockchain públicos
• Las claves se pueden delimitar, rotar y revocar en https://mobula.io
• Nivel gratuito: 100 solicitudes/minuto
• Considera usar una clave API separada para pruebas frente a producción

Retención de Datos

• Mobula puede registrar solicitudes API para análisis y limitación de tasa
• Consulta la política de privacidad de Mobula: https://mobula.io/privacy
• No consultes wallets o datos que consideres sensibles

Mejores Prácticas

1. Usa claves API desechables/de prueba para las pruebas iniciales
2. Solo consulta direcciones de wallet públicas (ej. vitalik.eth, direcciones conocidas)
3. Evita consultar tus wallets personales si deseas privacidad
4. Rota las claves API periódicamente
5. Monitorea los límites de tasa y uso en https://mobula.io

---

Patrones de Monitoreo Inteligente con Heartbeat

El sistema Heartbeat de OpenClaw verifica condiciones cada ~30 minutos. Úsalo para monitoreo proactivo.

Patrón 1: Guardián de Cartera

Cada heartbeat:

1. Obtén la cartera del usuario mediante mobula_wallet_portfolio
2. Calcula porcentajes de asignación
3. Verifica condiciones:
   • Cualquier token >40% de la cartera → sugiere rebalanceo
   • Cualquier token bajó >15% en 24h → alerta con contexto
   • Cartera total cambió >10% → notificar
4. Almacena valores anteriores en memoria para detectar cambios
5. Envía resumen diario a la hora preferida del usuario

Patrón 2: Observación de Ballenas

Cada heartbeat:

1. Verifica transacciones de wallets rastreadas mediante mobula_wallet_transactions
2. Si hay nueva transacción significativa (>$50K):
   • Obtén detalles del token mediante mobula_market_data
   • Verifica transacciones recientes mediante mobula_market_trades
   • Verifica si otras ballenas rastreadas compraron el mismo token
3. Si múltiples ballenas compran → alerta prioritaria

Patrón 3: Explorador de Tokens (Descubrimiento Autónomo)

Cada 4-6 horas en heartbeat:

1. El usuario define criterios (almacenar en memoria):
   • Cadenas: Base, Arbitrum
   • Capitalización de mercado: <$5M
   • Liquidez: >$100K
   • Cambio de volumen 24h: >+50%
2. Busca/filtra tokens mediante consultas mobula_market_data
3. Para cada coincidencia:
   • Obtén historial de 7 días mediante mobula_market_history
   • Verifica metadatos mediante mobula_metadata
   • Calcula puntuación de riesgo
4. Envía los 3 mejores con análisis

Patrón 4: Alertas de Precio Inteligentes

En lugar de alertas simples "precio > X", crea alertas contextuales:

Ejemplo: "Alértame si Bitcoin se mueve >5% en 1 hora PERO solo si el volumen es 2x por encima del promedio de 24h"

Cada heartbeat:

1. Obtén precio y volumen actuales mediante mobula_market_data
2. Compara con el precio de hace 1 hora (almacenado en memoria)
3. Verifica si se cumple la condición de volumen
4. Solo alerta si AMBAS condiciones son verdaderas

---

Combinando Múltiples Endpoints para Información Enriquecida

Ejemplo: Análisis Completo de Token

Usuario pregunta: "¿Debería comprar este token?"

1. mobula_market_data → precio actual, mcap, volumen, liquidez
2. mobula_market_history → tendencia de 7d y 30d
3. mobula_market_trades → actividad reciente (¿acumulación o distribución?)
4. mobula_metadata → información del proyecto, redes sociales, verificación de contrato

Formato de respuesta:

Análisis de TOKEN

Precio: $0.042 (bajó 8% 24h, subió 156% 7d)
- Cerca del máximo de 7d, bajó desde $0.051
- Aún subió 400% desde el mínimo de 30d

Fundamentos:
- Mcap: $2.1M (pequeña capitalización, alto riesgo/recompensa)
- Liquidez: $280K (decente para el tamaño)
- Volumen: $1.2M 24h (saludable)

En cadena:
- Transacciones recientes muestran presión de compra (proporción 3:1 compra/venta)
- 2 compras grandes ($50K+) en las últimas 2h

Proyecto:
- Contrato verificado
- Twitter activo (12K seguidores)

Riesgo: Pequeña capitalización, alta volatilidad. No inviertas más de lo que puedas perder.

---

Directrices de Formato de Respuesta

Precios

• Siempre muestra la dirección: "subió 12.4%" o "bajó 3.2%"
• Incluye marco de tiempo: "subió 12.4% (24h)"
• Añade contexto: "Precio $0.042 (subió 12% 24h, bajó 8% desde ATH)"

Números Grandes

• Formato claro: "$1.23M", "$456K", "$45.6B"
• No: "$1234567"

Porcentajes

• Usa para asignaciones: "ETH: 42% de la cartera"
• Usa para cambios: "bajó 15.3% en 24h"

El Contexto es Clave

No digas solo "el precio es $0.003" Di: "Precio $0.003 (bajó 8% 24h, bajó 65% desde ATH de $0.089 el 1 de diciembre, pero subió 12% desde el mínimo de 7d)"

---

Solicitudes Comunes de Usuarios y Cómo Manejarlas

"Configura alertas para [token]"

1. Reconoce la solicitud
2. Pide condiciones específicas (¿umbral de precio? ¿movimiento porcentual? ¿pico de volumen?)
3. Confirma que monitorearás mediante heartbeat
4. Almacena la configuración de alerta en memoria
5. Confirma: "Revisaré [token] cada 30min y te alertaré en [canal] si [condición]"

"Rastrea esta wallet"

1. Agrega la wallet a la lista de monitoreo
2. Pregunta qué vigilar:
   • ¿Toda la actividad?
   • ¿Solo transacciones grandes (>$X)?
   • ¿Tokens específicos?
3. Almacena en memoria
4. Confirma que el monitoreo está activo

"Encuentra tokens que coincidan con [criterios]"

1. Aclara los criterios:
   • ¿Cadenas?
   • ¿Rango de capitalización de mercado?
   • ¿Requisitos de volumen?
   • ¿Mínimo de liquidez?
2. Configura verificaciones periódicas (sugiere intervalo de 4-6h)
3. Pregunta cuántos resultados quieren
4. Inicia el monitoreo en el próximo heartbeat

"¿Qué está pasando en cripto ahora?"

1. Verifica los tokens principales (BTC, ETH, SOL, BNB) mediante mobula_market_multi
2. Identifica movimientos importantes (>5% en 24h)
3. Verifica los líderes en volumen
4. Proporciona un resumen conciso

---

Manejo de Errores

Problemas con la Clave API

• Sin clave configurada: "Necesito una clave API de Mobula para obtener datos de cripto. Consigue una gratis en https://mobula.io y luego agrégala a tu entorno con export MOBULA_API_KEY='tu_clave'"
• Clave inválida: "Tu clave API parece inválida o ha expirado. Regenera una en https://mobula.io"

Límites de Tasa

• Si recibes 429 o error de límite de tasa: "Has alcanzado el límite de tasa de API de Mobula (100 solicitudes/minuto). Espera un minuto o actualiza tu plan en https://mobula.io"

Datos No Encontrados

• Si no se encuentra el token: "No pude encontrar datos para [token]. Verifica que el nombre, símbolo o dirección del contrato sea correcto."
• Si no se encuentra la wallet: "No pude recuperar datos para esta wallet. Verifica la dirección."

Problemas de Red

• Si la API no responde: "La API de Mobula no está respondiendo actualmente. Inténtalo de nuevo más tarde."
• Timeout: "La solicitud tardó demasiado. Inténtalo de nuevo o verifica tu conexión."

---

Consejos y Trucos

Búsqueda Inteligente de Tokens

• Busca por nombre: "Bitcoin" o "BTC"
• Busca por símbolo: "ETH" para Ethereum
• Busca por dirección de contrato: dirección 0x...
• Agrega cadena para precisión: "BRETT en Base"

Optimización de Wallet

• Usa nombres ENS si están disponibles (más rápido, más legible)
• Filtra por cadenas específicas para acelerar las respuestas
• Usa almacenamiento en caché para consultas frecuentes

Análisis de Mercado

• Combina múltiples endpoints para una visión completa
• Usa datos históricos para contexto
• Verifica transacciones para detección de tendencias en tiempo real

Patrones de Monitoreo

• Usa heartbeat para monitoreo continuo
• Almacena datos en memoria para comparaciones
• Crea alertas contextuales para reducir ruido
• Configura intervalos de verificación apropiados

---

Integración con Otras Habilidades

Habilidades Complementarias

• bankr: Para ejecutar operaciones después del análisis
• defi: Para cotizaciones DEX y ejecución de swaps
• okx/binance: Para datos específicos de intercambios centralizados
• wallet: Para gestión de múltiples wallets

Flujos de Trabajo Recomendados

1. Investigación → Análisis → Ejecución:

   • Usa Mobula para encontrar y analizar tokens
   • Usa defi para verificar cotizaciones
   • Usa bankr para ejecutar operaciones

2. Monitoreo → Alerta → Acción:

   • Monitorea con Mobula heartbeat
   • Recibe alertas cuando se cumplan condiciones
   • Usa habilidades relacionadas para actuar sobre alertas

3. Cartera → Análisis → Rebalanceo:

   • Rastrea cartera con Mobula
   • Analiza asignación y rendimiento
   • Usa defi/bankr para rebalancear

---

Referencia Rápida

Función	Endpoint	Principal Uso
Datos de Mercado	/market/data	Precios, mcap, volumen, liquidez
Cartera	/wallet/portfolio	Tenencias, valor, asignación
Historial	/market/history	Datos históricos de precio
Transacciones	/market/trades	Actividad reciente de trading
Transacciones Wallet	/wallet/transactions	Historial completo de wallet
Multi-Datos	/market/multi-data	Datos por lotes de múltiples tokens
Metadatos	/metadata	Información del proyecto, enlaces

Para más información, visita: https://mobula.io