# DeFi Oracle Staking Yields

> DeFi Oracle Staking Yields 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).

Returns staking and liquidity pool yield rates (APY, TVL, symbol, project) for pools on a specified blockchain chain, powered by DeFiLlama data.

## Facts

- Endpoint: POST https://oraclius.vercel.app/api/staking-yields
- 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-staking-yields-c2e75ce3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LxC1hrrODPyZie2wbnrP6

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-staking-yields-c2e75ce3 -d '<json body>'
```

Example prompt: Show me the top 10 staking and liquidity pool yields on Ethereum right now — I want to see APY, TVL, and which protocol each pool belongs to.

## When to prefer this

Use this endpoint when you need current yield/APY data for staking or liquidity pools on a specific blockchain chain, especially when you want DeFiLlama-backed data accessed via a pay-per-call USDC micropayment on Base. Prefer this over raw DeFiLlama API access when operating in an x402-enabled agent context that handles payments automatically.

## Known failure modes

- Missing required 'chain' field returns a 400 validation error
- Unknown or misspelled chain name may return an empty pools array or an error
- Payment failure (insufficient USDC balance or x402 payment rejection) blocks access
- DeFiLlama upstream outage may cause 502 or stale data
- Rate limiting if too many requests are made in quick succession

## 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

A JSON object containing a count of matching pools and an array of pool objects, each with APY (annual percentage yield), pool identifier, chain name, token symbol, project/protocol name, and TVL in USD. Results are filtered to the requested chain and capped by the optional limit parameter.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "chain"
 ],
 "properties": {
  "chain": {
   "type": "string",
   "description": "Chain name"
  },
  "limit": {
   "type": "number"
  }
 }
}
```

## 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"
     },
     "project": {
      "type": "string"
     },
     "tvl_usd": {
      "type": "number"
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-oracle-staking-yields-c2e75ce3/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)