Name: defi-yield-pools
Price: 0.005 USDC
Availability: InStock

$ man defi-yield-pools

agentutility / edge-market / defi-yield-pools

PRICE / CALL

$0.005

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

edgemarket

CATEGORY

uncategorized

STATUS

● live

NAME

defi-yield-pools — filters and ranks thousands of defi yield-bearing pools by apy across every chain defillama tracks

SYNOPSIS

POST https://x402.agentutility.ai/defi-yield-pools
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Filters and ranks thousands of DeFi yield-bearing pools by APY across every chain DeFiLlama tracks. Filters: chain, project, asset symbol, stablecoin-only, single-vs-LP exposure, TVL minimum, APY range, impermanent-loss risk. Returns pool ID, chain, project, symbol, current APY (base + reward), 30-day mean APY, day/week/month APY change, TVL, exposure, IL risk, and predicted-class. Differentiates from defi-llama-protocol (single-protocol TVL): this is the yield-discovery surface. Use it as an APY aggregator, yield-farming opportunity finder, DeFiLlama yields feed, cross-protocol APY ranking, or source for stablecoin yields and LP pool returns.

INPUT — request schema

property	type	description	req?
chain	string	e.g. 'Ethereum', 'Base', 'Arbitrum'. Exact-case match against DeFiLlama's chain field.	optional
project	string	e.g. 'aave-v3', 'lido', 'uniswap-v3'. Exact match against DeFiLlama project slug.	optional
symbol	string	Substring match against pool symbol, e.g. 'USDC'.	optional
stablecoin_only	boolean	Only stablecoin pools.	optional
single_only	boolean	Only single-asset exposure (excludes LP pairs).	optional
min_tvl_usd	number	Minimum TVL in USD.	optional
min_apy	number	Minimum APY %.	optional
max_apy	number	Maximum APY % (filters out outliers).	optional
il_risk	string	Filter by impermanent-loss risk classification. enum: no · yes	optional
order_by	string	Default 'apy'. enum: apy · tvlUsd · apyBase · apyReward	optional
limit	number	1-500. Default 50.	optional

OUTPUT — response shape

field	type	description
pools	string	Array of yield pool objects, each with chain, project, symbol, APY breakdown, TVL, exposure, and IL risk.
count	string	Number of pools returned in the pools array after filters and any result-limit truncation.
matched_count	string	Total pools matching the requested filters before any truncation to the returned page.
universe_count	string	Total pools in the DeFiLlama yields universe before filters are applied.
summary	string	Short text rollup of the result set: top APYs, dominant chains/projects, and TVL coverage.
attribution	string	Upstream data credit string pointing to DeFiLlama yields as the source of pool data.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/defi-yield-pools \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the defi-yield-pools tool from your MCP-aware agent.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: defiyield-aggregatorapy-rankingdefillamastablecoin-yieldsliquidity-poolsyield-farmingpool-screener
methods: POST
cluster: edgemarket
price: $0.005 USDC per call

ADJACENT — other endpoints in edgemarket

endpoint	description	price
agent-card-resolve	Resolves an ERC-8004 agentId to its on-chain owner, agentURI, and agent card JSON.	$0.005
arbitrage-spread	Finds the cross-exchange arbitrage spread for any CoinGecko-listed coin.	$0.005
basename-resolve	Resolves Coinbase Basenames (.base.eth) to Ethereum addresses and back, reading the Base mainnet L2 Resolver on-chain (no gas, no wallet).	$0.005
cid-fetch	Fetches the content behind an IPFS CID and optional path through public gateways, returning text, JSON, or base64 with a 5 MB cap.	$0.005
current-balance	Reads a wallet's current ERC-20 token balance with a read-only balanceOf call on Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, or Ava…	$0.005
erc20-balance	Reads an ERC-20 token balance on-chain across any supported EVM chain, including Base, Ethereum, Arbitrum, Optimism, and Polygon.	$0.005
erc20-metadata	Reads ERC-20 token metadata: name(), symbol(), decimals(), and totalSupply() in parallel via public RPC on Base, Ethereum, Arbitrum, Opti…	$0.005
flagged-tokens	Feed of flagged risky Solana tokens: thin liquidity, extreme moves, sell pressure, very new pairs, and missing profile context.	$0.005