---
name: defi-api.agenticfi.wtf
description: defi-api.agenticfi.wtf provides two DeFi data endpoints: one returning current supply and reward APY figures across major lending protocols (Aave, Compound, Morpho, Spark), and one returning current TVL snapshots for the top 50 DeFi protocols or a specific protocol by slug. Both endpoints return present-state data only, with no historical time-series.
host: defi-api.agenticfi.wtf
---

# defi-api.agenticfi.wtf

This host serves agents that need current DeFi yield and liquidity data for decision-making around capital allocation. It covers four major lending protocols for supply rate comparison and offers TVL rankings with per-chain breakdowns for protocol-level due diligence. It does not provide borrow rates, token prices, swap quotes, or historical data.

## When to use this host

Use this host when an agent needs to compare current DeFi supply yields across Aave, Compound, Morpho, and Spark, or when it needs a current TVL snapshot for a specific protocol or a ranked list of the top 50 protocols. Do not use this host for borrow rate data, token price feeds, swap quotes, or any historical time-series data (TVL trends, OHLCV, etc.). For historical TVL data, consider DeFiLlama's full API directly. For token prices or swap quotes, route to a dedicated price-feed or DEX aggregator host.

## Capabilities

### DeFi Yield Intelligence

Provides current supply APY, reward APY, total APY, and TVL for assets across Aave v3, Compound v3, Morpho Blue, SparkLend, and Spark Savings, enabling yield comparison across protocols and assets.

- **`fetch-defi-lending-rates`** — Returns current supply APY, reward APY, total APY, and TVL for assets across Aave, Compound, Morpho, and Spark DeFi lending protocols.

### Protocol TVL Metrics

Returns current TVL, 24-hour change, chain category, and per-chain breakdown for the top 50 DeFi protocols or a specific protocol by slug, enabling liquidity depth and protocol-size assessment.

- **`fetch-protocol-tvl`** — Returns Total Value Locked (TVL), 24-hour change, chain, category, and chain breakdown for the top 50 DeFi protocols or a specific named protocol.

## Workflows

### Yield Opportunity with Liquidity Validation

*Use when an agent needs to identify the best supply yield for an asset AND verify that the target protocol has sufficient TVL depth before committing capital.*

1. **`fetch-defi-lending-rates`** — Retrieve current supply APY and total APY across all supported protocols to identify the highest-yielding option for the target asset.
2. **`fetch-protocol-tvl`** — Look up the TVL and 24-hour TVL change for the top-yielding protocol by slug to confirm liquidity depth and detect any unusual outflows before acting.

## Skill reference

### `fetch-defi-lending-rates`

**DeFi Lending Rates** — Returns current supply APY, reward APY, total APY, and TVL for assets across Aave, Compound, Morpho, and Spark DeFi lending protocols.

*Use when:* Use when an agent needs to compare current lending or supply rates across major DeFi protocols (Aave v3, Compound v3, Morpho Blue, SparkLend, Spark Savings) to find the best yield or assess liquidity depth for a given asset.

*Not for:* Do not use for borrow rate data — the response does not include borrow APY fields. Do not use for real-time price feeds or token swap quotes.

**Returns:** Returns a JSON array of objects, each with protocol, chain, asset, supplyApy, rewardApy, totalApy, and tvl, covering dozens of positions across Aave, Compound, Morpho, and Spark sorted roughly by TVL descending.

**Example:** `GET https://defi-api.agenticfi.wtf/api/defi/lending-rates`

---

### `fetch-protocol-tvl`

**Protocol TVL Lookup** — Returns Total Value Locked (TVL), 24-hour change, chain, category, and chain breakdown for the top 50 DeFi protocols or a specific named protocol.

*Use when:* Use when an agent needs current TVL data for a specific DeFi protocol by slug (e.g. 'aave', 'uniswap') or wants a ranked list of the top 50 protocols by TVL with per-chain breakdowns.

*Not for:* Do not use for historical TVL time-series data or token price lookups; this returns only the current snapshot TVL per protocol.

**Inputs:**

- `protocol` (string) — Optional protocol slug to filter results to a single protocol. If omitted, returns the top 50 protocols by TVL.

**Returns:** Returns an array of protocol objects each containing name, numeric tvl in USD, change24h percentage, primary chain, category string, and a chains array listing all supported networks.

**Example:** `GET https://defi-api.agenticfi.wtf/api/defi/protocol-tvl?protocol=aave`

---