Description

Professional DeFi data aggregator that provides unified access to TVL, protocols, chains, and yields data from DefiLlama. Supports multiple output formats (J...

README (SKILL.md)

DefiLlama Data Aggregator

Name: Defillama Data Aggregator
Author: deanpeng-dotcom

Professional DeFi data at your fingertips. Query TVL, protocols, chains, and yields from DefiLlama with a single command.

What This Skill Does

TVL Query - Get total DeFi TVL or individual chain TVL
Protocol Data - Query protocol details, rankings, and filter by category
Chain Statistics - Get TVL for specific chains (Ethereum, Solana, etc.)
Yield Pools - Find high-yield opportunities with filtering options
Health Monitoring - Check API availability status

Quick Start

# Get total DeFi TVL
node {skillDir}/src/index.js defillama tvl

# Get protocol TVL
node {skillDir}/src/index.js defillama protocol --name aave

# Get top protocols by TVL
node {skillDir}/src/index.js defillama protocols --limit 10 --sort tvl --format table

# Get chain TVL
node {skillDir}/src/index.js defillama chain --name ethereum

# Find high-yield pools
node {skillDir}/src/index.js defillama yields --min-apy 10 --chain ethereum --limit 20

# Check API health
node {skillDir}/src/index.js health

Commands

TVL Commands

Command	Description	Example
`tvl`	Get total DeFi TVL	`node {skillDir}/src/index.js defillama tvl`
`protocol --name \x3Cname>`	Get protocol TVL	`node {skillDir}/src/index.js defillama protocol --name uniswap`
`chain --name \x3Cname>`	Get chain TVL	`node {skillDir}/src/index.js defillama chain --name solana`

Protocol Commands

Command	Description	Example
`protocols`	List all protocols	`node {skillDir}/src/index.js defillama protocols`
`protocols --category \x3Ccat>`	Filter by category	`node {skillDir}/src/index.js defillama protocols --category lending`
`protocols --min-tvl \x3Cusd>`	Filter by minimum TVL	`node {skillDir}/src/index.js defillama protocols --min-tvl 100000000`
`protocols --limit \x3Cn>`	Limit results	`node {skillDir}/src/index.js defillama protocols --limit 20`

Yield Commands

Command	Description	Example
`yields`	List yield pools	`node {skillDir}/src/index.js defillama yields`
`yields --min-apy \x3Cpct>`	Filter by minimum APY	`node {skillDir}/src/index.js defillama yields --min-apy 15`
`yields --chain \x3Cname>`	Filter by chain	`node {skillDir}/src/index.js defillama yields --chain arbitrum`
`yields --min-tvl \x3Cusd>`	Filter by minimum TVL	`node {skillDir}/src/index.js defillama yields --min-tvl 1000000`
`yields --stablecoin`	Stablecoin pools only	`node {skillDir}/src/index.js defillama yields --stablecoin`

Utility Commands

Command	Description	Example
`health`	Check API health	`node {skillDir}/src/index.js health`
`status`	Show system status	`node {skillDir}/src/index.js status`

Output Formats

All data commands support multiple output formats:

# Pretty format (default, human-readable)
node {skillDir}/src/index.js defillama tvl --format pretty

# JSON format (for scripts and parsing)
node {skillDir}/src/index.js defillama tvl --format json

# Table format (for quick overview)
node {skillDir}/src/index.js defillama protocols --limit 10 --format table

# CSV format (for spreadsheets)
node {skillDir}/src/index.js defillama protocols --limit 50 --format csv

Use Cases

For DeFi Investors

"Show me the top 10 lending protocols by TVL"
"Find yield pools on Ethereum with APY above 15%"
"What is the current TVL of Aave?"

For Data Analysts

"Export all protocols data to CSV"
"Get the TVL distribution across chains"
"Compare lending vs DEX TVL"

For Developers

"Check if DefiLlama API is healthy"
"Get protocol data in JSON format"
"Find pools with minimum 1M TVL"

Security Features

Input Sanitization - All inputs validated and sanitized
Error Filtering - API errors filtered to prevent information leakage
Range Validation - Numeric inputs validated against bounds
Pattern Validation - Protocol/chain names follow strict rules

Security Notes

No API Keys Required: This skill uses DefiLlama's public API which does not require authentication
External Requests: Data is fetched from:
- https://api.llama.fi (DefiLlama API)
- https://yields.llama.fi (DefiLlama Yields API)
No Local Server: This skill does not start any local HTTP server
No File Persistence: No data is persisted locally (caching is in-memory only)
Input Validation: All user inputs are sanitized to prevent injection attacks

Installation

Prerequisites

Node.js >= 16.0.0
npm

Setup

cd {skillDir}
npm install

API Reference

DefiLlama Endpoints Used

Endpoint	Description
`https://api.llama.fi/tvl`	Total DeFi TVL
`https://api.llama.fi/protocols`	All protocols
`https://api.llama.fi/protocol/{name}`	Protocol details
`https://api.llama.fi/chains`	All chains
`https://yields.llama.fi/pools`	Yield pools

Error Handling

The skill provides user-friendly error messages:

Error Type	Message
Invalid protocol name	"Only alphanumeric characters and hyphens allowed"
Invalid chain name	"Only alphanumeric characters, spaces, and hyphens allowed"
Network error	"Check internet connection and try again"
Rate limit	"Rate limit exceeded, please wait"
API unavailable	"Service temporarily unavailable"

Examples

Get Top Protocols

node {skillDir}/src/index.js defillama protocols --limit 10 --sort tvl --format table

Find High-Yield Pools

node {skillDir}/src/index.js defillama yields --min-apy 20 --min-tvl 1000000 --limit 5

Check Health

node {skillDir}/src/index.js health

Troubleshooting

Protocol Not Found

Ensure the protocol name matches DefiLlama's naming (e.g., aave-v3 not aave v3)
Check if the protocol is listed on DefiLlama

Chain Not Found

Use lowercase chain names (e.g., ethereum not Ethereum)
For multi-word chains, use hyphens (e.g., polygon-pos)

No Results from Yields

Try lowering the --min-apy or --min-tvl thresholds
Ensure the chain name is valid

Network Errors

Check internet connectivity
DefiLlama API may be temporarily unavailable

Version: 1.0.3
Last Updated: 2026-03-31
Maintainer: AntalphaAI
License: MIT

Usage Guidance

This package mostly does what it says: it queries DefiLlama/yields APIs and formats results. Before installing or running it: 1) Inspect config/keys.js (the install script will copy config/keys.example.js to config/keys.js) and ensure baseUrl remains the official https://api.llama.fi and yields URL; 2) Search src/utils/api-client.js for the useIpDirect/ipBaseUrl/hostHeader/rejectUnauthorized options — do not enable useIpDirect or set ipBaseUrl/hostHeader unless you trust the destination and understand the TLS implications (rejectUnauthorized=false disables certificate verification and can be used to bypass TLS/SNI protections); 3) Review package.json dependencies and run npm install in an isolated environment if you are cautious (or audit packages beforehand); 4) The install script runs npm link (creates a global CLI) — if you prefer not to modify your system, skip npm link and run the CLI by invoking node src/index.js directly; 5) If you need stronger assurance, run the code in a network-restricted sandbox or container so the process only has outbound access to the official DefiLlama endpoints. The hidden IP-direct capability is the main reason this package is flagged as suspicious rather than benign.

