# AgentServices DeFi Yields API

> AgentServices DeFi Yields API is a paid API for AI agents from agentservices.to, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns current DeFi liquidity pool yields (APY, TVL, protocol, chain) filtered by blockchain and result count

## Facts

- Endpoint: GET https://agentservices.to/v1/yields
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentservices-defi-yields-api-317a213f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wQpHxMVhP6nVYyypgUEbj

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 agentservices-defi-yields-api-317a213f
```

Example prompt: What are the top 10 DeFi liquidity pools by APY on Ethereum right now — show me the pool name, protocol, APY, and total value locked?

## When to prefer this

Choose this endpoint when you need current DeFi yield data (APY, TVL) across multiple protocols on a specific blockchain and want chain-filtered results in a single low-cost call ($0.02 USDC). Prefer this over scraping DeFi dashboards when you need structured, machine-readable pool data for automated decision-making or portfolio optimization. Ideal for agents that need to compare yields programmatically without managing complex DeFi protocol integrations.

## Known failure modes

- Invalid chain name returns empty pool array or 400 error
- Limit parameter exceeding available pools silently returns all available pools
- Payment failure via x402 micropayment returns 402 Payment Required
- Service unavailability or upstream data lag returns 503 or stale data
- Missing required authentication/payment header returns 401 or 402

## How this service works

Paid data APIs for AI agents. Crypto market data, DeFi yields, IP geolocation, dispute resolution, marketing intelligence. Powered by x402 micropayments on Base.

## Output

Returns a JSON object containing an array of liquidity pools, each with: pool identifier, blockchain chain name, DeFi protocol name, current APY as a decimal number, and total value locked in USD. Results can be filtered by chain and limited in count.

## 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/agentservices-defi-yields-api-317a213f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentservices.to](https://www.zero.xyz/host/agentservices.to/llms.txt)