# DeFi Oracle Yield Rates

> DeFi Oracle Yield Rates is a paid API for AI agents from oraclius.vercel.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-16).

Fetches DeFi yield rates, APY data, and pool information for a given blockchain chain, filtered by TVL and result count

## Facts

- Endpoint: POST https://oraclius.vercel.app/api/yield-rates
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-oracle-yield-rates-4eae32b4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DK9ePQyjZFzl3fx68ztvq

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-oracle-yield-rates-4eae32b4 -d '<json body>'
```

Example prompt: Show me the top 10 yield farming pools on Arbitrum with at least $500,000 TVL — I want to see APY, impermanent loss risk, and whether each pool is stablecoin-based.

## When to prefer this

Use this endpoint when an agent needs current DeFi yield data for a specific blockchain, especially when filtering by TVL is important. Prefer this over generic DeFi APIs when the agent needs structured APY breakdowns (base vs reward), IL risk signals, and stablecoin flags in a single call. Best for yield comparison, portfolio optimization, or DeFi research tasks on Ethereum, Base, or Arbitrum.

## Known failure modes

- Missing required 'chain' parameter returns a validation error
- Unsupported or misspelled chain name may return empty results or an error
- Very high min_tvl filter may return zero pools
- Rate limiting or upstream DeFiLlama API unavailability may cause failures
- Payment failure via x402/USDC on Base will block the request

## How this service works

DeFi data for AI agents — yield rates, swap routes, IL calculator, liquidation risk, MEV scanner, TVL tracking. Powered by DeFiLlama + on-chain RPC data. Pay with USDC on Base via x402.

## Output

Returns a list of DeFi liquidity pools for the specified chain, each with APY (total, base, and reward components), TVL in USD, project name, pool identifier, token symbol, impermanent loss risk rating, stablecoin flag, and the chain name. Also includes a count of results and the applied filters.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "chain"
 ],
 "properties": {
  "chain": {
   "type": "string",
   "description": "Chain name (Ethereum, Base, Arbitrum, etc.)"
  },
  "limit": {
   "type": "number",
   "description": "Max results (default 20)"
  },
  "min_tvl": {
   "type": "number",
   "description": "Minimum TVL filter (default 100000)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "count": {
   "type": "number"
  },
  "pools": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "apy": {
      "type": "number"
     },
     "pool": {
      "type": "string"
     },
     "chain": {
      "type": "string"
     },
     "symbol": {
      "type": "string"
     },
     "il_risk": {
      "type": "string"
     },
     "project": {
      "type": "string"
     },
     "tvl_usd": {
      "type": "number"
     },
     "apy_base": {
      "type": "number"
     },
     "apy_reward": {
      "type": "number"
     },
     "stablecoin": {
      "type": "boolean"
     }
    }
   }
  },
  "filters": {
   "type": "object"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-oracle-yield-rates-4eae32b4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from oraclius.vercel.app](https://www.zero.xyz/host/oraclius.vercel.app/llms.txt)