{"endpoint":"/api/chain/yield","method":"POST","service_trust":"https://defi-shield-hazel.vercel.app/api/trust-signal","free_check":{"endpoint":"https://defi-shield-hazel.vercel.app/api/free/token-check","method":"POST","price":"FREE","note":"Try before you buy — free basic token safety check with risk math."},"also_available_on":{"virtuals_acp":{"agent":"Authensor","agent_id":18805,"offerings":["pre_trade_safety","token_deep_scan","wallet_report","batch_seal"],"marketplace":"https://app.virtuals.io/acp/scan/agents","note":"Same service, accessible to 18,000+ autonomous agents on Virtuals Protocol."},"mcp_server":{"package":"devsecure-mcp","install":"npx devsecure-mcp","tools":67,"note":"Install as MCP server in Claude, Cursor, or any MCP-compatible client for direct tool access."},"bazaar":"https://defi-shield-hazel.vercel.app/.well-known/x402","agent_card":"https://defi-shield-hazel.vercel.app/.well-known/agent-card.json"},"powered_by":"DeFi Shield by Authensor","price":"$0.25","description":"Fetch the top yield farming and lending opportunities on a specific blockchain from DeFiLlama. Supports filtering by minimum TVL and APY. Returns up to 20 pools sorted by APY descending, plus chain-wide yield statistics.","llm_usage_prompt":"Call this endpoint when searching for the highest-yielding DeFi opportunities on a specific blockchain. Provide chain (required, e.g., 'Ethereum', 'Base', 'Arbitrum'), and optionally min_tvl (minimum pool TVL in USD) and min_apy (minimum APY percentage). Returns up to 20 top yield pools sorted by APY descending, each with pool ID, project name, symbol, APY breakdown (base + reward), TVL, stablecoin flag, and IL risk. Also returns chain-wide statistics: average APY, median APY, median TVL, and total TVL. Use this to find yield opportunities, compare risk-adjusted returns, or filter for safe stablecoin yields with high TVL. Costs $0.25 via x402.","params":{"chain":"string -- chain name (e.g., 'Ethereum', 'Base', 'Arbitrum')","min_tvl":"(optional) number -- minimum pool TVL in USD (default: 0)","min_apy":"(optional) number -- minimum APY percentage (default: 0)"},"exampleRequest":{"chain":"Ethereum","min_tvl":1000000,"min_apy":3},"exampleResponse":{"chain":"Ethereum","pools":[{"pool":"aave-v3-usdc","project":"aave-v3","symbol":"USDC","chain":"Ethereum","apy":5.23,"tvl_usd":1200000000,"apy_base":3.1,"apy_reward":2.13,"stable_coin":true,"il_risk":null}],"pools_returned":20,"total_pools_on_chain":842,"filters_applied":{"min_tvl":1000000,"min_apy":3},"statistics":{"avg_apy":4.2,"median_apy":3.1,"median_tvl":5200000,"total_tvl_on_chain":42000000000},"response_time_ms":1200,"timestamp":"2026-03-06T12:00:00.000Z"}}