LeoYeAI/openclaw-master-skills

Mobula - Inteligência de Dados Cripto Multicadeia

Dados de mercado cripto em tempo real, rastreamento de carteiras e análises on-chain em mais de 88 blockchains. Preços de nível oracular confiáveis pela Chainlink, Supra e API3.

Quando Usar Esta Skill

USE QUANDO o usuário:

• Perguntar sobre preço, volume, capitalização de mercado ou variação de preço de qualquer token
• Quiser verificar os ativos ou o valor de uma carteira
• Precisar de dados históricos de preços para gráficos ou análises
• Mencionar um endereço de contrato e quiser informações sobre o token
• Perguntar sobre tokens em chains específicas (Base, Arbitrum, Solana, etc.)
• Quiser uma visão geral do portfólio entre chains
• Precisar de dados em lote sobre vários tokens de uma vez
• Perguntar sobre liquidez do token, ATH, ATL ou volume de negociação
• Quiser rastrear carteiras de baleias ou monitorar transações significativas
• Precisar encontrar novos tokens que correspondam a critérios específicos

NÃO USE QUANDO:

• O usuário quiser executar negociações (use a skill bankr)
• O usuário quiser cotações de swap DEX (use a skill defi)
• O usuário quiser dados específicos de exchanges (use as skills okx/binance)

---

Capacidades Principais

1. Dados de Mercado (mobula_market_data)

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

Obtenha preço, volume, capitalização de mercado e liquidez em tempo real para qualquer token em todas as chains suportadas.

Parâmetros:

• asset (obrigatório): Nome do token, símbolo ou endereço do contrato
  • Exemplos: "Bitcoin", "ETH", "0x532f27101965dd16442e59d40670faf5ebb142e4"
• blockchain (opcional): Chain específica para consultar
  • Exemplos: "base", "arbitrum", "ethereum", "solana", "polygon"

Retorna:

• Preço atual (USD)
• Variações de preço: 1h, 24h, 7d, 30d (percentual e absoluto)
• Volume (24h)
• Capitalização de mercado
• Valuation totalmente diluída
• Liquidez
• Máxima histórica (ATH) e mínima histórica (ATL) com datas
• Oferta total, oferta circulante

Exemplos de uso:

• "Qual é o preço do Bitcoin?"
• "Mostre-me os dados de mercado do BRETT na Base"
• "Obter dados para o contrato 0x532f27101965dd16442e59d40670faf5ebb142e4"
• "O ETH está bombando ou despencando agora?"
• "Qual é a capitalização de mercado do PEPE?"

Quando usar:

• O usuário perguntar o preço de qualquer token
• O usuário quiser saber se algo está subindo/despencando
• Analisar fundamentos do token (mcap, liquidez, volume)
• Comparar tokens
• Configurar alertas de preço

---

2. Portfólio de Carteira (mobula_wallet_portfolio)

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

Obtenha o portfólio completo de qualquer carteira em todas as 88 chains em uma única chamada.

Parâmetros:

• wallet (obrigatório): Endereço da carteira
  • Formato: "0x..." ou nome ENS (ex.: "vitalik.eth")
• blockchains (opcional): Lista separada por vírgulas para filtrar chains específicas
  • Padrão: todas as chains
• cache (opcional): Usar dados em cache (mais rápido, ligeiramente menos atualizados)

Retorna:

• Todos os tokens mantidos com:
  • Nome, símbolo, endereço
  • Saldo (quantidade e valor em USD)
  • Preço atual
  • Variação de preço 24h
  • Lucro/prejuízo estimado
  • Chain
• Valor total do portfólio (USD)
• Alocação do portfólio por token (percentuais)
• NFTs (se presentes)

Exemplos de uso:

• "Mostre o portfólio da carteira 0x123..."
• "Quais tokens o vitalik.eth possui?"
• "Verificar meu saldo da carteira"
• "Qual é o valor total desta carteira?"
• "Mostre-me as 5 principais participações nesta carteira"

Quando usar:

• Rastreamento de portfólio
• Análise de carteira
• Verificar participações antes/depois de negociações
• Monitorar alocação
• Configurar alertas de portfólio

---

3. Dados Históricos de Preços (mobula_market_history)

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

