---
title: "Paid: DeFi Yield Explorer"
method: GET
path: "/api/x402/market-yields"
---

# Paid: DeFi Yield Explorer

`GET /api/x402/market-yields`

## Request

- Base URL: `https://three.ws`
- URL: `https://three.ws/api/x402/market-yields`
- Auth: none required

DeFi yield-pool explorer for agents — pay $0.001 USDC per call. Queries ~15,000 pools from DeFiLlama: filter with ?chain=&project=&stablecoin=&search=&minTvl=, sort by tvl or apy (APY sort is dust-guarded to pools ≥ $10k TVL so fake five-digit APYs never outrank real venues), page with limit/offset. Each pool carries APY split (base/reward), 30-day mean, IL risk, exposure, and predicted outlook. Pass ?pool=<uuid> for one pool's APY/TVL history. Same engine behind three.ws/yields.

## Query parameters

- `chain` string
- `project` string
- `stablecoin` string
- `search` string
- `minTvl` string
- `sort` string
- `limit` string
- `offset` string
- `pool` string

## Response `200`

three.ws Market Data 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)