← all AgentPay tools

yield_scanner

Find best DeFi yield opportunities across protocols for a given token.

When agents use this

You need to find the best yield/APY for a token across DeFi protocols.

Parameters

name	type	required	description
chain	string	no
token	string	yes	Token symbol, e.g. ETH, USDC
min_tvl	number	no

Returns

list of pools with protocol, apy, tvl_usd, chain, risk_level sorted by APY descending

Example response

{
  "token": "USDC",
  "pools": [
    {
      "protocol": "morpho",
      "apy": 8.74,
      "tvl_usd": 312000000.0,
      "chain": "Ethereum",
      "risk_level": "low"
    },
    {
      "protocol": "aave-v3",
      "apy": 5.21,
      "tvl_usd": 1840000000.0,
      "chain": "Ethereum",
      "risk_level": "low"
    },
    {
      "protocol": "compound-v3",
      "apy": 4.87,
      "tvl_usd": 920000000.0,
      "chain": "Ethereum",
      "risk_level": "low"
    }
  ],
  "source": "defillama"
}

Call it — HTTP (x402)

curl -X POST https://agentpay.tools/tools/yield_scanner/call \
  -H 'Content-Type: application/json' \
  -d '{"parameters": {"token": "Token symbol, e.g. ETH, USDC"}, "agent_address": "<your wallet or any identifier>"}'

Call it — Python SDK

from agentpay import quickstart  # pip install agentpay-x402

s = quickstart(max_spend=0.10)   # hard budget cap; mints a wallet, no funding needed
r = s.call("yield_scanner", {"token": "Token symbol, e.g. ETH, USDC"})
print(r.data)                    # + r.cost, r.tx, r.network — full receipt

Call it — MCP

npx -y @romudille/agentpay-mcp   # keyless; exposes yield_scanner to any MCP agent runtime