# aiworker-data DeFi Yields

> aiworker-data DeFi Yields is a paid API for AI agents from aiworker.duckdns.org, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Fetches filtered DeFi yield pool data (APY, TVL, chain, project) from DefiLlama via a pay-per-call API

## Facts

- Endpoint: GET https://aiworker.duckdns.org/v1/defi/yields
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aiworker-data-defi-yields-c1849235
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_o8uFSYSqf-i1G95fYVhod

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-data-defi-yields-c1849235
```

Example prompt: What are the top 20 stablecoin yield pools on Base right now, filtered to those with at least $5 million TVL? I want to see APY and project details.

## When to prefer this

Use this endpoint when an AI agent needs reliable, structured DeFi yield data filtered by chain, project, symbol, or TVL — especially for Base, Ethereum, or Solana pools. Prefer this over scraping DefiLlama directly as it provides clean structured JSON at low per-call cost ($0.02) with no rate-limit management required. Best when you need machine-readable yield data for comparison, ranking, or monitoring workflows rather than human-readable summaries.

## Known failure modes

- Invalid chain name returns empty pool list or error
- Project slug not matching any DefiLlama entry returns zero results
- Limit parameter out of range (< 1 or > 200) may return validation error
- Stale data flag set to true if DefiLlama upstream is delayed
- Network or DNS issues with duckdns.org host causing service unavailability
- Payment failure (x402) if USDC balance insufficient

## 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 with a list of matching yield pools, each containing pool ID, chain, symbol, project, APY (total, base, reward), TVL in USD, stablecoin flag, IL risk, underlying tokens, source URL, and timestamp. Also includes total count, data freshness flag, and attribution to DefiLlama.

## 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": "chain name, e.g. base, ethereum, solana"
      },
      "limit": {
       "type": "integer",
       "default": 50,
       "maximum": 200,
       "minimum": 1
      },
      "symbol": {
       "type": "string"
      },
      "project": {
       "type": "string",
       "description": "DefiLlama project slug, e.g. aave-v3"
      },
      "stablecoin": {
       "type": "boolean"
      },
      "min_tvl_usd": {
       "type": "number"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "count": {
       "type": "integer"
      },
      "pools": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "apy": {
          "type": [
           "number",
           "null"
          ]
         },
         "chain": {
          "type": "string"
         },
         "symbol": {
          "type": "string"
         },
         "il_risk": {
          "type": [
           "string",
           "null"
          ]
         },
         "pool_id": {
          "type": "string"
         },
         "project": {
          "type": "string"
         },
         "tvl_usd": {
          "type": "number"
         },
         "apy_base": {
          "type": [
           "number",
           "null"
          ]
         },
         "exposure": {
          "type": [
           "string",
           "null"
          ]
         },
         "apy_reward": {
          "type": [
           "number",
           "null"
          ]
         },
         "source_url": {
          "type": "string"
         },
         "stablecoin": {
          "type": "boolean"
         },
         "updated_at": {
          "type": "string"
         },
         "underlying_tokens": {
          "type": "array",
          "items": {
           "type": "string"
          }
    
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "pools": [
   {
    "apy": 2.3,
    "chain": "base",
    "symbol": "WETH",
    "pool_id": "…",
    "project": "morpho-blue",
    "tvl_usd": 45000000
   }
  ],
  "stale": false,
  "source": "DefiLlama"
 }
}
```

## More

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