# DeFi Yield Pool Rankings by APY

> DeFi Yield Pool Rankings by APY is a paid API for AI agents from meryol-agenticmarket-x402.hf.space, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Returns the top-N DeFi yield pools across all chains sorted by APY, with live APY, 30-day mean, stability score, TVL, impermanent loss risk, and risk caveats

## Facts

- Endpoint: GET https://meryol-agenticmarket-x402.hf.space/yields/best
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/meryol-agenticmarket-x402-hf-space-0cba3005
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_W5APH1nAAj-2VefymXg9Q

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 meryol-agenticmarket-x402-hf-space-0cba3005
```

Example prompt: Show me the top 5 USDC yield pools on Base with at least $1 million TVL — stablecoins only — and flag any with impermanent loss risk or shady reward-token pressure so I can decide where to park my idle treasury.

## When to prefer this

Use this endpoint when an AI agent needs to identify the best current DeFi yield opportunities for a treasury or idle stablecoin position, especially when risk-aware filtering (TVL floor, stability score, IL flags, caveats) matters more than just raw APY. Prefer over raw DeFi aggregator APIs when you need pre-ranked, multi-source data with built-in risk signals and chain/asset filtering in a single call.

## Known failure modes

- No pools match the specified filters — returns empty pools array
- Invalid chain or asset value — may return empty results or 400 error
- min_tvl or max_results passed as non-numeric string — parameter ignored or error
- Upstream liquidity data source unavailable — stale or partial results
- Rate limit or payment failure via x402 — 402 payment required response

## How this service works

Finds the highest-yield opportunities on the market.

## Output

An array of ranked yield pool objects, each containing live APY, 30-day mean APY, a stability score (1 - sigma/mu), TVL, an impermanent loss risk flag, single vs multi asset exposure type, and a human-readable caveat string highlighting risks like reward-token sell pressure, very high APY anomalies, or IL exposure. Also includes metadata: requested chain, requested asset, min TVL filter applied, and query timestamp.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "asset": "USDC",
   "chain": "base",
   "min_tvl": "1000000",
   "max_results": "5",
   "stable_only": "true"
  }
 }
}
```

## 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",
     "required": [],
     "properties": {
      "asset": {
       "type": "string"
      },
      "chain": {
       "type": "string"
      },
      "min_tvl": {
       "type": "string"
      },
      "max_results": {
       "type": "string"
      },
      "stable_only": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "pools"
     ],
     "properties": {
      "pools": {
       "type": "array"
      },
      "min_tvl": {
       "type": "number"
      },
      "queried_at": {
       "type": "integer"
      },
      "requested_asset": {
       "type": "string"
      },
      "requested_chain": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "pools",
  "min_tvl",
  "queried_at",
  "requested_asset",
  "requested_chain"
 ],
 "properties": {
  "pools": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "apy",
     "chain",
     "caveat",
     "symbol",
     "il_risk",
     "pool_id",
     "project",
     "tvl_usd",
     "exposure",
     "stablecoin",
     "apy_mean_30d",
     "apy_stability"
    ],
    "properties": {
     "apy": {
      "type": "number"
     },
     "chain": {
      "type": "string"
     },
     "caveat": {
      "type": "string"
     },
     "symbol": {
      "type": "string"
     },
     "il_risk": {
      "type": "string"
     },
     "pool_id": {
      "type": "string"
     },
     "project": {
      "type": "string"
     },
     "tvl_usd": {
      "type": "number"
     },
     "exposure": {
      "type": "string"
     },
     "stablecoin": {
      "type": "boolean"
     },
     "apy_mean_30d": {
      "type": "number"
     },
     "apy_stability": {
      "type": "number"
     }
    }
   }
  },
  "min_tvl": {
   "type": "number"
  },
  "queried_at": {
   "type": "number"
  },
  "requested_asset": {
   "type": "string"
  },
  "requested_chain": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/meryol-agenticmarket-x402-hf-space-0cba3005/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from meryol-agenticmarket-x402.hf.space](https://www.zero.xyz/host/meryol-agenticmarket-x402.hf.space/llms.txt)