> ## Documentation Index
> Fetch the complete documentation index at: https://docs.multiliquid.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Multiliquid Treasury

> Onboard a wallet, deposit USDC for TSY, and redeem TSY for USDC through the API.

Multiliquid Treasury pays T-Bill-linked yield on stablecoins. You deposit USDC and receive \$TSY. Later you redeem \$TSY for USDC, with the yield it has earned. [Multiliquid Treasury](https://docs.multiliquid.xyz/applications/liquid-treasury.md) describes the product, and this section covers its API.

Both sides run on Ethereum mainnet, through the Treasury capital provider. A deposit is a swap. A redemption is a swap, or, for a larger amount, one signed authorization.

> [card] [Onboard](https://docs.multiliquid.xyz/api-reference/treasury/onboarding.md)
>
> Complete KYC/KYB, and have Multiliquid add your wallets to the \$TSY allowlist.

> [card] [Deposit](https://docs.multiliquid.xyz/api-reference/treasury/deposit.md)
>
> Swap USDC for \$TSY. The swap mints \$TSY and records Treasury credits for the depositor.

> [card] [Redeem](https://docs.multiliquid.xyz/api-reference/treasury/redeem.md)
>
> Redeem \$TSY for USDC instantly, or at size with one signed authorization.

## How it works

**1. Onboard once**

Your organization completes KYC/KYB and signs the note purchase agreement. Multiliquid then adds your wallets to the \$TSY allowlist. Only an allowlisted wallet can receive newly minted \$TSY.

**2. Deposit**

The depositor's wallet swaps USDC for \$TSY with the [Swap API](https://docs.multiliquid.xyz/api-reference/swap/overview.md). The swap mints \$TSY 1:1 and records the same amount of Treasury credits for the depositor. The credits earn the yield.

**3. Redeem**

The depositor's wallet swaps \$TSY back for USDC. The swap burns the \$TSY, spends the same amount of credits, and pays the USDC with the yield the credits earned. For more than Treasury custody can pay out now, the depositor signs a [redemption at size](https://docs.multiliquid.xyz/api-reference/treasury/redeem-at-size.md) instead.

## Treasury credits

\$TSY is an ERC-20 token, worth 1 USD at par, with 18 decimals. Its balance stays constant: the yield accrues to the depositor's **Treasury credits**, not to the token.

* **Credits stay with the depositor.** A deposit records credits for the wallet that signs it, the `user`. Transferring \$TSY does not move them.
* **A redemption needs both.** The depositor's wallet must hold the \$TSY and enough credits to cover it. Another holder of \$TSY cannot redeem it.
* **Yield starts the next day.** A USDC deposit starts earning 24 hours after it lands. A deposit redeemed before then earns nothing. [Treasury contracts](https://docs.multiliquid.xyz/evm/contracts/treasury.md#credits-and-yield) gives the exact rules.

## What you need

* **An onboarded organization**, with the depositor's wallet on the \$TSY allowlist. [Onboarding](https://docs.multiliquid.xyz/api-reference/treasury/onboarding.md) explains the process.
* **USDC and ETH on Ethereum mainnet.** The depositor's wallet pays network fees in ETH.
* **No API key.** The depositor's wallet signs every deposit and redemption. A key records submissions and redemptions under your organization, so you can list them later, as [Authentication](https://docs.multiliquid.xyz/api-reference/authentication.md#organization-attribution) explains.

To test the flow first, [Testnets](https://docs.multiliquid.xyz/api-reference/guides/testnets.md) explains how to get test \$TSY on `evm-sepolia`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.