yieldsllama

Query and compare DeFi yield pool data from DeFi Llama.

Installation

Prerequisites

• Rust toolchain (cargo): https://www.rust-lang.org/tools/install

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

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

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