# Yield.xyz DeFi Yield Opportunities Discovery

> Yield.xyz DeFi Yield Opportunities Discovery is a paid API for AI agents from mcp.yield.xyz, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-12).

Lists and filters DeFi yield opportunities across 80+ networks, returning yield IDs, APY, TVL, lock-up/cooldown periods, and KYC gating from providers like Lido, Aave, and Morpho.

## Facts

- Endpoint: POST https://mcp.yield.xyz/x402/yields_get_all?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/yield-xyz-defi-yield-opportunities-discovery-9d375a65
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LBUfBVmGFV2VnJ9arPwD8

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 yield-xyz-defi-yield-opportunities-discovery-9d375a65 -d '<json body>'
```

Example prompt: Show me the top 20 ETH staking and lending yields on Ethereum sorted by APY — include only options without a cooldown period.

## When to prefer this

Use this endpoint first whenever you need to discover, filter, or rank DeFi yield opportunities — it is the required starting point to obtain yield IDs used by every other Yield.xyz tool such as entering a position, checking risk profiles, or fetching historical APY data.

## Known failure modes

- Invalid token symbol returns empty results or 400 error
- Unsupported network name in filter returns no results
- Limit exceeds maximum of 50 — returns validation error
- Invalid sort field returns error or default ordering
- Payment not processed (x402) — returns 402 Payment Required
- Requesting specific yieldIds with more than 100 IDs returns error

## How this service works

Discover DeFi yield opportunities across 80+ networks — 3,300+ staking, lending, vault, and RWA yields from Lido, Aave, Morpho, and more. Filter by token, network, yield type, or provider and sort by APY or TVL. Returns yield IDs (needed by every other tool) with APY, TVL, lock-up/cooldown periods, and KYC gating. Start here.

## Output

A paginated list of yield opportunities each containing a unique yield ID (required for all other Yield.xyz tools), APY, TVL, yield type (staking/lending/vault/RWA), provider name, network, and flags for KYC gating, warmup, and cooldown periods.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "type": "string",
   "description": "Server-side sort, e.g. by APY or TVL (highest first)"
  },
  "limit": {
   "type": "integer",
   "maximum": 50,
   "minimum": 1,
   "description": "Page size (default 20)"
  },
  "token": {
   "type": "string",
   "description": "Token symbol, e.g. \"ETH\", \"USDC\", \"SOL\""
  },
  "types": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Filter by yield type, e.g. [\"staking\", \"lending\", \"vault\", \"restaking\"]"
  },
  "offset": {
   "type": "integer",
   "minimum": 0,
   "description": "Pagination offset (default 0)"
  },
  "search": {
   "type": "string",
   "description": "Free-text search over yield names/providers"
  },
  "networks": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Filter by networks, e.g. [\"ethereum\", \"base\", \"solana\"]"
  },
  "yieldIds": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Fetch specific yield IDs (max 100)"
  },
  "providers": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "inputTokens": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "hasWarmupPeriod": {
   "type": "boolean"
  },
  "hasCooldownPeriod": {
   "type": "boolean"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "id": "base-usdc-aave-v3-lending",
    "type": "lending",
    "tvlUsd": "128000000",
    "network": "base",
    "providerId": "aave-v3",
    "rewardRate": 0.045,
    "kycRequired": false,
    "tokenSymbol": "USDC"
   }
  ],
  "limit": 1,
  "total": 812,
  "offset": 0
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/yield-xyz-defi-yield-opportunities-discovery-9d375a65/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.yield.xyz](https://www.zero.xyz/host/mcp.yield.xyz/llms.txt)