# DeFi Yield Pool Rankings API

> DeFi Yield Pool Rankings API is a paid API for AI agents from api.x402node.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns best DeFi yield farming pools filtered by chain, token, and minimum TVL, ranked by APY with base vs reward yield breakdown, impermanent-loss risk, and stablecoin flag

## Facts

- Endpoint: GET https://api.x402node.dev/defi/yield-pools
- 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-pool-rankings-api-cb170a97
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_v8GDmqYsdK2kB9zx7CVlE

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-pool-rankings-api-cb170a97
```

Example prompt: Find me the top yield farming pools on Ethereum with at least $5 million TVL, ranked by APY — I want to see the base vs reward yield breakdown and whether each pool has impermanent loss risk or is stablecoin-only.

## When to prefer this

Use this endpoint when an agent needs to discover, compare, or rank DeFi yield opportunities across multiple protocols and chains in a single call, especially when filtering by chain, token, or TVL is needed and the output must include structured APY breakdowns with risk signals like impermanent loss and stablecoin classification.

## Known failure modes

- Unsupported chain returns empty results or 400 error
- TVL threshold too high returns empty pool list
- Token symbol not recognized returns no matches
- Downstream aggregator data unavailable causes stale or empty response
- Rate limiting or payment failure returns 402

## How this service works

Best DeFi yield farming pools filtered by chain, token and minimum TVL, ranked by APY with base vs reward yield, impermanent-loss risk and stablecoin flag - lets agents find and compare real yield opportunities across thousands of pools, aggregated and computed. yield pools, best apy, defi yield, yield farming, highest apy, staking rewards, liquidity pool apy, stablecoin yield

## Output

A ranked list of DeFi yield pools matching the specified chain, token, and TVL filters, each with APY broken down into base and reward components, an impermanent-loss risk indicator, a stablecoin flag, TVL, protocol name, and pool identifier.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "chain": {
       "type": "string",
       "description": "Filter by chain e.g. ethereum, base, arbitrum (optional)"
      },
      "limit": {
       "type": "string",
       "description": "Max results, default 15, max 30"
      },
      "minApy": {
       "type": "string",
       "description": "Min APY percent, default 0"
      },
      "minTvl": {
       "type": "string",
       "description": "Min TVL USD, default 1000000"
      },
      "symbol": {
       "type": "string",
       "description": "Filter by token symbol e.g. USDC, ETH (optional)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-yield-pool-rankings-api-cb170a97/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x402node.dev](https://www.zero.xyz/host/api.x402node.dev/llms.txt)