Starchild-ai-agent/official-skills

Uso do Script

Skill em modo script — leia este arquivo e invoque a partir de um bloco bash:

python3 - <<'EOF'
import sys, json
sys.path.insert(0, "/data/workspace/skills/birdeye")
from exports import birdeye_token_overview, birdeye_token_security, birdeye_wallet_networth

# Visão geral SOL
sol = birdeye_token_overview(address="So11111111111111111111111111111111111111112", chain="solana")
print(json.dumps(sol, indent=2))
EOF

Funções disponíveis em exports.py: birdeye_token_security, birdeye_token_overview, birdeye_wallet_networth. Leia exports.py diretamente para assinaturas exatas.

Birdeye

Provedor de dados multi-cadeia para inteligência de tokens e análise de carteiras. Abrange Solana + cadeias EVM (Ethereum, Arbitrum, Base, etc.). Foco nas capacidades únicas do Birdeye para análise de segurança e rastreamento de portfólio.

Referência de Funções (assinaturas)

Todas as funções estão em exports.py. chain padrão é solana. Cadeias EVM suportadas: ethereum, bsc, polygon, arbitrum, optimism, base, avalanche, zksync, sui. O address do token para Solana é o endereço de mint (ex.: SOL = So11111111111111111111111111111111111111112).

Função	Descrição
birdeye_token_overview(address, chain='solana')	Dados abrangentes do token: preço, marketCap, fdv, supply, detentores, liquidez, volume 24h, links sociais. Retorna wrapper {data: {...}}.
birdeye_token_security(address, chain='solana')	Auditoria de segurança: ownership, capacidade de mint, congelável, concentração dos principais detentores, metadados mutáveis, indicadores de rug pull.
birdeye_wallet_networth(wallet, chain='solana')	Patrimônio líquido da carteira + detalhamento de tokens. wallet = endereço da carteira.

Birdeye usa campos em camelCase (marketCap, priceChange24h, etc.). Todas as respostas são encapsuladas em um envelope {data: {...}} — extraia via result.get('data', {}).

Ferramentas Disponíveis (3)

Inteligência de Token (2 ferramentas)

• birdeye_token_security: Pontuação de segurança e análise de risco de rug pull
• birdeye_token_overview: Dados abrangentes do token (preço, volume, capitalização de mercado, liquidez)

Análise de Carteira (1 ferramenta)

• birdeye_wallet_networth: Patrimônio líquido atual da carteira e detalhamento do portfólio

Quando Usar Cada Ferramenta

"Este token é seguro?" → birdeye_token_security Pontuação de segurança, análise de risco de rug pull e detecção de vulnerabilidades de contrato.

"Me dê o resumo completo deste token" → birdeye_token_overview Preço, volume, capitalização de mercado, liquidez e mudanças de preço em uma única chamada.

"Quanto vale esta carteira?" → birdeye_wallet_networth Valor atual do portfólio e detalhamento de tokens com saldos e valores.

Suporte Multi-Cadeia

Todas as ferramentas aceitam um parâmetro chain:

• Solana: solana (padrão para a maioria das consultas)
• EVM: ethereum, arbitrum, base, optimism, polygon, bsc, avalanche, zksync, sui

Diretrizes de seleção de cadeia:

• Solana: Negociação mais ativa, melhor para memecoins
• Ethereum: Tokens blue-chip, protocolos DeFi
• Arbitrum/Base: Negociação L2, DeFi com taxas baixas
• Use a cadeia onde o token/carteira é nativo

Guias de Interpretação

Pontuações de Segurança

Pontuação	Nível de Risco	Ação
90-100	Muito Baixo	Seguro para negociar, contrato verificado
70-89	Baixo	Geralmente seguro, riscos padrão
50-69	Médio	Prossiga com cautela, verifique lista de problemas
30-49	Alto	Alto risco — investigue problemas cuidadosamente
0-29	Muito Alto	Provável rug pull ou golpe — evite

Bandeiras vermelhas comuns:

• Autoridade de mint não renunciada (proprietário pode imprimir tokens)
• Autoridade de congelamento habilitada (proprietário pode congelar negociações)
• Baixa liquidez (< $10k = alto risco de rug)
• Participações concentradas (top 10 detentores > 80% do supply)
• Sem links sociais ou site

Métricas de Visão Geral do Token

Preço e Capitalização de Mercado: Avaliação atual e preço de negociação Volume: Atividade de negociação indica liquidez e interesse Liquidez: Liquidez disponível para negociações (maior = saídas mais seguras) % de Variação de Preço: Movimentos de preço 1h/24h/7d

Interpretando liquidez:

• < $10k: Risco muito alto, fácil de manipular
• $10k-$100k: Risco moderado, cuidado com grandes saídas
• $100k-$1M: Boa liquidez para negociações pequenas/médias

• $1M: Liquidez forte, mais seguro para posições maiores

Patrimônio Líquido da Carteira

Valor Total em USD: Soma de todas as participações em tokens aos preços atuais Detalhamento de Tokens: Participações individuais com saldos e valores Concentração do Portfólio: Quão diversificada é a carteira?

