# AIServices DeFi Yields

> AIServices DeFi Yields is a paid API for AI agents from api.aiservices.to, paid per call via x402, $0.02/call, status down (last checked 2026-09-15).

Returns DeFi liquidity pool yields (APY, TVL, protocol, chain) filtered by blockchain network

## Facts

- Endpoint: GET https://api.aiservices.to/v1/yields
- Price: $0.02/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aiservices-defi-yields-9f7c7580
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ONzcnINsxePvTWxIjBnYr

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 aiservices-defi-yields-9f7c7580
```

Example prompt: Show me the top 10 DeFi liquidity pools on Ethereum with the highest APY right now, including their TVL and which protocol they're on.

## When to prefer this

Use this endpoint when you need structured, up-to-date DeFi yield data (APY + TVL) across protocols and chains, especially for AI agents that need to compare yield opportunities programmatically. Prefer this over scraping DeFi dashboards or using free-tier APIs when you need reliable, pay-per-call access without rate-limit subscriptions.

## Known failure modes

- Invalid chain name returns empty results or error
- limit parameter out of range may return default count or error
- Payment failure via x402 returns 402 with payment instructions
- Network timeouts if upstream DeFi data sources are slow
- Stale data if yield sources haven't updated recently

## How this service works

Paid data APIs for AI agents — crypto prices, technical indicators, DeFi yields, IP geolocation, URL metadata.

All paid endpoints use x402 protocol with USDC on Base.

## Output

An object containing a 'pools' array where each entry includes the pool name, APY (as a float), chain identifier, TVL in USD, and protocol name — enabling ranking and comparison of DeFi yield opportunities.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string"
  },
  "limit": {
   "type": "integer"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "Response Defi Yields V1 Yields Get",
 "properties": {
  "pools": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "apy": {
      "type": "number"
     },
     "pool": {
      "type": "string"
     },
     "chain": {
      "type": "string"
     },
     "tvl_usd": {
      "type": "number"
     },
     "protocol": {
      "type": "string"
     }
    }
   }
  }
 },
 "additionalProperties": true
}
```

## More

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