DefiLlama API

使用 DefiLlama API/SDK 获取 TVL、stablecoins、coins 价格、yields、volumes、fees、perps、unlocks、bridges、ETFs、narratives、token liquidity、main page、DAT、meta 等数据的 CLI 技能；当需要...

Security Scan

The skill is a straightforward CLI wrapper around the DefiLlama SDK: its requirements, instructions, and files align with the stated purpose and it does not request unrelated credentials or perform suspicious actions.

Purpose & Capability

Name/description match the code: the package exposes many DefiLlama endpoints (TVL, prices, yields, bridges, etc.). It requires the 'uv' runner (declared) which is used in SKILL.md to execute src/run.py. The optional DEFILLAMA_API_KEY is appropriate for Pro endpoints.

Instruction Scope

SKILL.md limits execution to src/run.py via 'uv run' and documents command-line usage and the optional API key. The runtime scripts call the defillama-sdk client and only request data from DefiLlama endpoints; they do not read unrelated files or environment variables or transmit data to unexpected endpoints.

Install Mechanism

Install spec only installs the 'uv' brew formula (reasonable for the specified invocation). The Python code requires the defillama-sdk dependency (declared in a script header comment) but the install block does not show Python package installation — this is likely an implementation detail (runtime/platform may handle it) rather than a security issue.

Credentials

No required secrets are requested. DEFILLAMA_API_KEY is optional and appropriate for Pro endpoints. There are no unrelated environment variables, tokens, or config paths requested.

Persistence & Privilege

always is false and the skill does not request persistent/privileged presence or modify other skills or system-wide settings. It runs on demand and only uses the network to call DefiLlama APIs.

Assessment

This skill appears to be a legitimate CLI wrapper around the DefiLlama SDK. Before installing: (1) be aware it will install the 'uv' brew formula to run the CLI; (2) if you want Pro endpoints, provide DEFILLAMA_API_KEY (optional) — that key is sent to DefiLlama only; (3) the Python dependency defillama-sdk is referenced in the source header (ensure your environment or the platform will install it); (4) review and trust the skill owner/source before granting network access or supplying any API key. If you need stricter assurance, request a build/run log or run the code in an isolated environment first.

只允许通过 src/run.py 调用，禁止直接运行 src/scripts/ 下的脚本。

安装

cd {baseDir}

环境变量

• DEFILLAMA_API_KEY：可选，Pro API key。若未提供，Pro 端点会提示 API PLAN REQUIRED。

使用方式（必须通过 run.py）

TVL

uv run {baseDir}/src/run.py tvl protocols
uv run {baseDir}/src/run.py tvl protocol --protocol aave
uv run {baseDir}/src/run.py tvl tvl --protocol uniswap
uv run {baseDir}/src/run.py tvl chains
uv run {baseDir}/src/run.py tvl historical-chain-tvl --chain Ethereum

Stablecoins

uv run {baseDir}/src/run.py stablecoins list --include-prices
uv run {baseDir}/src/run.py stablecoins charts-all
uv run {baseDir}/src/run.py stablecoins charts-chain --chain Ethereum
uv run {baseDir}/src/run.py stablecoins detail --asset 1
uv run {baseDir}/src/run.py stablecoins dominance --chain Ethereum --stablecoin-id 1

Coins（价格与链上数据）

uv run {baseDir}/src/run.py coins current --coins coingecko:ethereum,ethereum:0x0000000000000000000000000000000000000000
uv run {baseDir}/src/run.py coins historical --timestamp 1704067200 --coins coingecko:ethereum
uv run {baseDir}/src/run.py coins chart --coins coingecko:ethereum --period 7d

Yields（Pro）

uv run {baseDir}/src/run.py yields pools
uv run {baseDir}/src/run.py yields pool-chart --pool <pool_id>

Volumes

uv run {baseDir}/src/run.py volumes dex-overview
uv run {baseDir}/src/run.py volumes options-overview --data-type dailyPremiumVolume

Fees

uv run {baseDir}/src/run.py fees overview
uv run {baseDir}/src/run.py fees summary --protocol uniswap

Perps

uv run {baseDir}/src/run.py perps open-interest
uv run {baseDir}/src/run.py perps derivatives-overview

Unlocks（Pro）

uv run {baseDir}/src/run.py unlocks all
uv run {baseDir}/src/run.py unlocks protocol --protocol hyperliquid

Main Page（Pro）

uv run {baseDir}/src/run.py main-page categories
uv run {baseDir}/src/run.py main-page raises

Token Liquidity（Pro）

uv run {baseDir}/src/run.py token-liquidity historical --token usdt

ETFs（Pro）

uv run {baseDir}/src/run.py etfs overview
uv run {baseDir}/src/run.py etfs history

Narratives（Pro）

uv run {baseDir}/src/run.py narratives fdv-performance --period 30

Bridges（Pro）

uv run {baseDir}/src/run.py bridges list --include-chains
uv run {baseDir}/src/run.py bridges transactions --id 1 --limit 50

Meta / DAT（Pro）

uv run {baseDir}/src/run.py meta usage
uv run {baseDir}/src/run.py dat institutions

备注

• Coin 需要使用 chain:address 或 coingecko:slug 格式，例如 coingecko:ethereum。
• Pro 端点需要 DEFILLAMA_API_KEY 或 --api-key。

常见错误

• rate limited：放缓速率或提供 API plan key。
• API PLAN REQUIRED：升级订阅或设置 DEFILLAMA_API_KEY。