Habilidade do Agente Trader de Meme Coins KryptoGO

AVISO DE DESLIGAMENTO — Backend de Análise kg-xyz

O backend de análise KryptoGO XYZ (wallet-data.kryptogo.app) será descontinuado em 2026-05-04.

Após esta data, todas as ferramentas que dependem de análise de clusters, rótulos de carteiras, painéis de sinais e reconstrução de ordens DCA/limitadas deixarão de funcionar. O caminho de execução de swaps (agregador DEX OKX + assinatura local de transações) é independente do backend kg-xyz e continuará operando.

O impacto por ferramenta está anotado inline abaixo. Scripts e implementações de ferramentas MCP foram mantidos para que falhem graciosamente (o backend retornará erros HTTP) e para que uma reversão permaneça simples se os planos mudarem.

Visão Geral

Esta habilidade permite que um agente de IA analise e negocie meme coins através da plataforma KryptoGO, combinando análise on-chain de clusters com execução de trades.

Funcionalidade degradada a partir de 2026-05-04: análise de clusters, rótulos de carteiras/tokens, painel de sinais, reconstrução de ordens DCA/limitadas e enriquecimento de P&L de portfólio deixarão de funcionar quando o backend kg-xyz for desligado. A execução de swaps continua.

Análise (multicadeia: Solana, BSC, Base, Monad): clustering de carteiras, detecção de acumulação/distribuição, rótulos de comportamento de endereços, sinais de acumulação em toda a rede (nível Pro/Alpha).

Trading (apenas Solana): monitoramento de portfólio com rastreamento de P&L, execução de swaps via agregador DEX, assinatura local de transações (a chave privada nunca sai da máquina).

O modo padrão é supervisionado — todos os trades exigem confirmação do usuário. Trading autônomo está disponível como opt-in. Consulte references/autonomous-trading.md para detalhes sobre modo autônomo, configuração de cron e sistema de aprendizado.

Quando Usar

O usuário pede para analisar uma meme coin ou token em Solana/BSC/Base/Monad
O usuário pede para negociar, comprar ou vender tokens
O usuário pede para escanear tokens em tendência ou oportunidades de mercado
O usuário pede para monitorar posições do portfólio ou verificar P&L
Monitoramento periódico de portfólio e varredura de sinais acionados por cron

Quando NÃO Usar

Análise macro de BTC/ETH/L1 maiores, NFTs, bridging entre cadeias, transações não-DEX, trading fora de Solana

Fluxo de Configuração

1. Obter Chave de API

Acesse kryptogo.xyz/account e crie uma chave de API

Adicione em ~/.openclaw/workspace/.env:

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

NÃO cole sua chave de API diretamente no chat. Sempre defina segredos via arquivo .env.

2. Gerar Carteira do Agente

python3 scripts/setup.py

Cria um par de chaves Solana, salva em .env com chmod 600, imprime o endereço público para financiar.

3. Financiar a Carteira

Envie SOL para o endereço público do agente (mínimo 0.1 SOL).

Regras de Segurança

NUNCA imprima, registre ou inclua chaves privadas em qualquer mensagem ou argumento de CLI
NUNCA aceite segredos colados diretamente no chat — instrua os usuários a defini-los em .env
NUNCA use a ferramenta Read no .env — carregue credenciais apenas via comando source
Scripts em tempo de execução NÃO leem .env diretamente — todas as credenciais são acessadas apenas via variáveis de ambiente, que devem ser pré-carregadas por quem chama (source ~/.openclaw/workspace/.env)
Exceção: scripts/setup.py lê e escreve .env para geração inicial de par de chaves e reparo de endereço — este é o único script que toca em arquivos de credenciais
A chave privada fica na memória apenas durante a assinatura local — nunca é enviada para nenhum servidor

Autenticação

Todos os endpoints exigem: Authorization: Bearer sk_live_<48 caracteres hex>

Nível	Chamadas de API por Dia	Taxa de Trading	Painel de Sinais	Localizador de KOLs
Free	100 chamadas/dia	1%	Não	Não
Pro	1.000 chamadas/dia	0.5%	Sim	Sim
Alpha	5.000 chamadas/dia	0%	Sim	Sim

