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

# Quick Reverse

> A one-click combination action that market-closes your current position and opens an equal-sized position in the opposite direction.

Quick Reverse is a convenience action for traders who want to flip direction immediately. Instead of clicking "close" and then "open" on the opposite side, you click once and Intention submits both market orders for you.

## What it does

Quick Reverse is a composite of two market orders:

1. **Close.** Market-close the selected position for its full size.
2. **Open.** Market-open a new position of equal size in the opposite direction.

Both legs are regular market orders that go through the normal [market-to-limit conversion](/trading/market-to-limit). Slippage, price bands, and bankruptcy checks apply exactly as they would for orders placed manually.

<Note>
  Quick Reverse does **not** guarantee both legs succeed. Intention does not make the composite atomic, because on a fast-moving market the open leg can easily fail due to insufficient margin for the reversed position. The close can succeed while the open fails — in which case you end up flat rather than reversed.
</Note>

## Position mode behavior

| Mode         | Behavior                                                                                                                                          |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| One-way mode | The contract holds exactly one net position. Reverse flips that net position's sign. Long 0.1 BTC → Reverse → short 0.1 BTC.                      |
| Hedge mode   | The contract can hold independent long and short positions. Reverse targets a specific direction and flips that one, leaving the other untouched. |

### Hedge mode example

Starting state: 0.2 BTC long, 0.1 BTC short. You click Reverse on the long.

* Close leg: market-sell 0.2 BTC (closes the long)
* Open leg: market-sell 0.2 BTC (opens a new 0.2 BTC short)

Net effect: the long is gone, and the existing short grows from 0.1 to 0.3 BTC.

## Where you trigger it

The primary entry point is a "Reverse" button on each row in the positions panel. Clicking it:

<Steps>
  <Step title="Confirm (optional)">
    If you have "order confirmation" enabled in your trading settings, a dialog shows the intended close and open legs. You can cancel here.
  </Step>

  <Step title="Submit">
    With confirmations off, the request goes directly to the chain.
  </Step>

  <Step title="Handle result">
    You receive fill notifications for each leg. Partial fills are reported as-is; there is no automatic retry.
  </Step>
</Steps>

## Edge cases

* **Order size exceeds single-order max.** If the resulting combined order is larger than the platform's single-order limit, the client truncates to the max and displays a notice.
* **Insufficient margin on the open.** The open leg reaches the matching engine and is rejected. The close has already succeeded — you are flat, not reversed.
* **Partial fill on the close.** You end up half in and half out on the old side. Intention does not automatically retry; you can click Reverse again on the remaining position if you want.
* **Partial fill on the open.** Normal market-order semantics — unfilled remainder is cancelled. You end up reversed but with a smaller position than intended.
* **Rapid re-clicks.** The front end debounces successive clicks so accidental double-clicks don't reverse-and-reverse.
* **Leftover reduce-only orders.** All reduce-only orders on the original direction (including triggered conditional orders) are automatically cleaned up by the reduce-only scaling logic described on the [Reduce-only](/trading/reduce-only) page.

## When to use it

Quick Reverse is useful when you realize you are on the wrong side of a trend and want to flip with a single action rather than managing close and open separately. It is not appropriate for large institutional reversals where you would prefer to avoid a single-block market impact — in that case, use [TWAP](/trading/twap) with a fresh opposite-side plan.