<!-- tempo-docs-context -->
> Source: [/docs/earn/how-it-works](https://tempo.com/developers/docs/earn/how-it-works.md)
> Section: [Earn](https://tempo.com/developers/docs/earn.md). Choose a vault, deposit stablecoins, read positions, and withdraw. Earn is in beta; see the introduction for access.
> [Documentation index](https://tempo.com/developers/llms.txt) · [Docs skill](https://tempo.com/developers/SKILL.md)

> Tempo MCP: Use `search`, `find_pages`, `read_page`, and `code` at `https://mcp.tempo.xyz` for Tempo and related documentation.
> If an indexed page is missing or reflects an older site, read this site’s [documentation index](https://tempo.com/developers/llms.txt) and Markdown pages directly.

# How Earn works

When your application deposits stablecoins into a vault, the account receives shares representing its position. Use the shares' current asset value to display an earning balance, and the vault's withdrawal interface to return stablecoins to the account.

An account deposits stablecoins into a vault and receives vault shares. The vault's engine connects it to one strategy, such as U.S. Treasuries, institutional credit, or collateralized lending.

Each vault connects to one strategy through its engine.

| Component | Role |
| --- | --- |
| **Vault** | Accepts deposits and accounts for positions. |
| **Vault shares** | Units representing an account's position in the vault. Check the selected vault's share token and contract interface. |
| **Engine** | Connects the vault to a lending market, managed strategy, or liquidity pool. |

A share is not necessarily worth one stablecoin. Its value changes with the underlying strategy's returns, losses, and fees. An account's **position value** is the asset value of all its shares; **earnings** are returns over a period, separate from deposits and withdrawals.

The account that deposits holds the shares: each customer's account, or a company account that your ledger allocates.

The [Earn API](https://tempo.com/developers/docs/api/earn) exposes the vault's engine, share token, accepted asset, accounting state, and supported operations.

## Keep value and liquidity separate

A position's value isn't necessarily the amount the account can withdraw immediately. Read the vault's withdrawal methods and current terms before showing funds as available.

A vault's `verified` flag marks a curated listing, not a risk rating or a guaranteed return. [Choose a vault](https://tempo.com/developers/docs/earn/vaults) based on its accepted asset, access rules, strategy, and withdrawal behavior.

## Fees and revenue share

A vault can pay a share of its returns to fee recipients, such as your platform. Earn fees apply only to returns above the vault's previous high in value per share, never to deposited principal.

Illustrative split of $100.00 in returns: 20%, or $20.00, to your business as a fee recipient and 80%, or $80.00, to your customers.

| Fee | How it is calculated | Example on a 5% return |
| --- | --- | --- |
| **Fixed fee** | A percentage of positive returns, paid to one recipient. A vault supports up to four. | A 20% fee leaves customers 4% and pays the recipient 1%. |
| **Excess-return fee** | A percentage of returns above a target rate for customers, paid to one recipient. | A 4% target with a 100% fee leaves customers 4% and pays the recipient the remaining 1%. |

At 1%, $10 million in balances earns the fee recipient $100,000 a year. Returns vary, so the fee amount does too.

The vault takes fees by issuing new shares for its fee recipients, so the share price and the observed `apy.vault` already reflect them. Fees charged by the underlying venue are reflected in the engine's reported value. See [what customers net](https://tempo.com/developers/docs/earn/vaults#what-customers-net) for the costs outside the observed rate.

Fee terms are set per vault; `state.feesActive` reports whether a vault charges Earn fees. [Contact Tempo](https://tempo.com/contact) to configure fee recipients for your Earn program.

Continue with [Deposit](https://tempo.com/developers/docs/earn/integrate), then [show balances and earnings](https://tempo.com/developers/docs/earn/balances). If you operate a yield strategy, see [Connect a strategy](https://tempo.com/developers/docs/earn/providers).
