Starchild-ai-agent/official-skills

Uso del Script

Skill en modo script: lea este archivo, luego invoque desde un bloque 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

# Resumen de SOL
sol = birdeye_token_overview(address="So11111111111111111111111111111111111111112", chain="solana")
print(json.dumps(sol, indent=2))
EOF

Funciones disponibles en exports.py: birdeye_token_security, birdeye_token_overview, birdeye_wallet_networth. Lea exports.py directamente para conocer las firmas exactas.

Birdeye

Proveedor de datos multicadena para inteligencia de tokens y análisis de billeteras. Cubre Solana + cadenas EVM (Ethereum, Arbitrum, Base, etc.). Enfoque en las capacidades únicas de Birdeye para análisis de seguridad y seguimiento de carteras.

Referencia de Funciones (firmas)

Todas las funciones están en exports.py. chain por defecto es solana. Cadenas EVM compatibles: ethereum, bsc, polygon, arbitrum, optimism, base, avalanche, zksync, sui. La address del token para Solana es la dirección mint (ej. SOL = So11111111111111111111111111111111111111112).

Función	Descripción
birdeye_token_overview(address, chain='solana')	Datos completos del token: precio, marketCap, fdv, suministro, titulares, liquidez, volumen 24h, enlaces sociales. Devuelve envoltorio {data: {...}}.
birdeye_token_security(address, chain='solana')	Auditoría de seguridad: propiedad, capacidad de acuñación, congelable, concentración de principales titulares, metadatos mutables, indicadores de rug pull.
birdeye_wallet_networth(wallet, chain='solana')	Valor neto de la billetera + desglose de tokens. wallet = dirección de la billetera.

Birdeye utiliza campos en camelCase (marketCap, priceChange24h, etc.). Todas las respuestas están envueltas en un envoltorio {data: {...}} — extraer mediante result.get('data', {}).

Herramientas Disponibles (3)

Inteligencia de Tokens (2 herramientas)

• birdeye_token_security: Puntuación de seguridad y análisis de riesgo de rug pull
• birdeye_token_overview: Datos completos del token (precio, volumen, capitalización de mercado, liquidez)

Análisis de Billeteras (1 herramienta)

• birdeye_wallet_networth: Valor neto actual de la billetera y desglose de cartera

Cuándo Usar Cada Herramienta

"¿Este token es seguro?" → birdeye_token_security Puntuación de seguridad, análisis de riesgo de rug pull y detección de vulnerabilidades del contrato.

"Dame la información completa sobre este token" → birdeye_token_overview Precio, volumen, capitalización de mercado, liquidez y cambios de precio en una sola llamada.

"¿Cuánto vale esta billetera?" → birdeye_wallet_networth Valor actual de la cartera y desglose detallado de tokens con saldos y valores.

Soporte Multicadena

Todas las herramientas aceptan un parámetro chain:

• Solana: solana (predeterminado para la mayoría de consultas)
• EVM: ethereum, arbitrum, base, optimism, polygon, bsc, avalanche, zksync, sui

Directrices de selección de cadena:

• Solana: Mayor actividad de trading, mejor para memecoins
• Ethereum: Tokens de primer nivel, protocolos DeFi
• Arbitrum/Base: Trading en L2, DeFi con tarifas bajas
• Utilice la cadena donde el token/billetera es nativo

Guías de Interpretación

Puntuaciones de Seguridad

Puntuación	Nivel de Riesgo	Acción
90-100	Muy Bajo	Seguro para comerciar, contrato verificado
70-89	Bajo	Generalmente seguro, riesgos estándar
50-69	Medio	Proceder con precaución, revisar lista de problemas
30-49	Alto	Alto riesgo — investigar los problemas cuidadosamente
0-29	Muy Alto	Probable rug pull o estafa — evitar

Señales de alerta comunes:

• Autoridad de acuñación no renunciada (el propietario puede imprimir tokens)
• Autoridad de congelación habilitada (el propietario puede congelar el trading)
• Baja liquidez (< 10k $ = alto riesgo de rug)
• Tenencias concentradas (los 10 principales titulares > 80% del suministro)
• Sin enlaces sociales ni sitio web

Métricas de Resumen del Token

Precio y Capitalización de Mercado: Valoración actual y precio de negociación Volumen: La actividad de negociación indica liquidez e interés Liquidez: Liquidez disponible para negociaciones (mayor = salidas más seguras) Cambio de Precio %: Movimientos de precio 1h/24h/7d

Interpretación de la liquidez:

• < 10k $: Riesgo muy alto, fácil de manipular
• 10k $ - 100k $: Riesgo moderado, vigilar grandes salidas
• 100k $ - 1M $: Buena liquidez para operaciones pequeñas/medianas

• 1M $: Liquidez sólida, más segura para posiciones grandes

Valor Neto de la Billetera

Valor Total en USD: Suma de todas las tenencias de tokens a precios actuales Desglose de Tokens: Tenencias individuales con saldos y valores Concentración de la Cartera: ¿Qué tan diversificada está la billetera?

Indicadores de salud de la cartera:

