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

# Positions

Positions represent your active exposure in markets on the Nexus Exchange. Each position will maintain a live state within the NexusCore risk engine, tracking your entry price, size, collateral usage, funding, fees, and real-time profit and loss.

Positions will be updated every NexusCore block, ensuring near-instant feedback on risk, margin, and liquidation thresholds.

### **Open Positions**

Your open positions panel will display continuously updated metrics derived from NexusCore's real-time risk engine:

* **Unrealized PnL** — shown in both USD value and percentage
* **Position Size** — total notional exposure (long or short)
* **Average Entry Price** — volume-weighted entry across fills
* **Margin Usage** — collateral allocated to maintain the position
* **Liquidation Price** — the estimated price at which the risk engine will liquidate your position
* **Funding Payments** — funding paid or received since opening

All calculations will follow the deterministic margin and funding rules enforced inside NexusCore’s financial state machine.

### **Modifying Positions**

Active positions will be managed through various methods to adjust your exposure or exit trades. Updates will be applied atomically via NexusCore's matching engine.

* **Adjusting Position Size**
  * You can increase or decrease your position size via market or limit orders using the standard trading modal.
  * Orders in the opposite direction exceeding your current position size will automatically "flip" your positions.
    * For example, if you have 1 BTC active long and place a market sell for 2 BTC, you'll end up with 1 BTC active short.
* **Closing Positions**
  * Exit a position partially or in full from the Positions tab.
  * Closing executes a market or limit order on the opposite side and immediately realizes PnL after the fill.
* **Position History**
  * Track and review trading activity with transparent historical data through the Position History tab.

<br>


---

# 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://docs.nexus.xyz/exchange/trading/perpetuals/positions.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.