Communitygithub.com

Fibrous-Finance/fibx-skills

Muestra una vista consolidada del portafolio multi-cadena con valoraciones en USD para todos los tokens y posiciones DeFi. Úsalo cuando el usuario pregunte sobre su portafolio, patrimonio neto, valor total o desglose de activos entre cadenas.

¿Qué es fibx-skills?

Esta skill permite obtener una visión consolidada del portafolio del usuario a través de múltiples cadenas blockchain (Base, HyperEVM, Monad) y posiciones DeFi (Aave V3 en Base), todo con valoraciones en USD en tiempo real. Es útil para desarrolladores y agentes de IA que necesitan responder preguntas sobre patrimonio neto, valor total o desglose de activos. Funciona mediante el comando `npx fibx@latest portfolio`, que paraleliza la consulta en todas las cadenas soportadas sin necesidad de especificar una cadena. Los precios de los tokens provienen en vivo de Fibrous, y las posiciones DeFi se incluyen automáticamente si el usuario tiene colateral o deuda en Base. La salida puede ser en modo tabla (por defecto) o en formato JSON con `--json`. Soporta manejo de errores como autenticación, problemas de red y límites de tasa, con recomendaciones de skills relacionadas para resolverlos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Fibrous-Finance/fibx-skills/tree/HEAD/skills/portfolio

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Resumen del Portafolio

Obtén una vista consolidada de todas las tenencias de tokens con valoraciones en USD a través de todas las cadenas compatibles (Base, HyperEVM, Monad) y posiciones DeFi (Aave V3 en Base).

Requisitos previos

  • Se requiere una sesión activa. Si no estás autenticado, ejecuta primero la skill authenticate-wallet.

Reglas

  1. Este comando obtiene datos de todas las cadenas en paralelo — no es necesario el flag --chain.
  2. Usa --json cuando la salida vaya a ser consumida por otra skill o pipeline.
  3. Los precios de los tokens se obtienen en vivo desde Fibrous. Los valores son aproximados y reflejan precios DEX, no cotizaciones CEX.
  4. Las cadenas sin tenencias se ocultan automáticamente.
  5. Las posiciones DeFi (Aave V3) se incluyen si el usuario tiene algún colateral o deuda en Base.

Comandos

npx fibx@latest portfolio [--json]

Parámetros

ParámetroTipoDescripciónObligatorio
jsonflagSalida en formato JSONNo

Salida

Modo tabla (por defecto)

Muestra las tenencias de tokens agrupadas por cadena con valores en USD, posiciones DeFi de Aave V3 (si las hay) y el valor total del portafolio.

Modo JSON (--json)

{
	"wallet": "0x...",
	"chains": [
		{
			"chain": "base",
			"totalUsd": 205.48,
			"assets": [
				{ "symbol": "ETH", "balance": "0.0042", "price": 2350.0, "usdValue": 9.87 },
				{ "symbol": "USDC", "balance": "125.50", "price": 1.0, "usdValue": 125.5 }
			]
		}
	],
	"defi": [
		{
			"protocol": "Aave V3",
			"chain": "base",
			"collateralUsd": 500.0,
			"debtUsd": 200.0,
			"healthFactor": "2.50",
			"netUsd": 300.0
		}
	],
	"totalUsd": 517.98
}

Ejemplos

Usuario: "Muéstrame mi portafolio"

npx fibx@latest portfolio

Usuario: "¿Cuál es mi patrimonio neto total?"

npx fibx@latest portfolio

Usuario: "Obtén mi portafolio como JSON"

npx fibx@latest portfolio --json

Manejo de errores

ErrorAcción
Not authenticatedEjecuta primero la skill authenticate-wallet.
Network errorReintenta una vez. Si persiste, usa config para establecer un RPC personalizado.
Rate limit / 429Usa la skill config para establecer un RPC personalizado.

Skills relacionadas

  • Usa balance para obtener saldos detallados de una sola cadena sin valores en USD.
  • Usa aave para gestionar posiciones DeFi individuales mostradas en el portafolio.
  • Usa trade para reequilibrar activos entre tokens.
  • Usa config para establecer un RPC personalizado si encuentras errores de límite de tasa.

Skills relacionados