DeFi Yield Finder API
Best DeFi yields by token — APY, TVL, risk, protocol. DeFiLlama-powered. x402.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
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"
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
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 body
Any 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
الأسئلة الشائعة
ما هو DeFi Yield Finder API؟
Best DeFi yields by token — APY, TVL, risk, protocol. DeFiLlama-powered. x402.
كيف أثبّت DeFi Yield Finder API؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport sse defi-yield-finder-api 'https://defi-yields.api.klymax402.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج DeFi Yield Finder API إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل DeFi Yield Finder API مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون DeFi Yield Finder API؟
ينشره Br0ski777. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.