> ## 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.

# Redeem

> Redeem TSY for USDC instantly, or at size with one signed authorization.

There are two ways to redeem \$TSY for USDC, depending on the amount. Both need the \$TSY and the Treasury credits that a [deposit](https://docs.multiliquid.xyz/api-reference/treasury/deposit.md) recorded, in the depositor's wallet: [Treasury credits](https://docs.multiliquid.xyz/api-reference/treasury/overview.md#treasury-credits) explains them.

> [card] [Instant redemption](https://docs.multiliquid.xyz/api-reference/swap/swap-instantly.md)
>
> Swap \$TSY for USDC with the Swap API. It settles in one transaction, up to the USDC that Treasury custody holds now.

> [card] [Redemption at size](https://docs.multiliquid.xyz/api-reference/treasury/redeem-at-size.md)
>
> Sign once for a larger amount. Multiliquid sources the USDC it needs and settles the redemption in one transaction.

## Choose instant or at size

Quote the instant swap first, with the depositor's wallet as `user`, because the depositor's credits set the price. Without `user`, the quote is `indicative`, priced as a wallet with no accrued yield would be, not at the depositor's own price.

```bash theme={null}
curl "https://api.multiliquid.xyz/v1/swap/quote?network=evm-mainnet&inputToken=0x6f4e688a151dfa05b20cb3151e6066d9fd5d7b32&outputToken=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48&amountOut=1000&user=$DEPOSITOR"
```

A `200` means the depositor can redeem instantly: `amountIn` is the \$TSY the swap spends, such as `984.589682567186264031` \$TSY for 1,000 USDC. \$TSY has 18 decimals, and an amount in a response is exact, so it can show all 18. Build and submit it as [Swap instantly](https://docs.multiliquid.xyz/api-reference/swap/swap-instantly.md) describes.

Only the Treasury capital provider fills \$TSY for USDC. Above what Treasury custody can pay out now, the quote answers `NO_QUOTE`, and `details.providers` says how much custody holds. Redeem at size instead:

```json theme={null}
{
  "error": "no capital provider can quote this swap: 0x780a0ed07e618523cabd294ee648537f4d185a074f97ecd50188d7f394e1e927: the capital provider's stablecoin custody 0x13d923c6e01de19cf2e134da3300f09ac42221f2 holds 8524.999703 of the 20000 USDC the swap pays from it (ERC20InsufficientBalance)",
  "status": 400,
  "code": "NO_QUOTE",
  "details": {
    "providers": [
      {
        "capitalProvider": {
          "id": "0x780a0ed07e618523cabd294ee648537f4d185a074f97ecd50188d7f394e1e927",
          "name": "Uniform Labs",
          "address": "0x1f2c73a2578b3d49843c9a40f473ef6768f6d6a3"
        },
        "error": {
          "name": "ERC20InsufficientBalance",
          "message": "the capital provider's stablecoin custody 0x13d923c6e01de19cf2e134da3300f09ac42221f2 holds 8524.999703 of the 20000 USDC the swap pays from it"
        }
      }
    ]
  },
  "requestId": "req_01a1d68b7f527f009f07a211bae66d03"
}
```

When `details.providers` names `InsufficientCredits` instead, the depositor's credits do not cover the \$TSY. A redemption at size needs the same credits: its preparation reports the shortfall in `checks.credits`, and intake rejects it. `CreditsUnavailable` means the credits could not be read now, so quote again later.

## How a redemption at size works

**1. Prepare**

Get the redemption with every value filled in, the typed data to sign, the \$TSY approval it needs, and checks that show whether it would be accepted now.

**2. Approve and sign**

The depositor signs the approval, when there is one, and you submit it. Then the depositor signs the typed data.

**3. Submit and track**

Submit the redemption with its signature, then follow it until the USDC is paid.

## What you need

* **No API key.** The depositor's signature authorizes the redemption. A key records the redemption under your organization, so you can list your organization's redemptions later, as [Authentication](https://docs.multiliquid.xyz/api-reference/authentication.md#organization-attribution) explains.
* **\$TSY on Ethereum mainnet**, the only network redemptions run on, and **Treasury credits** to cover it, for an instant redemption and for one at size alike. Both come from a [deposit](https://docs.multiliquid.xyz/api-reference/treasury/deposit.md).
* **A signer for EIP-712 typed data**: a wallet, a custody platform, or a contract wallet.

A redemption at size settles after Multiliquid's checks and its transaction's finality, so it takes longer than an instant redemption. There is no guaranteed completion time.

## Next steps

> [card] [Redeem at size](https://docs.multiliquid.xyz/api-reference/treasury/redeem-at-size.md)
>
> The full flow, from preparation to the USDC payout.

> [card] [Prepare and sign](https://docs.multiliquid.xyz/api-reference/treasury/prepare-and-sign.md)
>
> The prepared redemption, its checks, and the typed data.

> [card] [Lifecycle](https://docs.multiliquid.xyz/api-reference/treasury/lifecycle.md)
>
> Intake checks, states, failures, and resubmission.


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