Yields Llama

yieldsllama

Query and compare DeFi yield pool data from DeFi Llama.

Installation

Prerequisites

If Rust is not installed, run:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env"

Build and Install

# Clone the repo
git clone https://github.com/0x9bb1/yieldsllama.git /tmp/yieldsllama
Build release binary
cd /tmp/yieldsllama && cargo build --release
Install to PATH
cp /tmp/yieldsllama/target/release/yieldsllama /usr/local/bin/yieldsllama
Verify
yieldsllama --help

Environment Setup

The tool needs a .env file in the current working directory with the DeFi Llama API endpoint. Before each run, ensure it exists:

if [ ! -f .env ]; then echo 'LLAMA_DOMAIN="https://yields.llama.fi"' > .env; fi

CLI Usage

yieldsllama [OPTIONS]

Options

| Flag | Description | Default | |---|---|---| | -l, --limit | Number of results to return | 10 | | -e, --exposure | Pool type: single or multi | single | | -s, --sort | Sort by: apy or tvl | apy | | -t, --tvl | Minimum TVL in USD | none | | -c, --chain | Filter by chain name (case-insensitive) | none | | -a, --asset | Filter by token symbol (case-insensitive) | none |

Common Examples

# Top 10 highest APY single-asset pools
yieldsllama
Top 20 pools sorted by TVL
yieldsllama -l 20 -s tvl
Best USDC yields with TVL > $10M
yieldsllama -a USDC -t 10000000
Best USDT yields on Ethereum
yieldsllama -a USDT -c Ethereum
Best multi-asset pool yields
yieldsllama -e multi -l 10
Compare stablecoins with TVL > $10M
yieldsllama -a USDC -t 10000000 -l 5
yieldsllama -a USDT -t 10000000 -l 5
yieldsllama -a USDE -t 10000000 -l 5
yieldsllama -a DAI -t 10000000 -l 5
Best ETH yields with TVL > $1M
yieldsllama -a WETH -t 1000000 -l 10
Best yields on specific chains
yieldsllama -c Ethereum -t 1000000 -l 10
yieldsllama -c Base -t 1000000 -l 10
yieldsllama -c Arbitrum -t 1000000 -l 10

Output Columns

| Column | Description | |---|---| | apy | Total APY (apyBase + apyReward) | | symbol | Token symbol | | chain | Blockchain network | | project | Protocol name | | tvlUsd | Total Value Locked in USD | | apyBase | Base lending/staking APY (organic, sustainable) | | apyReward | Reward token APY (may be unsustainable, subject to token price) | | exposure | single (one asset) or multi (LP pair etc.) |

Guidance for Analyzing Results

When presenting yield data to the user, always consider and mention:

1. apyBase vs apyReward: Base APY is from lending/staking fees (more sustainable). Reward APY comes from incentive tokens (can drop to 0 when rewards end or token dumps). 2. TVL matters: Very high APY with low TVL (<$1M) is often unsustainable or risky. Recommend filtering with -t for serious allocation decisions. 3. APY > 100% is suspicious: Flag any extremely high APY and warn the user about sustainability. 4. Chain risk: Different chains have different security profiles. Ethereum L1 is generally safest; newer L2s/alt-L1s carry more risk. 5. Protocol risk: Well-known protocols (Aave, Compound, Morpho) are generally safer than unknown ones.

Workflow for Multi-Token Comparison

When the user asks "which token/pool has the best yield", run queries for each token in parallel and present a unified comparison table. Example:

User: "Compare USDC, USDT, USDE yields with TVL > $10M"
Run in parallel:
  yieldsllama -a USDC -t 10000000 -l 5
  yieldsllama -a USDT -t 10000000 -l 5
  yieldsllama -a USDE -t 10000000 -l 5
Then summarize the top option for each token and give a recommendation.

Refreshing Data

The tool caches API responses in data.json for 12 hours. To force refresh:

rm -f data.json && yieldsllama

Troubleshooting

| Problem | Solution | |---|---| | yieldsllama: command not found | Binary not in PATH. Run cp /path/to/yieldsllama /usr/local/bin/ | | 读取本地data.json文件异常 | Normal on first run — it fetches from API and creates data.json | | 本地文件过期 | Cache expired (>12h). Tool auto-fetches fresh data | | Empty results | Token symbol or chain name may not match exactly. Try without -c/-a filters first | | Network error | Check internet connection; DeFi Llama API (yields.llama.fi) may be temporarily down | | .env error | Ensure .env exists in current directory with LLAMA_DOMAIN="https://yields.llama.fi" |

| Flag | Description | Default | |---|---|---| | -l, --limit | Number of results to return | 10 | | -e, --exposure | Pool type: single or multi | single | | -s, --sort | Sort by: apy or tvl | apy | | -t, --tvl | Minimum TVL in USD | none | | -c, --chain | Filter by chain name (case-insensitive) | none | | -a, --asset | Filter by token symbol (case-insensitive) | none |

Common Examples

# Top 10 highest APY single-asset pools
yieldsllama
Top 20 pools sorted by TVL
yieldsllama -l 20 -s tvl
Best USDC yields with TVL > $10M
yieldsllama -a USDC -t 10000000
Best USDT yields on Ethereum
yieldsllama -a USDT -c Ethereum
Best multi-asset pool yields
yieldsllama -e multi -l 10
Compare stablecoins with TVL > $10M
yieldsllama -a USDC -t 10000000 -l 5
yieldsllama -a USDT -t 10000000 -l 5
yieldsllama -a USDE -t 10000000 -l 5
yieldsllama -a DAI -t 10000000 -l 5
Best ETH yields with TVL > $1M
yieldsllama -a WETH -t 1000000 -l 10
Best yields on specific chains
yieldsllama -c Ethereum -t 1000000 -l 10
yieldsllama -c Base -t 1000000 -l 10
yieldsllama -c Arbitrum -t 1000000 -l 10

| Problem | Solution | |---|---| | yieldsllama: command not found | Binary not in PATH. Run cp /path/to/yieldsllama /usr/local/bin/ | | 读取本地data.json文件异常 | Normal on first run — it fetches from API and creates data.json | | 本地文件过期 | Cache expired (>12h). Tool auto-fetches fresh data | | Empty results | Token symbol or chain name may not match exactly. Try without -c/-a filters first | | Network error | Check internet connection; DeFi Llama API (yields.llama.fi) may be temporarily down | | .env error | Ensure .env exists in current directory with LLAMA_DOMAIN="https://yields.llama.fi" |