> For the complete documentation index, see [llms.txt](https://tradewithonyx.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tradewithonyx.gitbook.io/docs/trading/liquidations.md).

# Liquidations

A liquidation occurs when a trader’s account equity drops below the required maintenance margin, which is set at 50% of the initial margin at maximum leverage.

When this threshold is breached:

1. The system attempts to close positions by placing market orders for the full position size.
2. If sufficient capital is recovered and margin requirements are restored, any leftover collateral stays with the trader.
3. If liquidation through the market fails and account equity falls below two-thirds of the maintenance margin, a backstop liquidation occurs through the Liquidator Vault.

* Cross Margin: In backstop events, all cross margin and positions are transferred to the liquidator. If no isolated positions exist, the trader’s account equity becomes zero.
* Isolated Margin: Only the isolated position and its margin are transferred. Other assets and cross positions remain unaffected.

In backstop scenarios, maintenance margin is not returned to the trader. This buffer ensures liquidations remain profitable for the Liquidator Vault.

To avoid backstop liquidation, traders are advised to use stop loss orders or manually exit before their mark price hits the liquidation threshold.

***

### **Mark Price & Liquidation**

As Onyx is fully integrated with Hyperliquid's backend system, it inherits and adheres to its liquidation framework. \
\
Hyperliquid uses a mark price — an aggregated value based on both external CEX data and internal book state — making it more reliable than relying solely on a volatile order book price. This improves fairness and helps prevent unnecessary liquidations during market spikes.

To learn more please look at Hyperliquid liquidation Documentation [<mark style="color:green;">here</mark>](https://hyperliquid.gitbook.io/hyperliquid-docs/trading/liquidations)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://tradewithonyx.gitbook.io/docs/trading/liquidations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