Obtenha dados históricos de preços para qualquer token com prazos flexíveis.

Parâmetros:

• asset (obrigatório): Nome do token, símbolo ou endereço
• from (opcional): Timestamp de início (segundos Unix)
• to (opcional): Timestamp de fim (segundos Unix)
• period (opcional): Granularidade dos dados
  • Opções: "1h", "1d", "1w"
  • Padrão: selecionado automaticamente com base no período

Retorna:

• Array de pontos de preço com timestamps
• Volume em cada ponto
• Capitalização de mercado em cada ponto

Exemplos de uso:

• "Mostre-me o preço do ETH nos últimos 30 dias"
• "Qual era o preço deste token em 1º de janeiro?"
• "Este token está bombando ou despencando esta semana?"
• "Gráfico do movimento de preço do BTC nos últimos 7 dias"

Quando usar:

• Analisar tendências
• Calcular PnL histórico
• Comparar ação de preço entre períodos
• Identificar padrões (rompimentos, suportes, resistências)

---

4. Negociações Recentes (mobula_market_trades)

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

Feed de negociações ao vivo para qualquer token em todos os DEXs e chains.

Parâmetros:

• asset (obrigatório): Nome do token, símbolo ou endereço
• limit (opcional): Número de negociações a retornar (padrão: 50, máximo: 300)

Retorna:

• Array de negociações recentes com:
  • Timestamp
  • Tipo (compra/venda)
  • Quantidade (tokens e USD)
  • Preço na negociação
  • Endereço da carteira (comprador/vendedor)
  • DEX e chain
  • Hash da transação

Exemplos de uso:

• "Mostre negociações recentes para este token"
• "Quem está comprando PEPE agora?"
• "Algum movimento de baleia neste token?"
• "Quais foram as últimas 10 negociações neste token?"

Quando usar:

• Observação de baleias
• Detectar atividade incomum (grandes compras/vendas)
• Verificação de volume
• Análise de sentimento (mais compras vs vendas)

---

5. Histórico de Transações da Carteira (mobula_wallet_transactions)

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

Histórico completo de transações para qualquer carteira em todas as chains.

Parâmetros:

• wallet (obrigatório): Endereço da carteira
• from (opcional): Timestamp de início
• to (opcional): Timestamp de fim
• asset (opcional): Filtrar por token específico
• limit (opcional): Número de transações (padrão: 100)

Retorna:

• Array de transações:
  • Tipo (swap, transfer, mint, burn)
  • Tokens envolvidos (de/para)
  • Quantidades
  • Valores em USD no momento da transação
  • Timestamp
  • Chain
  • Hash da transação

Exemplos de uso:

• "O que esta carteira comprou recentemente?"
• "Mostre-me as últimas 10 transações para 0x123..."
• "Quando esta carteira vendeu ETH pela última vez?"
• "Rastreie a atividade desta baleia"

Quando usar:

• Monitoramento de carteira
• Rastreamento de baleias
• Detecção de padrões (o que compram/vendem)
• Verificação de transações

---

6. Dados de Múltiplos Ativos (mobula_market_multi)

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

Obtenha dados de mercado para vários tokens em uma única requisição (endpoint em lote).

Parâmetros:

• assets (obrigatório): Lista separada por vírgulas de nomes/símbolos/endereços de tokens
  • Exemplo: "Bitcoin,Ethereum,Solana" ou "BTC,ETH,SOL"
  • Máximo: 500 tokens por requisição

Retorna:

• Mesmos dados de mobula_market_data mas para vários tokens
• Eficiente para análise de portfólio, listas de observação, visão geral do mercado

Exemplos de uso:

• "Compare o desempenho de BTC, ETH e SOL hoje"
• "Mostre-me os maiores movimentadores da minha lista de observação"
• "Obter preços para estes 10 tokens: [lista]"

Quando usar:

• Avaliação de portfólio
• Atualizações de lista de observação
• Visão geral do mercado (principais moedas)
• Verificações de preço em lote

---

7. Metadados do Token (mobula_metadata)

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

Obtenha metadados detalhados para qualquer token.

Parâmetros:

• asset (obrigatório): Nome do token, símbolo ou endereço

Retorna:

