DefiLlama API

---

name: defillama-api description: 使用 DefiLlama API/SDK 获取 TVL、stablecoins、coins 价格、yields、volumes、fees、perps、unlocks、bridges、ETFs、narratives、token liquidity、main page、DAT、meta 等数据的 CLI 技能；当需要用命令行调用 DefiLlama 数据时使用。 homepage: https://defillama.com/ metadata: { "openclaw": { "emoji": "🦙", "requires": { "bins": ["uv"], "env": [] }, "optionalEnv": ["DEFILLAMA_API_KEY"], "install": [ { "id": "uv-brew", "kind": "brew", "formula": "uv", "bins": ["uv"], "label": "Install uv (brew)", }, ], }, }

---

DefiLlama API

只允许通过 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 

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。