> For the complete documentation index, see [llms.txt](https://doc.monetrix.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.monetrix.xyz/guide/getting-started-2/redeem.md).

# Redeem mxBTC

Redeeming mxBTC converts it back to UBTC at a **1:1 ratio**. Redemption is a two-step process: **request** now, **claim** after a cooldown. An **Instant** option with a small fee is also available when the protocol's buffer has liquidity.

{% hint style="info" %}
**Current cooldown: 2 days.** This value is read live from `BtcConfig.redeemCooldown()` and can be adjusted by governance. The active value is always shown in the UI and is authoritative.
{% endhint %}

{% hint style="info" %}
If your mxBTC came from unstaking smxBTC, the yield you earned was already realized at the claim step. Redeem is just converting mxBTC back to UBTC.
{% endhint %}

## Standard redeem

### 1. Request a redemption

With the **mxBTC** tab selected at the top, choose **Redeem** and enter the mxBTC amount you want to redeem. Make sure **Standard** is selected in the dropdown next to the button. The app displays:

* Your mxBTC balance.
* The UBTC you will receive (equal to the mxBTC amount).
* A tip showing the **cooldown length** read live from the protocol config.

Click **Approve & Redeem mxBTC**. The first wallet prompt approves the vault to take your mxBTC, the second calls `BtcVault.requestRedeem(amount)`.

After this, the cooldown starts. A new card appears under **Pending Redeem** with status `Cooldown` and a countdown timer.

{% hint style="warning" %}
Your mxBTC is transferred to the vault at request time and held as a claim on UBTC. The 1:1 rate is locked in when you request; the mxBTC in a pending request does not earn yield (it was never staked).
{% endhint %}

### 2. Wait for the cooldown

The **Waiting** row counts down. The cooldown length (currently **2 days**) comes from `BtcConfig.redeemCooldown()` and is displayed live in the UI. Governance can adjust this parameter; future changes will be announced before they take effect.

### 3. Claim your UBTC

When the cooldown ends, the badge flips from `Cooldown` to `Ready` (green) and a **Claim UBTC** button appears.

Click **Claim UBTC** and confirm. The transaction calls `BtcVault.claimRedeem(requestId)`, burns the mxBTC, and sends UBTC to your wallet at the 1:1 rate.

### "Waiting for liquidity"

Occasionally a request's cooldown has ended but the badge shows **Waiting for liquidity** instead of Ready. This means the redemption escrow does not yet hold enough UBTC to pay your request. The protocol replenishes the escrow as it unwinds positions; no action is needed on your side. Check back later and the badge will flip to Ready.

## Instant redeem

Select **Instant** from the dropdown. The app quotes the UBTC you will receive and the 0.3% fee. If instant exit is available, click **Approve & Redeem mxBTC**: the first prompt approves mxBTC to the instant-redeem contract, the second calls `instantExit(amount)`. You receive UBTC in the same transaction; no cooldown.

Instant redeem is served from a protocol-funded buffer, so it is not always available. Instead of a quote, the app shows the reason when:

* Instant exit is paused.
* Your amount is below the instant minimum (currently **0.002 mxBTC**).
* The buffer is empty, or doesn't hold enough UBTC for your amount. Try a smaller amount or use Standard.
* The instant queue is full.

## Multiple requests

You can have multiple redeem requests outstanding at the same time. Each shows as its own card with an independent cooldown. You can claim them in any order as each one becomes ready.

## Troubleshooting

* **"Insufficient balance."**: check your mxBTC balance.
* **Waiting shows `-` (dash)**: the cooldown has ended; the Claim UBTC button should be active, unless the card says Waiting for liquidity.
* **Claim fails**: usually means the request isn't ready yet, or the escrow is still short of UBTC. Refresh the page and check the badge.
* **Button reads "Switch to HyperEVM"**: your wallet is on another network. Click it to switch to HyperEVM and retry.
