# TBS Crypto & DeFi API – DeFi Yield Pools

> TBS Crypto & DeFi API – DeFi Yield Pools is a paid API for AI agents from crypto-x402.tbs-digital.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-12).

Fetches live DeFi yield/APY pool data filtered by chain, project, token symbol, TVL, or stablecoin flag, sourced from DefiLlama

## Facts

- Endpoint: GET https://crypto-x402.tbs-digital.com/defi/yields?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tbs-crypto-defi-api-defi-yield-pools-7e057c02
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SpB55pp-ulCsJOn_yW6Pa

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-crypto-defi-api-defi-yield-pools-7e057c02
```

Example prompt: Show me the top 10 stablecoin yield pools on Ethereum right now — I want to see APY, TVL, and which protocol they're on, only pools with at least $50M TVL.

## When to prefer this

Choose this endpoint when you need live DeFi yield and APY data across protocols and chains, especially when filtering by specific token, project, chain, or TVL threshold. It is ideal for agents comparing yield farming opportunities or recommending DeFi strategies. Prefer over raw DefiLlama API when you want a unified, keyless, USDC-payable interface with a consistent schema.

## Known failure modes

- Invalid chain name returns empty pool list or 400 error
- Limit outside 1-50 range may cause validation error
- No pools matching filters returns empty array with count 0
- Payment not processed causes 402 response blocking data return
- DefiLlama upstream outage may cause stale or missing data

## How this service works

Crypto & DeFi data for AI agents in one sub-cent call: real-time token prices, market data (market cap, volume, supply), DeFi TVL by protocol or chain, yield/APY pools, and a flagship bundle combining all of it. DefiLlama + Coinpaprika, keyless, unified schema, USDC-payable via x402 on Base.

## Output

Returns a JSON array of yield pools matching the filters, each with APY, base APY, TVL in USD, token symbol, chain, project, and stablecoin flag. Also includes total count, data source (DefiLlama), payer wallet info, a unique request ID, 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"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "payer": {
   "address": "0x0000000000000000000000000000000000000000",
   "network": "base"
  },
  "pools": [
   {
    "apy": 5.21,
    "chain": "Ethereum",
    "symbol": "USDC",
    "project": "aave-v3",
    "tvl_usd": 452000000,
    "apy_base": 5.02,
    "stablecoin": true
   }
  ],
  "source": "defillama",
  "request_id": "0b21c0e6-6a3f-4e2a-8b1e-2f9d4c7a1e55",
  "generated_at": "2026-08-11T12:00:00.000Z"
 }
}
```

## More

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