Zapper API para Openclaw

Uma ferramenta CLI abrangente para consultar portfólios DeFi multi-chain, avaliações de NFT e históricos de transações por meio da API GraphQL da Zapper.

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

Instalar e Baixar

1. ClawHub CLI

A maneira mais rápida de instalar uma habilidade diretamente do registro.

npx clawhub@latest install zapper-api

2. Instalação Manual

Copie a pasta da habilidade para um desses locais

Global
~/.openclaw/skills/
Espaço de trabalho
<project>/skills/

Prioridade: Espaço de Trabalho > Local > Integrado

3. Instalação do Prompt

Copie este prompt para o OpenClaw para instalá-lo automaticamente.

Ajude-me a instalar o zapper-api usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).

Prefere baixar?

Obtenha os arquivos originais da habilidade em um arquivo ZIP.

O que é Zapper API?

A skill Zapper API fornece uma interface de alto desempenho para interagir com dados on-chain em mais de 50 redes blockchain, incluindo Ethereum, Base, Solana e várias soluções Layer 2. Esta integração permite que os usuários recuperem dados em tempo real sobre participações em tokens, posições em pools de liquidez, protocolos de empréstimo e coleções de NFT com um único comando. Ao utilizar isso dentro da estrutura Openclaw Skills, os desenvolvedores podem construir agentes financeiros sofisticados que monitoram a saúde da carteira e os movimentos do mercado.

Além de simples verificações de saldo, a skill oferece insights profundos em 'apps' ou posições DeFi, como ativos em staking e recompensas não resgatadas. Ela simplifica a complexidade da contabilidade multi-chain ao agregar dados em um formato unificado, tornando-se uma ferramenta essencial para qualquer pessoa que precise de acesso programático ao cenário de finanças descentralizadas.

Casos de uso do Zapper API

  • Rastreamento do patrimônio líquido total em várias carteiras de hardware e software.
  • Auditoria do histórico de transações recentes para fins fiscais ou de reconciliação em mais de 50 cadeias.
  • Monitoramento do valor do portfólio NFT com base em dados de preço mínimo em tempo real.
  • Verificação de recompensas resgatáveis ou airdrops em vários protocolos DeFi.
  • Automatização de relatórios diários de desempenho do portfólio com métricas de variação de preço em 24 horas.

Como o Zapper API funciona

  1. O usuário inicia uma consulta usando o script zapper.py, fornecendo um endereço de carteira bruto ou um rótulo predefinido.
  2. A skill recupera as credenciais de API necessárias de variáveis de ambiente ou de um arquivo de configuração local.
  3. Uma solicitação GraphQL é enviada para os endpoints da Zapper para buscar módulos de dados específicos como tokens, apps ou transações.
  4. A resposta bruta da API é processada para calcular totais, formatar preços e lidar com a agregação multi-chain.
  5. Os dados finalizados são apresentados em uma tabela legível ou exportados como JSON para integração com outras Openclaw Skills.

Configuração do Zapper API

Primeiro, obtenha uma chave de API no Painel da Zapper em zapper.xyz/developers. Você pode então configurar a skill usando uma variável de ambiente:

export ZAPPER_API_KEY="sua-chave-api"

Alternativamente, crie um arquivo de configuração em ~/.config/zapper/addresses.json para gerenciar várias carteiras:

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

Esquema de Dados e Taxonomia de Zapper API

A skill organiza os dados da blockchain em categorias lógicas para facilitar a análise. Abaixo está o mapeamento da estrutura de dados primária:

Categoria Descrição Atributos Chave
Portfólio Resumo de saldo unificado Valor Total, Variação 24h, Divisão por Cadeia
Tokens Participações de ativos individuais Símbolo, Saldo, Preço (USD), Valor
Apps Posições em protocolos DeFi Nome do Protocolo, Tipo (Staking/LP), Recompensas Resgatáveis
NFTs Dados de colecionáveis digitais Coleção, Preço Mínimo, Valor Estimado
Transações Log de atividade (30 dias) Hash, Cadeia, Tipo de Interação, Timestamp

Recursos avançados do Zapper API

  • Suporte multi-carteira: Use a flag --per-wallet para agregar dados de todos os endereços configurados simultaneamente.
  • Rastreamento de Desempenho: Ative --24h para ver as flutuações de preço e o delta do portfólio no último dia.
  • Amigável para Automação: A flag --json permite o encaminhamento contínuo de dados para outras Openclaw Skills ou pipelines de dados personalizados.
  • Modo Curto: Use --short para extrair apenas a avaliação final, ideal para verificações rápidas de status ou painéis minimalistas.
  • Ampla Cobertura de Rede: Suporte nativo para Ethereum, L2s como Arbitrum e Optimism, e cadeias não-EVM como Solana.

SKILL.md


Carregamento

Habilidades relacionadas do Openclaw

METADATA

Requires
Bins python3
Github Stars: 0
forks: 0

Apresentou*