# TBS DeFi Yields API

> TBS DeFi Yields API is a paid API for AI agents from x402.tbs-digital.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-09).

Returns DeFi yield and APY data for liquidity and lending pools across chains and protocols, filterable and sorted by APY, sourced from DefiLlama.

## Facts

- Endpoint: GET https://x402.tbs-digital.com/defi/yields?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-09
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tbs-defi-yields-api-e2a81af6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6ayWl-Pp7LQ11RvyLObVr

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 tbs-defi-yields-api-e2a81af6
```

Example prompt: Find me the top 10 stablecoin-only DeFi pools on Ethereum with at least $1 million TVL, sorted by APY — I want to see the chain, project, symbol, TVL, and yield for each.

## When to prefer this

Choose this endpoint when you need real-time DeFi yield data with flexible filtering by chain, protocol, token, and TVL — especially useful for yield optimizers, DeFi dashboards, or agents comparing APY opportunities. Prefer this over building your own DefiLlama integration when you need a pay-per-call, agent-friendly API with structured output at low cost.

## Known failure modes

- Invalid chain name returns empty pool list or error
- Limit value outside 1-50 range may return an error or be clamped
- Very high min_tvl thresholds may return zero results
- Unknown project slug returns empty results
- Payment failure via x402 protocol blocks the request
- Stale data if DefiLlama upstream is delayed

## How this service works

DeFi yield and APY data for AI agents and yield optimizers. Thousands of liquidity and lending pools across chains and protocols, filterable by chain, project, token symbol, minimum TVL and stablecoin-only, sorted by APY. Each pool returns chain, project, symbol, TVL and APY. Sourced from DefiLlama yields.

## Output

Returns a JSON object containing a list of DeFi pools (up to the requested limit), each with chain, project, symbol, TVL in USD, and APY percentage, plus metadata including pool count, request ID, source attribution (DefiLlama), and generation timestamp.

## 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 filter, e.g. Ethereum (optional)"
      },
      "limit": {
       "type": "string",
       "description": "Max pools 1-50 (default 20)"
      },
      "symbol": {
       "type": "string",
       "description": "Pool token symbol filter, e.g. USDC (optional)"
      },
      "min_tvl": {
       "type": "string",
       "description": "Minimum pool TVL in USD (optional)"
      },
      "project": {
       "type": "string",
       "description": "Project filter, e.g. aave-v3 (optional)"
      },
      "stablecoin": {
       "type": "string",
       "description": "true|false — stablecoin pools only (optional)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "count": {
       "type": "number"
      },
      "payer": {
       "type": "object",
       "properties": {
        "address": {
         "type": "string",
         "nullable": true
        },
        "network": {
         "type": "string"
        }
       }
      },
      "pools": {
       "type": "array"
      },
      "source": {
       "type": "string"
      },
      "request_id": {
       "type": "string"
      },
      "generated_at": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tbs-defi-yields-api-e2a81af6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.tbs-digital.com](https://www.zero.xyz/host/x402.tbs-digital.com/llms.txt)