Skip to content

JerryLiu369/awesome-quant-skills / skills/crypto-web3/defillama-yields

defillama-yields

Verified

FileKindSize
SKILL.mdskill md3.8 KB
<!--
  Imported from: https://github.com/DefiLlama/defillama-skills
  Source Path: yield-strategies/SKILL.md
  Curated for awesome-quant-skills
-->

---
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")`
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall