DeFi Yield Finder API
Best DeFi yields by token — APY, TVL, risk, protocol. DeFiLlama-powered. x402.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport sse defi-yield-finder-api 'https://defi-yields.api.klymax402.com/mcp'{
"mcpServers": {
"defi-yield-finder-api": {
"type": "sse",
"url": "https://defi-yields.api.klymax402.com/mcp"
}
}
}Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
DeFi Yield Finder API
Best DeFi yields ranked by APY -- lending, staking, LP across 100+ protocols. Powered by DeFiLlama. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.
Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.
Quickstart -- MCP
Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):
{
"mcpServers": {
"defi-yields": {
"url": "https://defi-yields.api.klymax402.com/mcp"
}
}
}Quickstart -- HTTP (x402)
curl "https://defi-yields.api.klymax402.com/api/yields?token=..."
# -> 402 Payment Required, with an x402 payment challenge in the response bodyAny x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.
Tools
| Tool | Method | Path | Price | Description |
|---|---|---|---|---|
defi_find_best_yields | GET | /api/yields | $0.005 | Find best DeFi yield opportunities for a token |
defi_find_best_yields | POST | /api/yields | $0.005 | Find best DeFi yield opportunities for a token (POST variant) |
defi_find_best_yields
Use this when you need to find the best DeFi yields for a token across all chains and protocols. Returns ranked opportunities in JSON.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
token | string | yes | Token symbol to find yields for (e.g. USDC, ETH, WBTC) |
chain | string | no | Filter by chain (e.g. base, ethereum, arbitrum, polygon). Optional — returns all chains if omitted. |
minTvl | number | no | Minimum TVL in USD to filter pools (default: 100000) |
limit | number | no | Number of results to return (default: 10, max: 50) |
Returns
pool-- pool/vault name and pairprotocol-- protocol name (Aave, Compound, Lido, Aerodrome, etc.)chain-- which blockchain networkapy-- current annual percentage yieldtvl-- total value locked in USDriskLevel-- risk assessment (low/medium/high)type-- yield type (lending, staking, LP, vault)
Example response:
{"pools":[{"pool":"USDC Lending","protocol":"Aave V3","chain":"base","apy":4.82,"tvl":125000000,"riskLevel":"low","type":"lending"}],"token":"USDC","totalPools":15}When to use: deploying idle capital to find the highest safe yield. Essential for yield optimization and DeFi strategy comparison.
Not for: swap quotes (use dex_get_swap_quote), wallet balance (use wallet_get_portfolio), liquidation risk (use defi_get_liquidation_levels).
defi_find_best_yields
Use this when you need to find the best DeFi yields for a token across all chains and protocols. Returns ranked opportunities in JSON. POST variant of defi_find_best_yields -- same params passed as JSON body instead of query string.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
token | string | yes | Token symbol to find yields for (e.g. USDC, ETH, WBTC) |
chain | string | no | Filter by chain (e.g. base, ethereum, arbitrum, polygon). Optional — returns all chains if omitted. |
minTvl | number | no | Minimum TVL in USD to filter pools (default: 100000) |
limit | number | no | Number of results to return (default: 10, max: 50) |
Returns
pool-- pool/vault name and pairprotocol-- protocol name (Aave, Compound, Lido, Aerodrome, etc.)chain-- which blockchain networkapy-- current annual percentage yieldtvl-- total value locked in USDriskLevel-- risk assessment (low/medium/high)type-- yield type (lending, staking, LP, vault)
Example response:
{"pools":[{"pool":"USDC Lending","protocol":"Aave V3","chain":"base","apy":4.82,"tvl":125000000,"riskLevel":"low","type":"lending"}],"token":"USDC","totalPools":15}When to use: deploying idle capital to find the highest safe yield. Essential for yield optimization and DeFi strategy comparison.
Not for: swap quotes (use dex_get_swap_quote), wallet balance (use wallet_get_portfolio), liquidation risk (use defi_get_liquidation_levels).
Example agent prompts
- "Find the best DeFi yields for a token across all chains and protocols"
- "Find the best DeFi yields for a token across all chains and protocols"
Payment
- Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key
- Network: Base L2 (
eip155:8453) - Asset: USDC
- Facilitator: Coinbase CDP (primary), PayAI (fallback)
- Also reachable via ATXP (OAuth-wrapped x402, RFC 9728 protected-resource metadata)
Part of klymax402
100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.
- Catalog: https://klymax402.com/llms.txt
- Full API reference: https://klymax402.com/llms-full.txt
- Live stats: https://klymax402.com/stats
License
MIT
Frequently asked questions
What is DeFi Yield Finder API?
Best DeFi yields by token — APY, TVL, risk, protocol. DeFiLlama-powered. x402.
How do I install DeFi Yield Finder API?
It runs as a remote server. In Claude Code: claude mcp add --transport sse defi-yield-finder-api 'https://defi-yields.api.klymax402.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does DeFi Yield Finder API need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is DeFi Yield Finder API open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains DeFi Yield Finder API?
It is published by Br0ski777. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.