# DeFi Yield Pools (Filtered & Sorted)

> DeFi Yield Pools (Filtered & Sorted) is a paid API for AI agents from x402.shizu.me, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns filtered and sorted DeFi yield pool data from DefiLlama, avoiding the full 11MB index by applying server-side filters for chain, project, symbol, TVL, APY, stablecoin status, and sort order.

## Facts

- Endpoint: GET https://x402.shizu.me/llama/yields
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-yield-pools-filtered-sorted-33e1d441
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_49fT0wM69kEYxw9ZF09L6

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 defi-yield-pools-filtered-sorted-33e1d441
```

Example prompt: Show me the top 20 stablecoin yield pools on Ethereum with at least $500K TVL and a minimum APY of 4%, sorted by APY.

## When to prefer this

Choose this endpoint when you need filtered, lightweight DeFi yield pool data without downloading the full 11MB DefiLlama index. It is ideal for agents that need to screen pools by chain, project, APY floor, TVL floor, or stablecoin status on a recurring basis, and for any workflow where bandwidth or latency matters. Prefer this over raw DefiLlama bulk data when you only need a small subset of pools matching specific criteria.

## Known failure modes

- Invalid chain or project name returns empty result set or 400 error
- min_tvl or min_apy values outside supported range may return errors
- limit outside 1-100 range returns validation error
- APY data may be stale between polls — values are point-in-time snapshots
- Payment failure (insufficient USDC balance) returns 402 status
- Sort parameter value other than 'tvl' or 'apy' may return error

## How this service works

Every DefiLlama yield pool, filtered and sorted server-side so you don't fetch the 11MB index. Query: chain, project, symbol, min_tvl (USD), min_apy (%), stablecoin (true/false), sort (tvl|apy), limit (1-100). Each pool: project, chain, symbol, tvl_usd, apy, apy_base, apy_reward, stablecoin, il_risk, exposure. APYs move — poll it.

## Output

A list of up to 100 yield pool objects, each containing: project name, chain, token symbol, TVL in USD, total APY, base APY, reward APY, stablecoin flag, impermanent loss risk indicator, and exposure type. Results are pre-filtered and sorted server-side, so only pools matching the requested criteria are returned.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "method"
   ],
   "properties": {
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "chain",
      "min_tvl",
      "sort",
      "limit"
     ],
     "properties": {
      "sort": {
       "type": "string"
      },
      "chain": {
       "type": "string"
      },
      "limit": {
       "type": "string"
      },
      "min_tvl": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 20,
  "pools": [
   {
    "apy": 18.4,
    "pool": "abc",
    "chain": "Base",
    "symbol": "USDC-ETH",
    "il_risk": "yes",
    "project": "aerodrome",
    "tvl_usd": 4200000,
    "apy_base": 12.1,
    "exposure": "multi",
    "apy_reward": 6.3,
    "stablecoin": false
   }
  ],
  "source": "defillama",
  "total_pools": 15981
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-yield-pools-filtered-sorted-33e1d441/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.shizu.me](https://www.zero.xyz/host/x402.shizu.me/llms.txt)