# DefiLlama Yield Pools Lookup

> DefiLlama 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).

Fetches live DeFi yield pool data from DefiLlama, filterable by chain, token symbol, and project

## Facts

- Endpoint: GET https://api.chainmarket-api.workers.dev/api/crypto/defillama-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/defillama-yield-pools-lookup-605f5fc9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GWV5cMqdQyTHW8FHGFCFu

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 defillama-yield-pools-lookup-605f5fc9
```

Example prompt: What's the current APY and TVL for USDC pools on Aave v3 across Ethereum — including any reward APY on top of the base rate?

## When to prefer this

Use this endpoint when you need live, per-pool DeFi yield data (APY, TVL, reward tokens) from DefiLlama for a specific chain, token, or protocol. It's ideal for agents comparing lending or LP yields across DeFi protocols without needing an API key or account. Prefer this over general crypto price endpoints when the user wants yield/APY data rather than spot prices, and over raw DefiLlama API access when you want pay-per-call with no setup overhead.

## Known failure modes

- No pools returned if chain/symbol/project combination doesn't exist in DefiLlama — returns empty pools array
- Invalid chain name (must match DefiLlama's exact casing, e.g. 'Ethereum' not 'ethereum') may return zero results
- Payment failure results in no charge and no data returned
- Rate or availability issues with the upstream DefiLlama API may cause errors or stale data

## How this service works

DeFi pool APY (total, base, reward), TVL, 7/30-day APY change and impermanent-loss estimate (il7d, ilRisk) from DefiLlama. Filter by project, chain and symbol; returns up to 20 pools by TVL. APY is DefiLlama's estimate, not a guaranteed return.

## Output

Returns a list of matching yield pools from DefiLlama, each with pool ID, chain, project, token symbol, TVL in USD, base APY, reward APY, combined APY, IL risk flag, stablecoin flag, reward token count, and 7-day and 30-day APY percentage changes. Also includes a count of returned pools, the source URL, 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": "Chain name as DefiLlama writes it, e.g. Ethereum, Base, Arbitrum"
      },
      "symbol": {
       "type": "string",
       "description": "Token symbol or pair text, e.g. USDC or WETH-USDC"
      },
      "project": {
       "type": "string",
       "description": "DefiLlama project slug, e.g. aave-v3, curve-dex, uniswap-v3"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 4,
  "pools": [
   {
    "apy": 3.77877,
    "il7d": null,
    "pool": "aa70268e-4b52-42bf-a116-608b370f9501",
    "chain": "Ethereum",
    "ilRisk": "no",
    "symbol": "USDC",
    "tvlUsd": 151794709,
    "apyBase": 3.77877,
    "project": "aave-v3",
    "apyPct7D": 0.03713,
    "exposure": "single",
    "apyPct30D": -0.16494,
    "apyReward": null,
    "stablecoin": true,
    "rewardTokenCount": 0
   },
   {
    "apy": 5.55877,
    "il7d": null,
    "pool": "6f00d46b-8735-49ae-9ced-2a0fccc56ad0",
    "chain": "Ethereum",
    "ilRisk": "no",
    "symbol": "USDC",
    "tvlUsd": 54818865,
    "apyBase": 3.77877,
    "project": "aave-v3",
    "apyPct7D": 0.00713,
    "exposure": "single",
    "apyPct30D": -0.05494,
    "apyReward": 1.78,
    "stablecoin": true,
    "rewardTokenCount": 1
   }
  ],
  "source": "https://yields.llama.fi/pools",
  "checkedAt": "2026-10-23T09:35:53.878Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defillama-yield-pools-lookup-605f5fc9/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)