Indicadores de saúde do portfólio:

• Alta concentração (>80% em um token) = alto risco
• Participações equilibradas = melhor gestão de risco
• Grandes ganhos não realizados = potencial para realização de lucros

Fluxos de Trabalho Comuns

Due Diligence de Token

1. birdeye_token_security — Pontuação de segurança e verificação de risco
2. birdeye_token_overview — Preço, volume, capitalização de mercado, liquidez

Bandeiras vermelhas: Baixa pontuação de segurança (<50) + baixa liquidez (<$10k) = risco de rug pull

Exemplo:

Usuário: "Este token é seguro? [endereço Solana]"
1. Verificar birdeye_token_security → Pontuação 85 (Risco baixo)
2. Verificar birdeye_token_overview → $500k de liquidez, $2M de volume
3. Resultado: Geralmente seguro, boa liquidez para negociação

Análise de Carteira

1. birdeye_wallet_networth — Valor atual do portfólio e detalhamento

Casos de uso:

• Acompanhar valor do seu próprio portfólio
• Analisar carteiras de baleias
• Monitorar participações de concorrentes

Exemplo:

Usuário: "O que há nesta carteira? [endereço]"
1. Verificar birdeye_wallet_networth → $45k de valor total
2. Detalhamento: 60% SOL, 25% USDC, 15% memecoins
3. Resultado: Portfólio Solana equilibrado com hedge em stablecoin

Verificação Rápida de Token

Para validação rápida de um token antes de negociar:

birdeye_token_overview → Obtenha preço, liquidez, volume em uma chamada

Se liquidez < $10k ou volume < $1k → Alto risco, prossiga com cautela

Detalhes das Ferramentas

birdeye_token_security

Parâmetros:

• address (obrigatório): Endereço do contrato do token
• chain (opcional): Blockchain (padrão: solana)

Retorna:

• Pontuação de segurança (0-100)
• Nível de risco
• Lista de problemas detectados
• Resultados da análise de contrato

Exemplo:

birdeye_token_security(
  address="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  chain="solana"
)

birdeye_token_overview

Parâmetros:

• address (obrigatório): Endereço do contrato do token
• chain (opcional): Blockchain (padrão: solana)

Retorna:

• Símbolo, nome
• Preço atual
• Volume 24h
• Capitalização de mercado
• Liquidez
• Variações de preço (1h, 24h, 7d)

Exemplo:

birdeye_token_overview(
  address="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  chain="solana"
)

birdeye_wallet_networth

Parâmetros:

• wallet (obrigatório): Endereço da carteira
• chain (opcional): Blockchain (padrão: solana)

Retorna:

• Valor total em USD
• Detalhamento das participações em tokens:
  • Símbolo, nome do token
  • Saldo
  • Preço atual
  • Valor em USD
  • Percentual do portfólio

Exemplo:

birdeye_wallet_networth(
  wallet="7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  chain="solana"
)

Nota: APIs de carteira têm limites de taxa (5 req/s, 75 req/min). Distribua as requisições.

Notas Específicas por Cadeia

Solana:

• Melhor cadeia suportada pelo Birdeye
• Endereços de token são codificados em base58
• Negociação mais líquida em Raydium, Orca
• Use para análise de memecoins e rastreamento de portfólio

Ethereum:

• Tokens blue-chip e protocolos DeFi
• Endereços de token no formato 0x...
• Taxas de gás mais altas = menos micro-negociação

Arbitrum/Base:

• Soluções de escalonamento L2 com taxas mais baixas
• Ecossistema DeFi em crescimento
• Bom para projetos nativos de L2

Integração com Outros Skills

Complementar ao CoinGecko:

• Use Birdeye para: Verificações de segurança, tokens Solana, análises de carteira
• Use CoinGecko para: Dados amplos de mercado, preços históricos, rankings de capitalização de mercado

Não duplique: Cada serviço tem pontos fortes únicos. Use Birdeye para seus dados especializados (segurança, foco em Solana, rastreamento de carteira).

Notas

• Chave de API necessária: Defina a variável de ambiente BIRDEYE_API_KEY
• Limites de taxa: Endpoints de carteira limitados a 5 req/s, 75 req/min
• Multi-cadeia: Sempre especifique o parâmetro chain para consultas não-Solana
• Pontuações de segurança: Análise automatizada — valide manualmente para negociações de alto valor
• Dados em tempo real: Preços e dados são atualizados com frequência, bom para decisões de negociação ativas

Limitações

• Sem tokens em alta: Use CoinGecko para listas de tokens populares/principais
• Sem distribuição de detentores: Não é possível verificar quem detém um token
• Sem histórico de negociações: Não é possível ver negociações recentes
• Sem sinais de smart money: Use outras fontes para rastreamento de baleias
• Ferramentas de carteira limitadas: Apenas patrimônio líquido disponível (sem PnL, detalhamento de participações ou transferências)

Concentre-se nas 3 ferramentas disponíveis para verificações de segurança, visões gerais de tokens e avaliações de carteira.