# DeFi Yield Pools Lookup

> DeFi Yield Pools Lookup is a paid API for AI agents from api.chainmarket-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-24).

Returns DeFi lending and liquidity pool yield data (APY, TVL, chain, project) from DefiLlama, optionally filtered by chain or project

## Facts

- Endpoint: GET https://api.chainmarket-api.workers.dev/api/finance/defirate-yields?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-yield-pools-lookup-c70fb1f7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_obv3Psfk-_PI2adM30518

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-yield-pools-lookup-c70fb1f7
```

Example prompt: What are the top 10 DeFi yield pools on Ethereum right now — show me the APY, TVL, and which protocol they're from?

## When to prefer this

Use this endpoint when you need real-time DeFi yield and TVL data across multiple protocols and chains without requiring an API key or account setup. Ideal for agents that need to compare yield opportunities, surface staking rates, or monitor DeFi pool conditions on a pay-per-call basis. Prefer this over direct DefiLlama API calls when operating in an x402 payment-native agent workflow. Best for spot lookups rather than continuous high-frequency monitoring due to per-call pricing.

## Known failure modes

- Invalid chain name (not matching DefiLlama's naming convention) returns empty or unfiltered results
- Invalid project slug returns empty pool list
- Limit outside 1–50 range may be ignored or cause an error
- Payment failure results in no charge and no data returned
- Upstream DefiLlama API unavailability causes service failure

## How this service works

DeFi lending and liquidity pool yields from DefiLlama: APY, base and reward APY, TVL, for pools filtered by chain or project, sorted by TVL. Data is DefiLlama's own estimates and changes often.

## Output

A JSON object containing an array of DeFi pools, each with pool ID, chain, token symbol, project slug, APY (total, base, and reward components), TVL in USD, and stablecoin flag. Also includes total matched pool count, data source URL (yields.llama.fi), and a timestamp of when the data was checked.

## 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": [],
     "properties": {
      "chain": {
       "type": "string",
       "description": "Optional chain name as DefiLlama writes it, e.g. Ethereum, Solana, Arbitrum"
      },
      "limit": {
       "type": "string",
       "description": "How many pools, 1 to 50 (default 10)"
      },
      "project": {
       "type": "string",
       "description": "Optional project slug, e.g. aave-v3, lido, curve-dex"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "pools": [
   {
    "apy": 2.259,
    "pool": "747c1d2a-c668-4682-b9f9-296708a3dd90",
    "chain": "Ethereum",
    "symbol": "STETH",
    "tvlUsd": 23252584677,
    "apyBase": 2.259,
    "project": "lido",
    "apyReward": null,
    "stablecoin": false
   },
   {
    "apy": 2.2338,
    "pool": "80b8bf92-b953-4c20-98ea-c9653ef2bb98",
    "chain": "Ethereum",
    "symbol": "WBETH",
    "tvlUsd": 8476192568,
    "apyBase": 2.2338,
    "project": "binance-staked-eth",
    "apyReward": null,
    "stablecoin": false
   }
  ],
  "source": "https://yields.llama.fi/pools",
  "matched": 400,
  "checkedAt": "2026-10-23T09:36:15.728Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-yield-pools-lookup-c70fb1f7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.chainmarket-api.workers.dev](https://www.zero.xyz/host/api.chainmarket-api.workers.dev/llms.txt)