> For the complete documentation index, see [llms.txt](https://docs.yifi.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yifi.io/docs/earn/getting-started/introduction.md).

# Introduction

Every yield opportunity, one API. Compare markets, deposit in a single transaction, and track the position

### YiFi Earn is one API for DeFi yield

YiFi Earn normalizes yield opportunities across EVM chains and protocols behind a single API and turns a deposit into one signable transaction: **quote, build, sign, track** – without ever taking custody of user funds.

Whether you're building a wallet, a trading bot, a portfolio tracker, or a treasury tool, one integration gives you normalized access to yield across Lending, Liquid Staking, Strategic Vaults, and Stablecoin Vaults – on Ethereum, Base, BNB Chain, HyperEVM, Avalanche, Polygon, Arbitrum, Optimism, and Sonic – without wiring up a single protocol yourself.

#### What you can build

* **Market data** – normalized rates, TVL, and tokens across every protocol in one shape.
* **Execution** – ready-to-sign deposit and withdraw payloads, fully non-custodial.
* **Portfolio** – positions, performance, and history by wallet address. 

Revenue share is built in: a protocol-level fee splits on-chain between YiFi and the attributed partner, by Partner API key – no billing to build. Fees →

#### Why use YiFi Earn

Five ideas carry most of the integration.

1. **One normalized model.** Every chain, protocol, token, and market is normalized into stable, composable entities with predictable IDs. You integrate the model once – adding a protocol or a chain on our side doesn't change your integration.
2. **Routing, not custody.** YiFi runs no vault. A deposit routes straight into the underlying protocol, and the user receives that protocol's own receipt token – an Aave `aToken`, a Lido `stETH`, and so on. YiFi's contracts are never in the ownership chain of the asset.
3. **Execution is a lifecycle.** A deposit is four steps behind one integration: **quote → build → sign → track**. You request a quote and a ready-to-sign payload, the user signs from their own wallet, and you track it to confirmation.
4. **Track performance, not just balance.** A portfolio read-model reports positions, performance, and transaction history by wallet address – not just a snapshot balance.
5. **Revenue share built in.** A protocol-level fee splits on-chain between YiFi and the attributed partner, with attribution by Partner API and whitelisted wallets – no billing infrastructure to build.