<!-- tempo-docs-context -->
> Source: [/docs/earn](https://tempo.xyz/developers/docs/earn.md)
> Section: [Earn](https://tempo.xyz/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.xyz/developers/llms.txt) · [Docs skill](https://tempo.xyz/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.xyz/developers/llms.txt) and Markdown pages directly.

<span id="offer-an-earning-balance" />

# Tempo Earn

Add an earning balance to your app. Customers deposit stablecoins into a vault, see their earnings, and withdraw funds.

[Try a testnet deposit →](https://tempo.xyz/developers/docs/earn/integrate#try-a-deposit)

Illustrative Earn position: 1,200 vault shares valued at 1,250 OUSD. A historical chart illustrates position tracking, not a forecast of returns.

:::warning
Earn is in beta. [Contact Tempo](https://tempo.xyz/contact) to discuss access and the right integration for your application.
:::

<span id="how-earning-balances-work" />

## How Earn works

A vault accepts stablecoin deposits and issues shares representing an account's position. The value of those shares changes with the underlying strategy's returns, losses, and fees. Your app shows the position's current asset value as an earning balance.

<span id="liquidity-and-withdrawals" />

<span id="track-deposits-and-withdrawals" />

Choose a vault by its accepted asset, eligibility, strategy, and withdrawal behavior. Position value and the amount immediately available to withdraw can differ. [How Earn works](https://tempo.xyz/developers/docs/earn/how-it-works) explains the vault and share model.

<span id="choose-the-vault-integration" />

<span id="choose-a-yield-source" />

<span id="build-the-deposit-flow" />

<span id="read-vaults-and-positions" />

<span id="read-positions-and-earnings" />

## Start building

Use an existing Tempo account and signer. Viem’s Earn actions submit deposits and supported withdrawals; the Earn API reads vaults, positions, and earnings.

* [Vaults](https://tempo.xyz/developers/docs/earn/vaults) — Choose an asset, strategy, and withdrawal path.
* [Deposit](https://tempo.xyz/developers/docs/earn/integrate) — Try a testnet deposit with a vault and amount already selected.
* [Balances and earnings](https://tempo.xyz/developers/docs/earn/balances) — Show position value and returns in your application.
* [Withdraw](https://tempo.xyz/developers/docs/earn/withdraw) — Return funds to the account and track delivery.

<span id="connect-earning-balances-to-payments" />

<span id="use-earning-balances-for-payments" />

To use an earning balance for a payment, withdraw the required stablecoins and confirm their arrival before [sending the payment](https://tempo.xyz/developers/docs/guide/payments/send-a-payment).

<span id="yield-providers" />

<span id="for-yield-providers" />

<span id="connect-a-yield-source" />

If you operate a yield strategy, see [Connect a strategy](https://tempo.xyz/developers/docs/earn/providers). For a Zone integration, check the vault's support for [private Earn activity](https://tempo.xyz/developers/docs/earn/integrate#track-private-earn-activity).