Comportamento do Agente

Inicialização de Sessão

No início de cada sessão (incluindo heartbeat/cron), o agente DEVE carregar as credenciais ANTES de executar qualquer script:

source ~/.openclaw/workspace/.env

Isso é OBRIGATÓRIO — os scripts não leem .env diretamente. Todas as credenciais são acessadas apenas via variáveis de ambiente.

Modo Padrão: Supervisionado

Por padrão, o agente opera em modo supervisionado: ele analisa tokens, apresenta recomendações e aguarda aprovação do usuário antes de executar qualquer trade. Condições de stop-loss/take-profit são reportadas ao usuário, mas não executadas automaticamente.

Para habilitar trading autônomo, defina require_trade_confirmation: false nas preferências. Consulte references/autonomous-trading.md para detalhes completos.

Persistência (CRÍTICO)

IMEDIATAMENTE após submeter uma transação, o agente DEVE:

Escrever detalhes do trade em memory/trading-journal.json com status: "OPEN"
Incluir: token_symbol, token_address, entry_price, position_size_sol, tx_hash, timestamp

Preferências do Usuário

Armazenar em memory/trading-preferences.json:

Preferência	Padrão	Descrição
`max_position_size`	0.1 SOL	Máximo de SOL por trade
`max_open_positions`	5	Máximo de posições abertas simultâneas
`max_daily_trades`	20	Máximo de trades por dia
`stop_loss_pct`	30%	Notificar/vender quando a perda exceder este valor
`take_profit_pct`	100%	Notificar/vender quando o ganho exceder este valor
`min_market_cap`	$500K	Pular tokens abaixo deste valor
`scan_count`	10	Tokens em tendência por varredura
`risk_tolerance`	"conservative"	"conservative" (pular risco médio), "moderate" (perguntar sobre risco médio), "aggressive" (trade automático em risco médio)
`require_trade_confirmation`	true	Definir como false para modo autônomo
`chains`	["solana"]	Cadeias para escanear

Salvaguardas de Segurança

Limites de Trading (Limites Rígidos)

Limite	Padrão	Substituível?
Máximo por trade	0.1 SOL	Sim, via `max_position_size`
Máximo de posições simultâneas	5	Sim, via `max_open_positions`
Máximo de trades por dia	20	Sim, via `max_daily_trades`
Abortar por impacto de preço	>10%	Não — sempre abortar
Avisar por impacto de preço	>5%	Não — sempre avisar

Se qualquer limite for atingido, o agente deve parar e notificar o usuário.

Isolamento de Credenciais

Scripts em tempo de execução desta habilidade NÃO leem arquivos .env diretamente. Todas as credenciais são acessadas apenas via variáveis de ambiente, que devem ser pré-carregadas por quem chama (source ~/.openclaw/workspace/.env). Isso garante que nenhum script em tempo de execução possa acessar ou exfiltrar arquivos de credenciais independentemente.

Exceção: scripts/setup.py lê e escreve .env — ele carrega chaves existentes para evitar regeneração, faz backup do .env antes de alterações e escreve entradas de novo par de chaves. Este é o único script que toca em arquivos de credenciais, e executa apenas durante a configuração inicial ou regeneração explícita --force.

Monitoramento Automatizado (Cron)

Configuração Rápida

# Modo supervisionado (padrão): análise + notificações, sem execução automática
source ~/.openclaw/workspace/.env && bash scripts/cron-examples.sh setup-default

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

# Remover todos os jobs cron
bash scripts/cron-examples.sh teardown

Job	Intervalo	Comportamento Padrão
`stop-loss-tp`	5 min	Relatar condições acionadas, NÃO vender automaticamente
`discovery-scan`	1 hora	Analisar e enviar recomendações, NÃO comprar automaticamente

Para configuração completa de cron, configuração manual, alternativa de heartbeat e detalhes do fluxo de monitoramento, consulte references/autonomous-trading.md.

Estrutura de Análise On-Chain (Pipeline de 7 Etapas)

