Defillama Official Yield Strategies

---
name: yield-strategies
description: Guide for querying DeFi yield and APY data using get_yield_pools. Covers pool filtering by token, chain, protocol, category, stablecoin-only mode, and capacity assessment. Explains APY conventions, lending vs borrowing rates, and sort options. Use when users ask about yields, APY, lending rates, borrowing costs, best pools, or DeFi yield strategies.
---

# DeFi Yield Strategies

## APY Convention

APY values are **already percentages**: `apy = 2.32` means 2.32%.

Do NOT multiply by 100. This is the most common mistake when working with yield data.

## Tool: `defillama:get_yield_pools`

### Filtering Guide

| Want | Parameter | Example |
|------|-----------|---------|
| Pools with specific token | `token` | `"coingecko:ethereum"` |
| Pools on specific chain | `chain` | `"ethereum"` |
| Pools from specific protocol | `protocol` | `"aave"` |
| Pools from protocol category | `category` | `"Lending"`, `"DEXes"` |
| Only stablecoin pools | `stablecoin_only` | `true` |
| Minimum APY threshold | `min_apy` | `5` (= 5%) |
| Minimum TVL | `min_tvl` | `1000000` (= $1M) |
| Include borrow-side data | `include_borrow` | `true` |

### Key Distinction

- **"ETH pools"** = **token** filter: `token: "coingecko:ethereum"`
- **"Pools on Ethereum"** = **chain** filter: `chain: "ethereum"`

### Token Family Matching

The `token` param expects canonical token keys (e.g., `coingecko:ethereum`) and uses `dim.pool_set()` for family resolution. `coingecko:ethereum` finds pools containing ETH, wETH, stETH, cbETH, and all other variants in the ETH family -- not just native ETH.

### Sort Options

`sort_by` accepts strings like: `"apy desc"`, `"tvl desc"`, `"apy_base desc"`, `"apy_reward desc"`

### Returned Columns

Each result includes: `symbol`, `protocol` (sub-protocol slug), `parent_protocol`, `category`, `chain`, `apy`, `apy_base`, `apy_reward`, `apy_base_borrow`, `apy_reward_borrow`, `tvl`, `total_supply`, `total_borrow`

### Historical Data & Volatility

- Use `period` param (`7d`, `30d`, `90d`, `180d`, `365d`) for daily APY/TVL time-series history
- Use `include_volatility: true` to add APY volatility stats (`apy_avg_30d`, `apy_median_30d`, `apy_std_30d`, `cv_30d`) — current queries only
- Use `start_date` / `end_date` for custom date ranges (overrides `period`)

## Borrowing Costs

For lending protocols, borrowing rate data is available:

- `apy_base_borrow`: Base borrowing cost (what you pay)
- `apy_reward_borrow`: Reward offset on borrowing (incentives you earn)
- Net borrow cost = `apy_base_borrow - apy_reward_borrow`

Use `include_borrow: true` to ensure borrow columns are populated.

## Capacity Assessment

When allocating capital, check pool TVL. Allocating more than 10% of a pool's TVL may cause significant rate impact or slippage. Larger pools absorb capital more easily.

## Examples

**Example 1:**
User: "Best stablecoin lending yields"
Tool call: `defillama:get_yield_pools(stablecoin_only: true, category: "Lending", sort_by: "apy desc")`

**Example 2:**
User: "Top ETH yield pools with over $1M TVL"
Tool call: `defillama:get_yield_pools(token: "coingecko:ethereum", min_tvl: 1000000, sort_by: "apy desc")`

**Example 3:**
User: "Cheapest borrowing rates for stablecoins on Arbitrum"
Tool call: `defillama:get_yield_pools(stablecoin_only: true, chain: "arbitrum", category: "Lending", include_borrow: true, sort_by: "apy_base_borrow asc")`

**Example 4:**
User: "Where can I earn yield on USDC?"
Tool call: `defillama:get_yield_pools(token: "coingecko:usd-coin", sort_by: "apy desc", min_tvl: 100000)`

**Example 5:**
User: "Aave yields on Ethereum"
Tool call: `defillama:get_yield_pools(protocol: "aave", chain: "ethereum", sort_by: "apy desc")`