Yield pool screener API

Multi-criteria yield-pool screener over DefiLlama pools: filter by chain, project, symbol, min/max APY, min TVL, and stablecoin-only, sortable by APY or TVL, returning base/reward APY split, IL risk, exposure, and predicted APY trend. Sourced from DefiLlama yields /pools. Answers 'best Aave pools on Base above 5% APY','highest-TVL stablecoin pools'.

Price$0.01per request

MethodPOST

Route/v1/defi/yields-pool

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

defiyieldapypoolsscreenerfarmingdefillamastablecoin

API URLhttps://x402.hexl.dev/v1/defi/yields-pool

Integration docs

Example request

{
  "chain": "Base",
  "minApy": 5,
  "limit": 2
}

Example response

{
  "count": 1001,
  "sortBy": "apy",
  "filters": {
    "chain": "Base",
    "project": null,
    "symbol": null,
    "minApy": 5,
    "maxApy": null,
    "minTvlUsd": 10000,
    "stablesOnly": false
  },
  "pools": [
    {
      "chain": "Base",
      "project": "aave-v3",
      "symbol": "USDC",
      "tvlUsd": 50000000,
      "apy": 6.2,
      "apyBase": 6.2,
      "apyReward": 0,
      "stablecoin": true,
      "ilRisk": "no",
      "exposure": "single",
      "poolId": "abc-123",
      "apyTrend": "Stable/Up"
    }
  ]
}

Input schema

{
  "type": "object",
  "properties": {
    "chain": {
      "type": "string",
      "examples": [
        "Base",
        "Ethereum",
        "Arbitrum"
      ]
    },
    "project": {
      "type": "string",
      "examples": [
        "aave-v3",
        "curve",
        "lido"
      ]
    },
    "symbol": {
      "type": "string",
      "examples": [
        "USDC",
        "ETH"
      ]
    },
    "minApy": {
      "type": "number",
      "examples": [
        5
      ]
    },
    "maxApy": {
      "type": "number",
      "examples": [
        100
      ]
    },
    "minTvlUsd": {
      "type": "number",
      "default": 10000
    },
    "stablesOnly": {
      "type": "boolean",
      "default": false
    },
    "sortBy": {
      "type": "string",
      "enum": [
        "apy",
        "tvl"
      ],
      "default": "apy"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 100,
      "default": 25
    }
  }
}

Output schema

{
  "type": "object",
  "required": [
    "count",
    "pools"
  ],
  "properties": {
    "count": {
      "type": "number"
    },
    "sortBy": {
      "type": "string"
    },
    "filters": {
      "type": "object",
      "additionalProperties": true
    },
    "pools": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    }
  }
}