> For the complete documentation index, see [llms.txt](https://docs.javsphere.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.javsphere.com/engineering/smart-contracts/leveragex/javtradinginteractions.md).

# JavTradingInteractions

## General Description

The **JavTradingInteractions** contract used for manage and interact with various types of trading orders, including limit, stop, and market orders, for a trading platform. It enables users to open, close, update, and manage the terms of their trades, including slippage, position size, leverage, and take-profit/stop-loss (TP/SL) parameters. Additionally, it supports the initiation and updating of trigger orders, and allows for the cancellation of open orders.  This system provides a wide range of functionalities to give users full control over their trading positions and strategies.

## Core Functionalities

### **`openTrade`**

* Opens a new trade, limit order, or stop order with specified parameters.
* **Parameters**:
  * `_trade`: The trade data (structure containing details about the trade).
  * `_maxSlippageP`: Maximum allowed slippage in percentage (1e3 precision).
  * `_referrer`: Address of the referrer (can only be set once per trader).
  * `_priceUpdate`: Array containing price update data.
* **Access Control**: Public.

### **`updateTermsAndConditionsAddress`**

* Updates the address for the terms and conditions.
* **Parameters**:
  * `_termsAndConditionsAddress`: New address for the terms and conditions.
* **Access Control**: Public.

### **`updateMaxClosingSlippageP`**

* Updates the maximum slippage allowed for closing a trade.
* **Parameters**:
  * `_index`: Index of the trade to be updated.
  * `_maxSlippageP`: New maximum closing slippage percentage (1e3 precision).
* **Access Control**: Public.

### **`closeTradeMarket`**

* Closes an open trade using a market order.
* **Parameters**:
  * `_index`: Index of the trade to be closed.
  * `_priceUpdate`: Array containing price update data.
* **Access Control**: Public.

### **`updateOpenOrder`**

* Updates an existing limit or stop order with new parameters.
* **Parameters**:
  * `_index`: Index of the existing order.
  * `_triggerPrice`: New trigger price for the order (1e10 precision).
  * `_tp`: New take-profit price (1e10 precision).
  * `_sl`: New stop-loss price (1e10 precision).
  * `_maxSlippageP`: New maximum slippage percentage (1e3 precision).
* **Access Control**: Public.

### **`cancelOpenOrder`**

* Cancels an open limit or stop order.
* **Parameters**:
  * `_index`: Index of the order to be canceled.
* **Access Control**: Public.

### **`updateTp`**

* Updates the take-profit (TP) value of an open trade.
* **Parameters**:
  * `_index`: Index of the open trade.
  * `_newTp`: New TP value (1e10 precision).
* **Access Control**: Public.

### **`updateSl`**

* Updates the stop-loss (SL) value of an open trade.
* **Parameters**:
  * `_index`: Index of the open trade.
  * `_newSl`: New SL value (1e10 precision).
* **Access Control**: Public.

### **`updateLeverage`**

* Updates the leverage for a trade.
* **Parameters**:
  * `_index`: Index of the trade.
  * `_newLeverage`: New leverage value (1e3 precision).
  * `_priceUpdate`: Array containing price update data.
* **Access Control**: Public.

### **`increasePositionSize`**

* Increases the position size of an open trade by adding collateral and adjusting leverage.
* **Parameters**:
  * `_index`: Index of the trade.
  * `_collateralDelta`: Amount of collateral to add (collateral precision).
  * `_leverageDelta`: Amount of leverage to increase by (1e3 precision).
  * `_expectedPrice`: Expected price for execution (1e10 precision).
  * `_maxSlippageP`: Maximum slippage percentage allowed (1e3 precision).
  * `_priceUpdate`: Array containing price update data.
* **Access Control**: Public.

### **`decreasePositionSize`**

* Decreases the position size of an open trade by removing collateral and adjusting leverage.
* **Parameters**:
  * `_index`: Index of the trade.
  * `_collateralDelta`: Amount of collateral to remove (collateral precision).
  * `_leverageDelta`: Amount of leverage to decrease by (1e3 precision).
  * `_priceUpdate`: Array containing price update data.
* **Access Control**: Public.

### **`triggerOrder`**

* Initiates a trigger order based on a packed data structure (order type, trader, index) for TP, SL, liquidation, limit, or stop orders.
* **Parameters**:
  * `_packed`: Packed data for the trigger order (encodes order type, trader address, index).
  * `_priceUpdate`: Array containing price update data.
* **Access Control**: Public.