Zapper API para Openclaw

Una herramienta de CLI integral para consultar carteras DeFi multichain, valoraciones de NFT e historiales de transacciones a través de la API GraphQL de Zapper.

zivhm
v1.0.0
Feb 6, 2026
0
2.6k
0

Instalar y Descargar

1. ClawHub CLI

La forma más rápida de instalar una habilidad directamente desde el registro.

npx clawhub@latest install zapper-api

2. Instalación manual

Copia la carpeta de la habilidad a una de estas ubicaciones

Global
~/.openclaw/skills/
Espacio de trabajo
<project>/skills/

Prioridad: Espacio de trabajo > Local > Integrado

3. Instalación del prompt

Copia este prompt en OpenClaw para instalarlo automáticamente.

Ayúdame a instalar zapper-api usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).

¿Prefieres descargar?

Obtén los archivos originales de la habilidad en un archivo ZIP.

¿Qué es Zapper API?

La skill Zapper API proporciona una interfaz de alto rendimiento para interactuar con datos on-chain en más de 50 redes blockchain, incluyendo Ethereum, Base, Solana y varias soluciones de Capa 2. Esta integración permite a los usuarios recuperar datos en tiempo real sobre tenencias de tokens, posiciones en pools de liquidez, protocolos de préstamo y colecciones de NFT con un solo comando. Al utilizar esto dentro del marco de Openclaw Skills, los desarrolladores pueden construir agentes financieros sofisticados que monitorean la salud de la billetera y los movimientos del mercado.

Más allá de las simples verificaciones de saldo, la skill ofrece información profunda sobre 'apps' o posiciones DeFi, como activos en staking y recompensas no reclamadas. Simplifica la complejidad de la contabilidad multichain al agregar datos en un formato unificado, lo que la convierte en una herramienta esencial para cualquiera que necesite acceso programático al panorama de las finanzas descentralizadas.

Casos de uso de Zapper API

  • Seguimiento del patrimonio neto total en múltiples billeteras de hardware y software.
  • Auditoría del historial de transacciones recientes para fines fiscales o de conciliación en más de 50 cadenas.
  • Monitoreo del valor de la cartera de NFT basado en datos de precio mínimo en tiempo real.
  • Verificación de recompensas reclamables o airdrops en varios protocolos DeFi.
  • Automatización de informes diarios de rendimiento de cartera con métricas de cambio de precio de 24 horas.

Cómo funciona Zapper API

  1. El usuario inicia una consulta utilizando el script zapper.py, proporcionando una dirección de billetera sin procesar o una etiqueta predefinida.
  2. La skill recupera las credenciales de API necesarias de las variables de entorno o de un archivo de configuración local.
  3. Se envía una solicitud GraphQL a los puntos finales de Zapper para obtener módulos de datos específicos como tokens, apps o transacciones.
  4. La respuesta de la API se procesa para calcular totales, formatear precios y manejar la agregación multichain.
  5. Los datos finalizados se presentan en una tabla legible para humanos o se exportan como JSON para su integración con otras Openclaw Skills.

Configuración de Zapper API

Primero, obtenga una clave de API del Panel de Zapper en zapper.xyz/developers. Luego puede configurar la skill utilizando una variable de entorno:

export ZAPPER_API_KEY="tu-api-key"

Alternativamente, cree un archivo de configuración en ~/.config/zapper/addresses.json para administrar múltiples billeteras:

{
  "apiKey": "tu-api-key",
  "wallets": [
    {"label": "Principal", "address": "0x..."}
  ]
}

Esquema de datos y taxonomía de Zapper API

La skill organiza los datos de blockchain en categorías lógicas para facilitar el análisis. A continuación se muestra el mapeo de la estructura de datos principal:

Categoría Descripción Atributos Clave
Cartera Resumen de saldo unificado Valor Total, Cambio 24h, Desglose por Cadena
Tokens Tenencias de activos individuales Símbolo, Saldo, Precio (USD), Valor
Apps Posiciones en protocolos DeFi Nombre del Protocolo, Tipo (Staking/LP), Recompensas Reclamables
NFTs Datos de coleccionables digitales Colección, Precio Mínimo, Valor Estimado
Transacciones Registro de actividad (30 días) Hash, Cadena, Tipo de Interacción, Marca de Tiempo

Funciones avanzadas de Zapper API

  • Soporte multi-billetera: Use el flag --per-wallet para agregar datos de todas las direcciones configuradas simultáneamente.
  • Seguimiento de Rendimiento: Active --24h para ver las fluctuaciones de precios y el delta de la cartera durante el último día.
  • Amigable con la Automatización: El flag --json permite la canalización de datos sin problemas hacia otras Openclaw Skills o flujos de datos personalizados.
  • Modo Corto: Use --short para extraer solo la valoración final, ideal para verificaciones de estado rápidas o tableros minimalistas.
  • Amplia Cobertura de Red: Soporte nativo para Ethereum, L2s como Arbitrum y Optimism, y cadenas no-EVM como Solana.

SKILL.md


Cargando

Habilidades relacionadas de Openclaw

METADATA

Requires
Bins python3
Github Stars: 0
forks: 0

Presentado*