{"openapi":"3.0.0","info":{"title":"Bitte Beefy API","description":"API for finding opportunities from Beefy Finance.","version":"1.0.0"},"servers":[{"url":"https://bitte-beefy-agent.vercel.app"}],"x-mb":{"account-id":"","assistant":{"name":"Beefy Yield Agent","description":"An assistant that helps find the best yield opportunities on Beefy Finance with safety in mind and can execute vault transactions.","instructions":"Get top-beefy-vaults, then analyze metrics to suggest the best opportunities matching user requirements. Can generate deposit URLs using generate-deposit-url tool to help users connect their wallet and deposit. Supports multiple EVM networks.","tools":[{"type":"function","function":{"name":"generate-deposit-url","description":"Creates a clickable deposit URL that opens our deposit interface with pre-filled parameters. Example: Calling this with vault=0x123... amount=1000000 chainId=8453 returns a URL you can click to deposit 0.001 ETH","parameters":{"type":"object","properties":{"vault":{"type":"string","description":"Vault address (e.g., 0xA6854c1F54198D351D6d4263806F5A876099839b for cbETH-WETH LP)"},"amount":{"type":"string","description":"Amount in wei (e.g., 1000000000000000 for 0.001 ETH)"},"chainId":{"type":"number","description":"Chain ID (e.g., 8453 for Base network)"},"tokenAddress":{"type":"string","description":"Token address (e.g., 0x4200000000000000000000000000000000000006 for WETH on Base)"}},"required":["vault","amount","chainId","tokenAddress"]}}}],"image":"https://bitte-beefy-agent.vercel.app/beefy-agent-logo.png"}},"components":{"schemas":{},"parameters":{}},"paths":{"/api/top-beefy-vaults":{"get":{"operationId":"top-beefy-vaults","description":"Get highest yielding vaults from Beefy Finance with detailed information about TVL, platform, chain, risks, and safety scores (0-100). Example: 'Show me the top 5 yield opportunities, taking into account safety scores and platform stability'","tags":["Vaults"],"responses":{"200":{"description":"Returns top 200 vaults sorted by TVL, including detailed vault information","content":{"application/json":{"schema":{"type":"object","properties":{"vaults":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"apy":{"type":"number"},"tvl":{"type":"number"},"platform":{"type":"string"},"chain":{"type":"string"},"assets":{"type":"array","items":{"type":"string"}},"vaultAddress":{"type":"string"},"risks":{"type":"array","items":{"type":"string"}},"addLiquidityUrl":{"type":"string"},"lastHarvest":{"type":"number"},"lpBreakdown":{"type":"object","properties":{"price":{"type":"number"},"tokens":{"type":"array","items":{"type":"string"}},"balances":{"type":"array","items":{"type":"string"}},"totalSupply":{"type":"string"}},"required":["price","tokens","balances","totalSupply"]},"safetyScore":{"type":"number"}},"required":["name","description","apy","tvl","platform","chain","assets","vaultAddress","addLiquidityUrl"]}},"timestamp":{"type":"string"}},"required":["vaults","timestamp"]}}}},"400":{"description":"Bad request or failed to fetch data from Beefy API","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/api/health":{"get":{"operationId":"health-check","description":"Check if the service is running","responses":{"200":{"description":"Service status","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"timestamp":{"type":"string"}},"required":["status","timestamp"]}}}}}}},"/api/generate-deposit-url":{"post":{"operationId":"generate-deposit-url","description":"Generate a URL for depositing into a Beefy vault. Returns a clickable link that opens our deposit interface with pre-filled transaction details.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"vault":{"type":"string","description":"The vault address to deposit into"},"amount":{"type":"string","description":"The amount to deposit in ETH"},"chainId":{"type":"number","description":"The chain ID where the vault is deployed"},"vaultId":{"type":"string","description":"The Beefy vault identifier for linking to app.beefy.com"},"tokenAddress":{"type":"string","description":"The address of the token to deposit (WETH for ETH deposits)"}},"required":["vault","amount","chainId","tokenAddress"]}}}},"responses":{"200":{"description":"Transaction URL generated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"URL to the deposit interface with pre-filled parameters"},"message":{"type":"string","description":"Human readable description of the deposit"}},"required":["url","message"]}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]}}}}}}}}}