# Agent402 DeFi Yields Lookup

> Agent402 DeFi Yields Lookup is a paid API for AI agents from agent402.tools, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Fetches and filters live DeFi yield pool data from DefiLlama, returning pools ranked by TVL or APY with rich metadata including APY trends, TVL, and ML-based stability predictions.

## Facts

- Endpoint: POST https://agent402.tools/api/defi-yields
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-defi-yields-lookup-56944005
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UXGVVNaLc-_3D46R8nMwO

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent402-defi-yields-lookup-56944005 -d '<json body>'
```

Example prompt: Show me the top 10 stablecoin-only DeFi yield pools on Base sorted by APY, with a minimum APY of 4% and at least $1M TVL — exclude APY outliers.

## When to prefer this

Use this endpoint when you need structured, filterable DeFi yield data sourced from DefiLlama with ML-based APY stability predictions. Prefer this over raw DefiLlama API calls when you need pay-per-call access without API keys, or when building agents that compare yields across chains, protocols, and token types programmatically. It is ideal for yield optimization agents, portfolio rebalancing bots, or DeFi research tools that need ranked pool data with TVL and APY trend context.

## Known failure modes

- Invalid chain name returns empty results or validation error
- APY range conflict (minApy > maxApy) may return zero pools
- Extremely restrictive filter combination returns empty pool list
- DefiLlama upstream unavailability may cause delayed or stale cached data
- Invalid project slug substring returns no matches
- Payment of 0.003 USDC required; missing or failed x402 payment returns 402 status

## How this service works

Live yield opportunities across DeFi, filterable by chain, protocol, token symbol, stablecoin-only, minimum TVL and minimum APY: pool identity, TVL in dollars, total APY split into base and reward, 1-day, 7-day and 30-day APY change, impermanent-loss risk and exposure type. Use it to find, compare or monitor where a given asset earns the most right now.

## Output

Returns a JSON object with a filtered, sorted list of DeFi yield pools sourced from DefiLlama. Each pool entry includes: pool UUID, chain, project slug, token symbol, total APY (base + reward), TVL in USD, APY changes over 1D/7D/30D periods, IL risk indicator, stablecoin flag, outlier flag, APY mean over 30 days, underlying token addresses, and an ML-based APY prediction (class and probability). Also includes applied filter metadata, total matched count, fetch timestamp, and a cache indicator.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "type": "string",
   "description": "\"tvl\" (default) or \"apy\", descending."
  },
  "chain": {
   "type": "string",
   "description": "Chain name as DefiLlama uses it (Ethereum, Base, Arbitrum, Solana, BSC, Optimism...). Case-insensitive, common aliases accepted. Omit for all chains."
  },
  "limit": {
   "type": "number",
   "description": "Rows to return (default 20, max 100)."
  },
  "maxApy": {
   "type": "number",
   "description": "Maximum total APY in percent (drops headline outliers)."
  },
  "minApy": {
   "type": "number",
   "description": "Minimum total APY in percent."
  },
  "symbol": {
   "type": "string",
   "description": "Token symbol filter, e.g. USDC or WETH-USDC; matches any leg of the pool symbol (case-insensitive)."
  },
  "project": {
   "type": "string",
   "description": "Project slug substring (aave-v3, uniswap-v3, morpho, pendle, curve-dex...). Case-insensitive."
  },
  "exposure": {
   "type": "string",
   "description": "\"single\" or \"multi\" asset exposure."
  },
  "minTvlUsd": {
   "type": "number",
   "description": "Minimum pool TVL in USD (default 10000; pass 0 for no floor)."
  },
  "stablecoinOnly": {
   "type": "boolean",
   "description": "true = only stablecoin pools."
  },
  "excludeOutliers": {
   "type": "boolean",
   "description": "Drop pools DefiLlama flags as APY outliers (default true)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "sort": "apy",
  "count": 1,
  "pools": [
   {
    "apy": 6.1,
    "pool": "54e9b138-3146-4c1f-8dce-1cb948f5ef96",
    "chain": "Base",
    "ilRisk": "no",
    "symbol": "USDC",
    "tvlUsd": 25000000,
    "apyBase": 4.9,
    "outlier": false,
    "project": "morpho-v1",
    "apyPct1D": -0.04,
    "apyPct7D": 0.5,
    "exposure": "single",
    "poolMeta": null,
    "apyPct30D": -0.05,
    "apyReward": 1.2,
    "apyMean30d": 5.8,
    "prediction": {
     "class": "Stable/Up",
     "probability": 67
    },
    "stablecoin": true,
    "volumeUsd1d": null,
    "volumeUsd7d": null,
    "rewardTokens": [],
    "underlyingTokens": [
     "0x8335..."
    ]
   }
  ],
  "cached": true,
  "source": "defillama-yields",
  "filters": {
   "chain": "Base",
   "maxApy": null,
   "minApy": null,
   "symbol": null,
   "project": null,
   "exposure": null,
   "minTvlUsd": 1000000,
   "stablecoinOnly": true,
   "excludeOutliers": true
  },
  "matched": 42,
  "fetchedAt": "2026-08-22T12:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-defi-yields-lookup-56944005/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)