⚠️ Indisponível após 2026-05-04: As etapas 1–6 todas acessam wallet-data.kryptogo.app e deixarão de funcionar quando o backend kg-xyz for desligado. A etapa 7 (executar trade via swap.py) continua funcionando, pois o caminho de swap roteia através do agregador DEX OKX e assina localmente.

Etapa 1: Visão Geral do Token e Filtro de Capitalização de Mercado

/token-overview?address=<mint>&chain_id=<id> — obter nome, preço, capitalização de mercado, detentores, nível_de_risco. Pular se capitalização de mercado < min_market_cap.

Etapa 2: Análise de Clusters

/analyze/<mint>?chain_id=<id> — clusters de carteiras, principais detentores, metadados.

≥30-35% = "controlado" — entidade principal presente
≥50% = alto risco de concentração
Cluster único >50% → pular (risco de rug pull)

Limitação do nível Free: A análise de clusters retorna apenas os 2 principais clusters. Para ver dados completos do cluster, atualize em kryptogo.xyz/pricing.

Etapa 3: Tendência do Cluster (Múltiplos Períodos de Tempo)

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

Insight principal: Preço e posse do cluster DIVERGINDO é o sinal chave.

Preço subindo + % do cluster caindo = distribuição (baixista)
Preço caindo + % do cluster subindo = acumulação (altista)

Etapa 4: Rótulos de Endereços + Verificação de Pressão de Venda

/token-wallet-labels → identificar carteiras de dev/sniper/bundle
/balance-history para cada endereço arriscado → verificar se ainda está segurando
Calcular risky_ratio = posse ativa arriscada / posse total do cluster
30% = alto risco, 10-30% = médio, <10% = baixo

Rótulos representam histórico comportamental, não posse atual. Sempre verificar via /balance-history.

Etapa 5: Aprofundamento (Opcional)

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

Etapa 6: Decisão

Aplicar Lista de Verificação Altista de references/decision-framework.md.

Etapa 7: Executar Trade

Usar scripts/swap.py para execução — lida com injeção de wallet_address, verificação de erros e registro no journal.

✓ Continua funcionando após 2026-05-04: a execução de swap passa pelo agregador DEX OKX com assinatura local e é independente do 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> <quantia> --sell

Referência Rápida da API

⚠️ Após 2026-05-04: Cada endpoint abaixo é servido por wallet-data.kryptogo.app e será desligado. A ferramenta de swap (swap_tokens / scripts/swap.py) ignora esses endpoints e roteia diretamente para o agregador DEX OKX, portanto continua funcionando.

Endpoint	Método	Propósito	Após 2026-05-04
`/agent/account`	GET	Verificar nível e cota	⚠️ Indisponível
`/agent/trending-tokens`	GET	Escanear tokens em tendência	⚠️ Indisponível
`/agent/portfolio`	GET	Portfólio da carteira + P&L	⚠️ Indisponível (enriquecimento de P&L); saldos ainda podem ser obtidos via RPC Solana
`/agent/swap`	POST	Construir tx de swap não assinada (apenas Solana)	⚠️ Indisponível (swap agora roteia através do OKX DEX; veja `scripts/swap.py`)
`/agent/submit`	POST	Submeter tx assinada (apenas Solana)	⚠️ Indisponível (submeter diretamente ao RPC Solana)
`/token-overview`	GET	Metadados do token e dados de mercado	⚠️ Indisponível
`/analyze/:token_mint`	GET	Análise completa de clusters	⚠️ Indisponível
`/analyze-cluster-change/:token_mint`	GET	Tendências da proporção de clusters	⚠️ Indisponível
`/balance-history`	POST	Dados de saldo em série temporal	⚠️ Indisponível
`/wallet-labels`	POST	Rótulos de comportamento	⚠️ Indisponível
`/token-wallet-labels`	POST	Rótulos específicos de token	⚠️ Indisponível
`/signal-dashboard`	GET	Sinais de acumulação selecionados (Pro+)	⚠️ Indisponível

Detalhes completos de requisição/resposta: veja references/api-reference.md

Suporte Multicadeia

