# true402 DeFi Yield Lookup

> true402 DeFi Yield Lookup is a paid API for AI agents from true402.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Fetches and filters DeFi liquidity pool yield data (APY, TVL) from DefiLlama, filterable by asset, chain, protocol, TVL floor, and stablecoin type.

## Facts

- Endpoint: POST https://true402.dev/api/v1/defi-yields
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/true402-defi-yield-lookup-49697f8a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xgBBkYMDQrnoCPo5Ue6cT

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 true402-defi-yield-lookup-49697f8a -d '<json body>'
```

Example prompt: Show me the top 10 stablecoin-only DeFi pools on Base with at least $500,000 TVL — I want to see which ones have the best yields right now.

## When to prefer this

Choose this endpoint when you need real-time DeFi yield data filtered by asset, chain, protocol, or TVL without scraping DefiLlama yourself. It is ideal for agents comparing yield opportunities, building DeFi dashboards, or making automated liquidity decisions. Prefer this over raw DefiLlama API access when operating in a pay-per-call agent context via HTTP 402/x402 and needing pre-filtered, ranked results with low overhead.

## Known failure modes

- No pools match filters — returns empty list or zero results
- Invalid chain or project name — case-insensitive match may return no results if spelling is wrong
- limit out of range (must be 1–50) — validation error
- minTvlUsd negative value — validation error
- HTTP 402 payment required if wallet/payment not attached
- DefiLlama upstream unavailable — may return 5xx or stale data

## How this service works

The machine-native marketplace. Wallet = identity. Pay per call with HTTP 402.

## Output

Returns a list of DeFi liquidity pools matching the specified filters, each entry including pool symbol, protocol/project name, chain, APY, and TVL in USD. Results are sorted and capped at the requested limit (default 20, max 50). Outlier pools (as flagged by DefiLlama) are excluded by default.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "asset": {
   "type": "string",
   "description": "Case-insensitive substring match on the pool symbol"
  },
  "chain": {
   "type": "string",
   "description": "Filter by chain, case-insensitive (e.g. \"Base\")"
  },
  "limit": {
   "type": "number",
   "description": "Max pools, 1–50 (default 20), applied after sort"
  },
  "project": {
   "type": "string",
   "description": "Filter by protocol, case-insensitive (e.g. \"aave-v3\")"
  },
  "minTvlUsd": {
   "type": "number",
   "description": "Drop pools below this TVL (USD), ≥ 0"
  },
  "stablecoinOnly": {
   "type": "boolean",
   "description": "Keep only stablecoin pools"
  },
  "includeOutliers": {
   "type": "boolean",
   "description": "Include DefiLlama outlier:true pools (default false)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "asOf": {
   "type": "string"
  },
  "count": {
   "type": "number"
  },
  "pools": {
   "type": "array"
  },
  "query": {
   "type": "object"
  },
  "source": {
   "type": "string"
  }
 }
}
```

## More

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