# Agent Data Desk – DeFi Yields

> Agent Data Desk – DeFi Yields is a paid API for AI agents from x402-seller.zshnfaizal.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Returns filtered DeFi yield pool data (APY, TVL, project, symbol) from DefiLlama for a specified chain and criteria

## Facts

- Endpoint: GET https://x402-seller.zshnfaizal.workers.dev/v1/defi/yields
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-data-desk-defi-yields-8dc80530
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cIfw31Jp9rgSJ-VIG73up

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 agent-data-desk-defi-yields-8dc80530
```

Example prompt: Show me the top 10 DeFi yield pools on Base that include USDC, with at least $500,000 TVL and an APY under 500% — I want to see what Aerodrome or Aave v3 are offering right now.

## When to prefer this

Choose this endpoint when an AI agent needs real-time DeFi yield data filtered by chain, token, project, TVL, or APY without setting up API keys or accounts. It is ideal for agents that need to compare yield opportunities across DeFi protocols programmatically and can pay $0.002 USDC per call via x402. Prefer it over direct DefiLlama API calls when you need a pay-per-use, keyless integration with pre-built filtering logic.

## Known failure modes

- Invalid or unrecognized chain name returns empty pool list or error
- limit out of range (must be 1-100) may return validation error
- No pools matching filters returns count 0 with empty pools array
- Payment failure (insufficient USDC balance or x402 protocol error) blocks the call
- Rate limiting or DefiLlama upstream outage may return stale cached data or error
- Extremely restrictive filter combinations (very high min_tvl + low max_apy) may return zero results

## How this service works

Pay-per-call data for AI agents: weather ($0.005), defi_yields ($0.002), token_balance ($0.002), markdown ($0.01). USDC on Base mainnet via x402 v2; no API keys, no accounts.

## Output

A JSON object containing an array of yield pools, each with pool ID, chain, symbol, project slug, APY (total, base, and reward components), TVL in USD, and a DefiLlama URL. Also includes metadata: applied filters, data source, fetch timestamp, and cache status (hit/miss).

## 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",
     "required": [
      "chain"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "Chain name as used by DefiLlama (case-insensitive): base, ethereum, arbitrum, optimism, polygon, bsc, solana, avalanche... Omit for all chains."
      },
      "limit": {
       "type": "integer",
       "description": "Max pools to return (1-100)."
      },
      "symbol": {
       "type": "string",
       "description": "Only pools whose symbol contains this text, e.g. USDC."
      },
      "max_apy": {
       "type": "number",
       "description": "Drop pools with APY above this percent (outlier guard). Default 1000; 0 disables."
      },
      "min_tvl": {
       "type": "number",
       "description": "Minimum pool TVL in USD. Default 100000 with a chain, 1000000 without."
      },
      "project": {
       "type": "string",
       "description": "Only pools from this DefiLlama project slug, e.g. aave-v3, morpho-blue."
      },
      "stablecoin": {
       "type": "boolean",
       "description": "true = only pools DefiLlama flags as stablecoin pools."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "pools",
      "count"
     ],
     "properties": {
      "cache": {
       "type": "string"
      },
      "count": {
       "type": "integer"
      },
      "pools": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "apy": {
          "type": "number"
         },
         "url": {
          "type": "string"
         },
         "pool": {
          "type": "string"
         },
         "chain": {
          "type": "string"
         },
         "symbol": {
          "type": "string"
         },
         "tvlUsd": {
          "type": "number"
         },
         "apyBase": {
          "type": [
           "number",
           "null"
          ]
         },
    
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cache": "miss",
  "count": 5,
  "pools": [
   {
    "apy": 42.1,
    "url": "https://defillama.com/yields/pool/c07a115f-7299-4dd1-ac25-2de459010b6b",
    "pool": "c07a115f-7299-4dd1-ac25-2de459010b6b",
    "chain": "Base",
    "symbol": "WETH-USDC",
    "tvlUsd": 12345678,
    "apyBase": 12.3,
    "project": "aerodrome-slipstream",
    "apyReward": 29.8,
    "stablecoin": false
   }
  ],
  "source": "yields.llama.fi/pools",
  "filters": {
   "chain": "Base",
   "limit": 5,
   "max_apy": 1000,
   "min_tvl": 1000000
  },
  "fetched_at": "2026-08-29T20:05:12.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-data-desk-defi-yields-8dc80530/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-seller.zshnfaizal.workers.dev](https://www.zero.xyz/host/x402-seller.zshnfaizal.workers.dev/llms.txt)