# aiworker DeFi Yield Pool Report

> aiworker DeFi Yield Pool Report is a paid API for AI agents from aiworker.duckdns.org, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Fetches filtered DeFi yield pools from DefiLlama and returns an LLM-written analysis report with verdict, key points, risks, best-fit pool recommendation, and raw pool data.

## Facts

- Endpoint: POST https://aiworker.duckdns.org/v1/defi/yield-report
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aiworker-defi-yield-pool-report-bcb752bf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YedxV4YcMiAow7asfQvn-

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 aiworker-defi-yield-pool-report-bcb752bf -d '<json body>'
```

Example prompt: Can you pull together an AI-written yield report for the top 10 stablecoin pools on Base with at least $1M TVL — include the verdict, risks, and a best-fit recommendation?

## When to prefer this

Choose this endpoint when you need both raw DeFi yield pool data AND an interpreted narrative analysis in a single call — ideal for agents that need to explain yield opportunities to a non-technical user or make a recommendation without running a separate LLM step. Prefer over raw DefiLlama API calls when you want pre-built risk commentary and a best-fit verdict. Prefer over generic LLM queries when you need live, filtered pool data grounding the analysis.

## Known failure modes

- No pools match the filter criteria — empty pools array with a low-confidence or null verdict
- DefiLlama data is stale — stale flag set to true in response
- Invalid chain or project slug returns empty or error response
- Limit exceeds maximum of 20 — request rejected
- Payment not processed — x402 payment required error before data is returned

## How this service works

Deterministic-first data for agents, paid per call in USDC over x402 v2: DeFi yields, Base token and wallet cards, Polymarket odds and backtests, news, fact checks, cited briefs. 20 routes, $0.005-$1

## Output

Returns a JSON object containing an LLM-generated report (headline verdict, key points, risk list, caveats, best-fit pool if any) plus an array of raw pool rows (pool ID, chain, symbol, project, APY, TVL in USD), the model used, and a staleness flag.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string",
   "description": "chain name, e.g. base, ethereum, solana"
  },
  "limit": {
   "type": "integer",
   "maximum": 20,
   "minimum": 1,
   "description": "maximum pools to include; default 10"
  },
  "symbol": {
   "type": "string",
   "description": "token symbol, e.g. USDC"
  },
  "project": {
   "type": "string",
   "description": "DefiLlama project slug, e.g. aave-v3"
  },
  "stablecoin": {
   "type": "boolean",
   "description": "restrict to stablecoin pools only"
  },
  "min_tvl_usd": {
   "type": "number",
   "description": "minimum pool TVL in USD; default 1000000"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "model": "muse-spark-1.3-contributor",
  "pools": [
   {
    "apy": 2.3,
    "chain": "base",
    "symbol": "WETH",
    "pool_id": "…",
    "project": "morpho-blue",
    "tvl_usd": 45000000
   }
  ],
  "route": "POST /v1/defi/yield-report",
  "stale": false,
  "report": {
   "risks": [
    "…"
   ],
   "caveats": [],
   "verdict": "mixed",
   "best_fit": null,
   "headline": "…",
   "key_points": [
    "…"
   ]
  },
  "version": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aiworker-defi-yield-pool-report-bcb752bf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aiworker.duckdns.org](https://www.zero.xyz/host/aiworker.duckdns.org/llms.txt)