Capability Analysis

Type: OpenClaw Skill Name: defillama-data-aggregator Version: 1.0.3 The skill is a DeFi data aggregator for DefiLlama that includes robust security practices such as input sanitization and error data redacting (to prevent leaking keys/tokens) in `src/index.js`. However, it is classified as suspicious due to a 'Direct IP' connection feature implemented in `src/utils/api-client.js`. This feature allows redirecting API requests to arbitrary IP addresses and explicitly disables SSL certificate verification (`rejectUnauthorized: false`) when using HTTPS. While this might be intended to bypass DNS-level restrictions in certain regions, hardcoding the bypass of SSL validation introduces a significant Man-in-the-Middle (MitM) risk, allowing for potential data interception or spoofing.

Capability Tags

crypto

Capability Assessment

ℹ Purpose & Capability

Name, description, required binaries (node, npm), dependencies, and the implemented HTTP calls align with a DefiLlama aggregator. The code only contacts DefiLlama and Yields endpoints by default. Small mismatch: SKILL.md claims “No File Persistence” for data (true: caching is in-memory) but the install script creates a local config file (config/keys.js), which is reasonable for configuration but contradicts the literal wording.

ℹ Instruction Scope

Runtime instructions are limited to running the CLI (node src/index.js ...) and npm install. The SKILL.md and README document only DefiLlama endpoints. However, the source code (src/utils/api-client.js) contains an undocumented feature to perform 'IP direct' requests with a custom ipBaseUrl, Host header and the option to disable certificate verification; that expands networking behavior beyond the documented scope and is not explained in runtime instructions.

✓ Install Mechanism

No remote arbitrary binary download; installation is standard npm install and an optional local install script that copies a config example and runs npm link. package.json dependencies are normal for a CLI (axios, commander, chalk, node-cache, etc.).

ℹ Credentials

The skill declares no required environment variables or credentials, which matches its use of public DefiLlama APIs. Minor points: debug behavior relies on process.env.DEBUG (not declared) and the code supports configurable fields (useIpDirect, ipBaseUrl, hostHeader, rejectUnauthorized) via config; those networking options could be set in config/keys.js to alter behavior and are not represented in the SKILL.md.

✓ Persistence & Privilege

The skill is not set always:true and does not modify other skills. It creates a local config file via the install script (config/keys.js) and links a CLI when the install script runs — both expected for a CLI tool, but note the install script will run npm link which modifies the local environment if executed.

Version History

v1.0.3

- Added comprehensive documentation in SKILL.md, including detailed usage instructions, command references, security features, and troubleshooting guidance. - Clarified all supported commands, output formats, and API endpoints used. - Documented security measures such as input validation and error handling. - Provided practical examples and use cases for DeFi investors, analysts, and developers.

Metadata

Slug defillama-data-aggregator

Version 1.0.3

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 1

Frequently Asked Questions

What is Defillama Data Aggregator?

Professional DeFi data aggregator that provides unified access to TVL, protocols, chains, and yields data from DefiLlama. Supports multiple output formats (J... It is an AI Agent Skill for Claude Code / OpenClaw, with 77 downloads so far.

How do I install Defillama Data Aggregator?

Run "/install defillama-data-aggregator" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Defillama Data Aggregator free?

Yes, Defillama Data Aggregator is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Defillama Data Aggregator support?

Defillama Data Aggregator is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Defillama Data Aggregator?

It is built and maintained by deanpeng-dotcom (@deanpeng-dotcom); the current version is v1.0.3.

More Skills

Defillama Data Aggregator