• Nome, símbolo, logotipo
• Descrição
• Links para site, Twitter, Telegram, Discord
• Endereços de contrato em todas as chains
• Data de lançamento
• Categorias/tags

Exemplos de uso:

• "Fale-me sobre este token"
• "Qual é o site deste projeto?"
• "Onde posso encontrar a comunidade deles?"

Quando usar:

• Pesquisa sobre novos tokens
• Verificar legitimidade
• Encontrar links oficiais

---

Autenticação

Obrigatório: Todas as requisições à API exigem autenticação via chave de API.

Configuração:

1. Obtenha uma chave de API gratuita em https://mobula.io (nível gratuito: 100 requisições/minuto)
2. Defina a variável de ambiente:

   export MOBULA_API_KEY="sua_chave_aqui"
   

3. Reinicie o agente OpenClaw

Formato do cabeçalho:

Authorization: ${MOBULA_API_KEY}

Se a autenticação falhar (401/403):

• Verifique se a chave está definida: echo $MOBULA_API_KEY
• Regere a chave em https://mobula.io se expirou
• Verifique os limites de taxa (100 req/min gratuitas, upgrade para mais)

---

Privacidade e Segurança

IMPORTANTE - Leia Antes de Usar:

O Que Esta Skill Acessa

• Apenas dados públicos de blockchain: Endereços de carteira, preços de tokens, histórico de transações
• Sem chaves privadas: Nunca forneça chaves privadas, frases-semente ou senhas para esta skill
• Sem credenciais sensíveis: A skill requer apenas a chave de API Mobula (acesso a dados públicos)

Privacidade do Endereço da Carteira

