# three.ws Yield Scan — DeFi Pool Rankings API

> three.ws Yield Scan — DeFi Pool Rankings API is a paid API for AI agents from three.ws, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-11).

Returns ranked DeFi yield pools filtered by chain, stablecoin status, minimum TVL, and sorted by APY or TVL

## Facts

- Endpoint: GET https://three.ws/api/x402/yield-scan?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/three-ws-yield-scan-defi-pool-rankings-api-2007e6d8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hi0oh2BMt_sLK3zosG9aW

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 three-ws-yield-scan-defi-pool-rankings-api-2007e6d8
```

Example prompt: Show me the top 10 stablecoin yield pools on Ethereum with at least $1M TVL, sorted by APY.

## When to prefer this

Choose this endpoint when you need real-time ranked DeFi yield pool data with filtering by chain, stablecoin type, and minimum TVL. It is well-suited for yield optimization agents, DeFi dashboard builders, or portfolio advisors that need structured pool metrics including APY breakdowns and risk signals. Prefer this over manual DeFi aggregator browsing when you need machine-readable, filterable pool data with IL risk and prediction labels included.

## Known failure modes

- Invalid chain name returns empty pool list or 400 error
- limit out of range (>50 or <1) rejected by schema validation
- minTvlUsd set too high returns zero pools
- sort enum value not in [apy, tvl] causes validation failure
- Payment of $0.005 USDC not provided results in 402 Payment Required response

## How this service works

Make a 3D AI agent from a selfie in 60 seconds. Drop one HTML tag to embed it on any website. Agents think on IBM watsonx.ai (Granite); optionally charge per chat with built-in micropayments.

## Output

A JSON object containing a timestamp, pool count, active filters applied, and an array of up to 50 ranked pools. Each pool entry includes: APY (total, base, reward, 30-day mean), TVL in USD, pool UUID, chain, token symbol, project name, impermanent loss risk flag, stablecoin flag, single/multi exposure type, risk flags array, and a yield prediction label (e.g. Stable/Up).

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "properties": {
      "sort": {
       "enum": [
        "apy",
        "tvl"
       ],
       "type": "string",
       "default": "apy",
       "description": "Ranking dimension."
      },
      "chain": {
       "type": "string",
       "description": "Filter to one chain, e.g. Ethereum, Solana, Base (case-insensitive)."
      },
      "limit": {
       "type": "integer",
       "default": 20,
       "maximum": 50,
       "minimum": 1,
       "description": "Pools to return."
      },
      "stable": {
       "type": "boolean",
       "description": "true → stablecoin-denominated pools only."
      },
      "minTvlUsd": {
       "type": "number",
       "default": 100000,
       "minimum": 0,
       "description": "Minimum pool TVL in USD."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ts": "2026-07-11T10:00:00Z",
  "count": 10,
  "pools": [
   {
    "apy": 9.42,
    "pool": "747c1d2a-c668-4682-b9f9-296708a3dd90",
    "chain": "Ethereum",
    "sigma": 0.21,
    "symbol": "USDC",
    "il_risk": "no",
    "project": "example-protocol",
    "tvl_usd": 52400000,
    "apy_base": 6.1,
    "exposure": "single",
    "apy_reward": 3.32,
    "prediction": "Stable/Up",
    "risk_flags": [],
    "stablecoin": true,
    "apy_mean_30d": 8.7
   }
  ],
  "filters": {
   "sort": "apy",
   "chain": null,
   "stable": true,
   "min_tvl_usd": 1000000
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-yield-scan-defi-pool-rankings-api-2007e6d8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from three.ws](https://www.zero.xyz/host/three.ws/llms.txt)