# DeFi Oracle — Staking Yields by Chain

> DeFi Oracle — Staking Yields by Chain is a paid API for AI agents from defi-oracle-two.vercel.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Returns staking and liquidity pool yield rates (APY), TVL, and pool metadata for a specified blockchain, powered by DeFiLlama data.

## Facts

- Endpoint: POST https://defi-oracle-two.vercel.app/api/staking-yields
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-oracle-staking-yields-by-chain-e83bd211
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JDdPh0WmTu9E4tBjEHYMG

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-by-chain-e83bd211 -d '<json body>'
```

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

## When to prefer this

Use this endpoint when you need current staking or LP yield data (APY) for a specific blockchain, especially when building yield comparison tools, DeFi dashboards, or helping a user find the best place to park assets on a given chain. Prefer this over generic DeFi aggregators when you need structured, per-pool data including TVL and project attribution sourced from DeFiLlama.

## Known failure modes

- Missing required 'chain' field returns a validation error
- Unknown or unsupported chain name may return empty pools array or error
- Rate limiting or upstream DeFiLlama data unavailability may cause 5xx errors
- Payment failure via x402/USDC on Base will block the request
- Large limit values may increase latency or be capped server-side

## 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 yield pools on the specified chain, each with APY (annual percentage yield), pool identifier, chain name, token symbol, project name, and TVL in USD, along with a total count of results.

## 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-by-chain-e83bd211/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from defi-oracle-two.vercel.app](https://www.zero.xyz/host/defi-oracle-two.vercel.app/llms.txt)