• Alta concentración (>80% en un solo token) = alto riesgo
• Tenencias equilibradas = mejor gestión del riesgo
• Grandes ganancias no realizadas = potencial para toma de ganancias

Flujos de Trabajo Comunes

Diligencia Debida de Token

1. birdeye_token_security — Puntuación de seguridad y verificación de riesgo
2. birdeye_token_overview — Precio, volumen, capitalización de mercado, liquidez

Señales de alerta: Puntuación de seguridad baja (<50) + baja liquidez (<10k $) = riesgo de rug pull

Ejemplo:

Usuario: "¿Es seguro este token? [dirección de Solana]"
1. Verificar birdeye_token_security → Puntuación 85 (Riesgo bajo)
2. Verificar birdeye_token_overview → 500k $ de liquidez, 2M $ de volumen
3. Resultado: Generalmente seguro, buena liquidez para comerciar

Análisis de Billetera

1. birdeye_wallet_networth — Valor actual de la cartera y desglose

Casos de uso:

• Rastrear el valor de su propia cartera
• Analizar billeteras de ballenas
• Monitorear tenencias de competidores

Ejemplo:

Usuario: "¿Qué hay en esta billetera? [dirección]"
1. Verificar birdeye_wallet_networth → Valor total de 45k $
2. Desglose: 60% SOL, 25% USDC, 15% memecoins
3. Resultado: Cartera equilibrada de Solana con cobertura de stablecoin

Verificación Rápida de Token

Para validación rápida de un token antes de comerciar:

birdeye_token_overview → Obtener precio, liquidez, volumen en una llamada

Si la liquidez < 10k $ o el volumen < 1k $ → Alto riesgo, proceder con precaución

Detalles de las Herramientas

birdeye_token_security

Parámetros:

• address (obligatorio): Dirección del contrato del token
• chain (opcional): Blockchain (predeterminado: solana)

Devuelve:

• Puntuación de seguridad (0-100)
• Nivel de riesgo
• Lista de problemas detectados
• Resultados del análisis del contrato

Ejemplo:

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

birdeye_token_overview

Parámetros:

• address (obligatorio): Dirección del contrato del token
• chain (opcional): Blockchain (predeterminado: solana)

Devuelve:

• Símbolo, nombre
• Precio actual
• Volumen 24h
• Capitalización de mercado
• Liquidez
• Cambios de precio (1h, 24h, 7d)

Ejemplo:

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

birdeye_wallet_networth

Parámetros:

• wallet (obligatorio): Dirección de la billetera
• chain (opcional): Blockchain (predeterminado: solana)

Devuelve:

• Valor total en USD
• Desglose de tenencias de tokens:
  • Símbolo del token, nombre
  • Saldo
  • Precio actual
  • Valor en USD
  • Porcentaje de la cartera

Ejemplo:

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

Nota: Las API de billetera tienen límites de tasa (5 req/s, 75 req/min). Espaciar las solicitudes.

Notas Específicas por Cadena

Solana:

• Cadena mejor soportada para Birdeye
• Las direcciones de tokens están codificadas en base58
• Trading más líquido en Raydium, Orca
• Utilizar para análisis de memecoins y seguimiento de carteras

Ethereum:

• Tokens de primer nivel y protocolos DeFi
• Las direcciones de tokens tienen formato 0x...
• Tarifas de gas más altas = menos micro-trading

Arbitrum/Base:

• Soluciones de escalado L2 con tarifas más bajas
• Ecosistema DeFi en crecimiento
• Bueno para proyectos nativos de L2

Integración con Otras Habilidades

Complementario a CoinGecko:

• Utilizar Birdeye para: Verificaciones de seguridad, tokens de Solana, análisis de billeteras
• Utilizar CoinGecko para: Datos de mercado amplios, precios históricos, rankings de capitalización de mercado

No duplicar: Cada servicio tiene fortalezas únicas. Utilice Birdeye para sus datos especializados (seguridad, enfoque en Solana, seguimiento de billeteras).

Notas

• Clave API requerida: Establecer la variable de entorno BIRDEYE_API_KEY
• Límites de tasa: Los endpoints de billetera están limitados a 5 req/s, 75 req/min
• Multicadena: Especificar siempre el parámetro chain para consultas que no sean de Solana
• Puntuaciones de seguridad: Análisis automatizado — validar manualmente para operaciones de alto valor
• Datos en tiempo real: Los precios y datos se actualizan con frecuencia, útiles para decisiones de trading activo

Limitaciones

• Sin tokens en tendencia: Utilizar CoinGecko para listas de tokens populares/top
• Sin distribución de titulares: No se puede consultar quién posee un token
• Sin historial de transacciones: No se pueden ver transacciones recientes
• Sin señales de dinero inteligente: Utilizar otras fuentes para seguimiento de ballenas
• Herramientas de billetera limitadas: Solo valor neto disponible (sin PnL, detalle de tenencias ni transferencias)

Enfocarse en las 3 herramientas disponibles para verificaciones de seguridad, resúmenes de tokens y valoraciones de billeteras.