• Endereços de carteira consultados através desta skill são enviados para a API da Mobula (https://api.mobula.io)
• Consultar um endereço de carteira revela seus ativos publicamente (dados on-chain já são públicos)
• Use apenas endereços de carteira pública com os quais você se sinta confortável em compartilhar
• Nunca insira endereços que você queira manter privados ou que estejam vinculados à sua identidade

Escopo da Chave de API

• As chaves de API Mobula fornecem acesso somente leitura a dados públicos de blockchain
• As chaves podem ser escopadas, rotacionadas e revogadas em https://mobula.io
• Nível gratuito: 100 requisições/minuto
• Considere usar uma chave de API separada para testes vs produção

Retenção de Dados

• A Mobula pode registrar requisições à API para análises e limitação de taxa
• Consulte a política de privacidade da Mobula: https://mobula.io/privacy
• Não consulte carteiras ou dados que você considere sensíveis

Melhores Práticas

1. Use chaves de API descartáveis/de teste para testes iniciais
2. Consulte apenas endereços de carteira pública (ex.: vitalik.eth, endereços conhecidos)
3. Evite consultar suas carteiras pessoais se quiser privacidade
4. Rotacione as chaves de API periodicamente
5. Monitore os limites de taxa e uso em https://mobula.io

---

Padrões de Monitoramento Inteligente com Heartbeat

O sistema de heartbeat do OpenClaw verifica condições a cada ~30 minutos. Use isso para monitoramento proativo.

Padrão 1: Guardião de Portfólio

A cada heartbeat:

1. Buscar a carteira do usuário via mobula_wallet_portfolio
2. Calcular percentuais de alocação
3. Verificar condições:
   • Qualquer token >40% do portfólio → sugerir rebalanceamento
   • Qualquer token caindo >15% em 24h → alertar com contexto
   • Portfólio total mudou >10% → notificar
4. Armazenar valores anteriores na memória para detectar mudanças
5. Enviar resumo diário no horário preferido do usuário

Padrão 2: Observação de Baleias

A cada heartbeat:

1. Verificar transações para carteiras rastreadas via mobula_wallet_transactions
2. Se nova transação significativa (>$50K):
   • Obter detalhes do token via mobula_market_data
   • Verificar negociações recentes via mobula_market_trades
   • Verificar se outras baleias rastreadas compraram o mesmo token
3. Se várias baleias comprando → alerta prioritário

Padrão 3: Explorador de Tokens (Descoberta Autônoma)

A cada 4-6 horas no heartbeat:

1. Usuário define critérios (armazenar na memória):
   • Chains: Base, Arbitrum
   • Capitalização de mercado: <$5M
   • Liquidez: >$100K
   • Mudança de volume 24h: >+50%
2. Pesquisar/filtrar tokens via consultas mobula_market_data
3. Para cada correspondência:
   • Obter histórico de 7 dias via mobula_market_history
   • Verificar metadados via mobula_metadata
   • Calcular pontuação de risco
4. Enviar os 3 principais com análise

Padrão 4: Alertas Inteligentes de Preço

Em vez de alertas simples "preço > X", crie alertas contextuais:

Exemplo: "Alerta-me se o Bitcoin mover >5% em 1 hora, MAS apenas se o volume estiver 2x acima da média de 24h"

A cada heartbeat:

1. Obter preço e volume atuais via mobula_market_data
2. Comparar com o preço de 1 hora atrás (armazenado na memória)
3. Verificar se a condição de volume foi atendida
4. Alertar apenas se AMBAS as condições forem verdadeiras

---

Combinando Múltiplos Endpoints para Insights Ricos

Exemplo: Análise Completa de Token

Usuário pergunta: "Devo comprar este token?"

1. mobula_market_data → preço atual, mcap, volume, liquidez
2. mobula_market_history → tendência de 7d e 30d
3. mobula_market_trades → atividade recente (acumulação ou distribuição?)
4. mobula_metadata → informações do projeto, redes sociais, verificação do contrato

Formato de resposta:

Análise do TOKEN

Preço: $0.042 (caindo 8% 24h, subindo 156% 7d)
- Próximo da máxima de 7d, caindo de $0.051
- Ainda subindo 400% da mínima de 30d

Fundamentos:
- Mcap: $2.1M (small cap, alto risco/recompensa)
- Liquidez: $280K (decente para o tamanho)
- Volume: $1.2M 24h (saudável)

On-chain:
- Negociações recentes mostram pressão de compra (proporção 3:1 compra/venda)
- 2 grandes compras ($50K+) nas últimas 2h

Projeto:
- Contrato verificado
- Twitter ativo (12K seguidores)

Risco: Small cap, alta volatilidade. Não invista mais do que pode perder.

---

Diretrizes de Formatação de Resposta

Preços

• Sempre mostrar direção: "subindo 12,4%" ou "caindo 3,2%"
• Incluir período: "subindo 12,4% (24h)"
• Adicionar contexto: "Preço $0.042 (subindo 12% 24h, caindo 8% do ATH)"

Números Grandes

• Formatar claramente: "$1.23M", "$456K", "$45.6B"
• Não: "$1234567"

Percentagens

• Use para alocações: "ETH: 42% do portfólio"
• Use para mudanças: "caindo 15,3% em 24h"

Contexto é Fundamental

Não diga apenas "o preço é $0.003" Diga: "Preço $0.003 (caindo 8% 24h, caindo 65% do ATH de $0.089 em 1º de dezembro, mas subindo 12% da mínima de 7d)"

---

Solicitações Comuns de Usuários e Como Lidar

"Configure alertas para [token]"

1. Reconheça a solicitação
2. Pergunte por condições específicas (limite de preço? movimento percentual? pico de volume?)
3. Confirme que você monitorará via heartbeat
4. Armazene a configuração do alerta na memória
5. Confirme: "Vou verificar [token] a cada 30min e alertá-lo no [canal] se [condição]"

"Rastreie esta carteira"

1. Adicione a carteira à lista de monitoramento
2. Pergunte o que observar:
   • Toda atividade?
   • Apenas grandes negociações (>$X)?
   • Tokens específicos?
3. Armazene na memória
4. Confirme que o monitoramento está ativo

"Encontre tokens que correspondam a [critérios]"

1. Esclareça os critérios:
   • Chains?
   • Faixa de capitalização de mercado?
   • Requisitos de volume?
   • Liquidez mínima?
2. Configure verificações periódicas (sugira intervalo de 4-6h)
3. Pergunte quantos resultados eles desejam
4. Inicie o monitoramento no próximo heartbeat

"O que está acontecendo no cripto agora?"

1. Verifique os principais tokens (BTC, ETH, SOL, BNB) via mobula_market_multi
2. Identifique quaisquer movimentos significativos (>5% em 24h)
3. Verifique os líderes de volume
4. Forneça uma visão geral concisa

---

Tratamento de Erros

Problemas com Chave de API

• Nenhuma chave definida: "Preciso de uma chave de API Mobula para buscar dados cripto. Obtenha uma gratuitamente em https://mobula.io e depois adicione ao seu ambiente com export MOBULA_API_KEY='sua_chave'"
• Chave inválida: "Sua chave de API Mobula parece ser inválida ou expirou. Gere uma nova em https://mobula.io"
• Limite de taxa atingido: "Atingimos o limite de taxa da API Mobula (100 req/min). Aguarde um momento ou faça upgrade para um nível superior em https://mobula.io"

Problemas com Ativos

• Token não encontrado: "Não consegui encontrar dados para '{asset}'. Verifique se o nome, símbolo ou endereço do contrato está correto."
• Endereço de contrato inválido: "'{address}' não parece ser um endereço de contrato válido. Os endereços Ethereum normalmente começam com '0x' seguido por 40 caracteres hexadecimais."
• Token não suportado na chain: "Parece que este token não está disponível na chain '{blockchain}'. Tente omitir o parâmetro blockchain para verificar todas as chains."

Problemas com Carteira

• Carteira não encontrada: "Não consegui encontrar dados para '{wallet}'. Verifique se o endereço está correto."
• Carteira vazia: "Esta carteira parece não ter ativos significativos ou pode ser nova."

Erros Gerais da API

• Tempo limite da API: "A API Mobula está demorando para responder. Tentando novamente..."
• Erro interno do servidor (500): "A API Mobula está enfrentando um problema temporário. Tente novamente em alguns instantes."
• Dados não disponíveis: "Dados históricos completos podem não estar disponíveis para tokens mais novos. Retornando os melhores dados disponíveis."

---

Dicas e Padrões Avançados

Estratégia de Cache para Eficiência

• Armazene na memória dados solicitados com frequência (preços BTC/ETH)
• Atualize a cada heartbeat (30min) em vez de a cada consulta
• Use dados em cache para respostas rápidas "olá, mundo"
• Dados históricos podem ser armazenados em cache por mais tempo (não mudam)

Análise de Portfólio Contextual

Quando um usuário pergunta sobre seu portfólio:

1. Buscar todos os ativos via mobula_wallet_portfolio
2. Calcular:
   • Exposição por chain
   • Concentração setorial
   • Correlação com BTC (se histórico disponível)
3. Identificar:
   • Ativos com maior participação (risco de concentração)
   • Ativos com pior desempenho (candidatos a corte de perdas)
   • Ativos com melhor desempenho (candidatos a realização de lucros)
4. Sugerir:
   • Alocação alvo (ex.: 60% blue chips, 30% mid-caps, 10% small caps)
   • Rebalanceamento se a alocação mudou significativamente

Alças de Mercado para Respostas Rápidas

• Mercado em alta: BTC subindo >2% em 24h e a maioria das altcoins seguindo
• Mercado em baixa: BTC caindo >2% em 24h com vendas generalizadas
• Lateral: Movimento mínimo (<1%) na maioria dos tokens
• Temporada de altcoins: Altcoins superando significativamente o BTC em ganhos percentuais
• Medo: Quedas acentuadas, alto volume de vendas, sentimento negativo
• Ganância: Forte momentum de alta, FOMO, novas máximas

Use esses termos ao descrever o sentimento geral do mercado para dar respostas com contexto.

---

Exemplos de Prompt Rápido

Solicitações Simples

• "Preço do BTC"
• "Portfólio vitalik.eth"
• "BTC histórico 7d"
• "Metadados do PEPE"
• "BTC,ETH,SOL comparação"
• "Negociações recentes para ETH"
• "Transações para 0x123..."

Solicitações Complexas

• "Mostre-me os tokens com melhor desempenho na minha carteira este mês"
• "Esta baleia está acumulando ou distribuindo?"
• "Qual é o sentimento do mercado hoje?"
• "Encontre novos tokens na Base com alto volume e baixa capitalização"
• "Configure um alerta se o ETH cair abaixo de $3000 com volume acima da média"
• "Rastreie a carteira 0x456... e me avise se eles comprarem mais de $100K em qualquer token"