# booAIP DeFi Yields API

> booAIP DeFi Yields API is a paid API for AI agents from booaip.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Returns current DeFi yield/APY data across liquidity pools, including TVL, project, and risk flags, for AI agents paying per-call in USDC via x402 on Base.

## Facts

- Endpoint: GET https://booaip.vercel.app/api/yields
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/booaip-defi-yields-api-d6673296
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_deNnIvX2iX8vOwfAXC2BC

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 booaip-defi-yields-api-d6673296
```

Example prompt: Can you pull the top DeFi yield pools right now and show me their APY and TVL — I only want ones that aren't flagged as suspicious?

## When to prefer this

Use this endpoint when an AI agent needs real-time DeFi yield and APY data across multiple protocols, with built-in risk flagging, and is already set up for x402 micropayment authentication on Base. Ideal for agents helping users discover yield opportunities or compare DeFi returns programmatically at low cost per call.

## Known failure modes

- Payment not received or insufficient USDC balance — returns 402 Payment Required
- Invalid or missing POST body parameters — returns 400 Bad Request
- Upstream DeFi data source unavailable — returns 503 or degraded data
- Rate limiting or quota exceeded — returns 429
- No pools matching filter criteria — returns empty pools array with count 0

## How this service works

Top APY yield pools by token symbol and chain, with risk flags (DefiLlama). Body: { symbol?, chain?, limit?, safeOnly? }.

## Output

A JSON object containing a count of results, an array of pools each with APY percentage, TVL in USD, project name, risk flags array, and a suspicious boolean, plus a count of suspicious results in the response set.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string",
   "description": "Optional chain filter."
  },
  "limit": {
   "type": "number",
   "description": "Max pools (1-20)."
  },
  "symbol": {
   "type": "string",
   "description": "Token symbol to search (e.g. USDC)."
  },
  "safeOnly": {
   "type": "boolean",
   "description": "Drop suspicious pools (extreme APY / low TVL)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 5,
  "pools": [
   {
    "apyPct": 4.2,
    "tvlUsd": 1000000,
    "project": "aave-v3",
    "riskFlags": [],
    "suspicious": false
   }
  ],
  "suspiciousInResult": 0
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/booaip-defi-yields-api-d6673296/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from booaip.vercel.app](https://www.zero.xyz/host/booaip.vercel.app/llms.txt)