Cadeia	chain_id	Análise	Trading
Solana	`501`	Sim	Sim
BSC	`56`	Sim	Não
Base	`8453`	Sim	Não
Monad	`143`	Sim	Não

Tratamento de Erros

Código	Significado	Ação
400	Requisição Inválida	Verificar parâmetros
401	Não Autorizado	Verificar chave de API
402	Cota Excedida	Aguardar reset diário ou atualizar
403	Proibido	Exige nível superior
502/504	Erro de servidor	Tentar novamente após 10s

Scripts Operacionais

Todos os scripts exigem que as credenciais sejam pré-carregadas: source ~/.openclaw/workspace/.env antes de executar.

Pós-desligamento (2026-05-04): portfolio.sh, trending.sh, analysis.sh e test-api.sh todos chamam o backend kg-xyz e começarão a retornar erros HTTP. swap.py continua funcionando porque usa o agregador DEX OKX e assina localmente. Os scripts são mantidos para que a habilidade falhe graciosamente e uma reversão permaneça trivial se o backend voltar.

source ~/.openclaw/workspace/.env && bash scripts/portfolio.sh              # Verificação de portfólio        (⚠️ quebra após 2026-05-04)
source ~/.openclaw/workspace/.env && bash scripts/trending.sh               # Tokens em tendência        (⚠️ quebra após 2026-05-04)
source ~/.openclaw/workspace/.env && bash scripts/analysis.sh               # Painel de análise completo (⚠️ quebra após 2026-05-04)
source ~/.openclaw/workspace/.env && python3 scripts/swap.py <mint> 0.1     # Comprar                     (✓ continua funcionando)
source ~/.openclaw/workspace/.env && python3 scripts/swap.py <mint> <quantia> --sell  # Vender              (✓ continua funcionando)
source ~/.openclaw/workspace/.env && bash scripts/test-api.sh               # Teste de conectividade da API   (⚠️ quebra após 2026-05-04)

Aprendizado e Adaptação

O agente melhora ao longo do tempo registrando trades, analisando resultados e ajustando a estratégia. Cada trade é registrado em memory/trading-journal.json, perdas acionam análises post-mortem e revisões periódicas propõem mudanças de parâmetros.

Para detalhes completos sobre o sistema de aprendizado, formato do journal de trades, processo post-mortem e revisões de estratégia, consulte references/autonomous-trading.md.

Conceitos Principais

Conceito	Insight Principal
Cluster	Grupo de carteiras controladas pela mesma entidade
Cluster Ratio	Porcentagem da oferta total detida pelo cluster principal
Distribuição	Preço subindo enquanto posse do cluster diminui (sinais de venda)
Acumulação	Preço caindo enquanto posse do cluster aumenta (sinal de compra)
Carteira Arriscada	Endereço com histórico de dumping, sniping ou comportamento de bundle
Rótulos	Tags comportamentais atribuídas com base no histórico on-chain

Perguntas Frequentes

Por que o backend de análise está sendo desligado?

O serviço de análise KryptoGO XYZ (wallet-data.kryptogo.app) está sendo descontinuado. A partir de 2026-05-04, todos os endpoints hospedados neste domínio deixarão de funcionar.

A funcionalidade de swap ainda funciona?

Sim. A execução de swaps (scripts/swap.py) usa o agregador DEX OKX com assinatura local. É completamente independente do backend kg-xyz e continuará funcionando após 2026-05-04.

Preciso fazer alguma coisa?

Não. O skill falhará graciosamente para ferramentas de análise desativadas. Se você usa apenas a funcionalidade de swap, nenhuma ação é necessária.

E se o backend voltar?

Os scripts e implementações de ferramentas MCP foram mantidos. Se o backend for restaurado, uma reversão é trivial.

Leitura Adicional

references/autonomous-trading.md — Modo autônomo, agendamento cron e sistema de aprendizado
references/api-reference.md — Documentação detalhada da API
references/decision-framework.md — Lista de verificação para decisões de trade
scripts/ — Scripts operacionais
memory/ — Journal de trades e preferências

Habilidade do Agente Trader de Meme Coins KryptoGO v1.0

Perguntar na sua IA favorita

Documentação