---
title: "Paid: Yield Scanner"
method: GET
path: "/api/x402/yield-scan"
---

# Paid: Yield Scanner

`GET /api/x402/yield-scan`

## Request

- Base URL: `https://three.ws`
- URL: `https://three.ws/api/x402/yield-scan`
- Auth: none required

three.ws Yield Scanner — pay $0.005 USDC per call to screen 15,000+ live DeFi yield pools in one request. Filter by chain, minimum TVL, and stablecoin-only exposure; sort by APY or TVL. Every returned pool carries the full APY breakdown (base vs reward, 30-day mean), pool TVL, and derived risk flags: impermanent-loss exposure, APY volatility (sigma), an apy-spike flag when the current rate runs far above its 30-day mean, and the upstream outlier marker. Live DeFiLlama yields data, refreshed every 10 minutes. Unavailable data refuses before settlement — no charge for an empty scan.

## Query parameters

- `chain` string
- `stable` boolean
- `minTvlUsd` number
- `sort` 'apy' | 'tvl'
- `limit` integer

## Response `200`

three.ws Yield Scanner result JSON

## Other responses

- `400`: Validation error
- `402`: Payment Required (x402)

---

[API](https://skmtc.dev/three/apis/three-ws-api.md) · [All operations](https://skmtc.dev/three/apis/three-ws-api/llms.txt) · [OpenAPI document](https://skmtc.dev/three/apis/three-ws-api/revisions/dbc5e3a81b79?raw)