What is the vaults.fyi API?
A single integration point for DeFi yield data, transaction execution, and portfolio tracking across 1,000+ vaults on 20+ networks.
vaults.fyi gives developers access to standardized onchain yield data, ready-to-sign transaction payloads, and portfolio tracking across 80+ DeFi protocols without building or maintaining direct protocol integrations.
One API key. One set of endpoints. Everything you need to surface, compare, and transact on DeFi yield in your product. Available via our API or SDK.
What does the vaults.fyi API do?
It solves three problems developers hit when trying to integrate DeFi yield:
- Data fragmentation. Every protocol has a different contract interface, different APY calculation method, and different update cadence. vaults.fyi normalizes all of this into a single schema: APY as a standardized decimal, TVL in USD, rewards broken out from base yield, and risk scores on a common scale.
- Transaction complexity. Building deposit and redeem flows for each protocol means handling different ABIs, allowance logic, and chain differences. The transactions API returns ready-to-sign calldata for any supported vault action. Pass it directly to your wallet provider.
- Portfolio tracking. The portfolio endpoints return a user's current vault positions, idle assets, and ranked deposit suggestions based on their existing holdings.
What data does it return?
The core endpoint is GET /v2/detailed-vaults.
It returns per-vault data including:
- Base APY and reward APY, as 1-day, 7-day, and 30-day trailing averages
- TVL and liquidity at the vault and protocol level
- Reward tokens with emission rates and APY contribution
- Vault capacity and current utilization
- Reputation Score for programmatic risk filtering
- Active warnings with severity levels
All APY values are raw decimals. Multiply by 100 to display as a percentage. Pagination uses page and perPage with a nextPage field in the response.
What networks and protocols does it cover?
Currently 20+ EVM-compatible networks, including Ethereum mainnet, Arbitrum, Base, Optimism, Polygon, and Berachain. Protocols include Aave, Morpho, Compound, Euler, Sky, Yearn, Lido, ether.fi, Pendle, Fluid, and 70+ others.
Use allowedNetworks and allowedAssets as query parameters to scope responses to what your product supports. Use minVaultScore to filter to established vaults by Reputation Score threshold. Consumer wallets typically set 70+.
How do you build transactions with it?
Three steps to build transactions:
1. Call GET /v2/transactions/context/{userAddress}/{network}/{vaultAddress} to get current balances, deposit limits, and the full action flow for that vault. The context response describes what steps are required before a transaction can be submitted. Some vaults (Lido stETH, Veda vaults, and others) have multi-step redemptions with a cooldown: you initiate the withdrawal, wait for the unbonding period, then claim. The context endpoint tells you which step the user is on and what's available to them next.
2. Call GET /v2/transactions/{action}/{userAddress}/{network}/{vaultAddress} with action set to deposit, redeem, initiate-redeem, or claim to get ready-to-sign calldata for that step.
3. Pass the calldata to your wallet provider. No ABI encoding required.
For cross-chain deposits, our endpoints handle the full quote -> execute -> status lifecycle via Rhinestone's intent network.
Does it track yield positions too?
Portfolio tracking endpoints give you a wallet-level view across every supported vault. Pass a wallet address to get current positions, claimable rewards, and PnL breakdowns for each position.
The /v2/best-deposit-options/ endpoint ranks available vaults against a user's current holdings. This is useful for apps that want to serve relevant opportunities to the user, without building custom aggregations and logic.
Who uses the vaults.fyi API?
Jumper uses it to surface yield opportunities across DeFi. Kraken's Beholder wallet uses it to power a non-custodial earn feature. Gauntlet uses it for data and analytics. KPK integrates it for vault data and portfolio tracking features inside the KPK app.
How do I get access?
Request access here or reach out directly to @ryanrodenbaugh on Telegram.
For a walkthrough of integrating vault data, transactions, and portfolio tracking into a wallet or app, see our quick start here or read more at docs.vaults.fyi.
