Close Position

​

Overview

The Close Position endpoint allows you to close an existing position (partially or fully) or modify its take profit and stop loss orders. You can specify the amount to close and set price limits for the closing transaction.

​

Request Body

​

Response Fields

​

Example Usage

​

Full Position Close

​

Partial Position Close

​

Modify Take Profit/Stop Loss

​

Example Response

{
  "calldata": "0x4d59524546455252414c434f4445000000000000000000000000000000000000",
  "vaultAddress": "0xe3ca135782e4a17aFb31a63ee3b15351C891A1A2",
  "requiredGasFee": "0.0012"
}

​

Common Use Cases

1. Full Position Close

   • Only specify positionId and optionally allowedPrice
   • Closes entire position

2. Partial Position Close

   • Specify positionId, sizeDelta, and optionally allowedPrice
   • Closes specified amount of position

3. Modify Take Profit/Stop Loss

   • Specify positionId, takeProfit/stopLoss, and corresponding close percentages
   • Updates or adds take profit/stop loss orders without closing position

​

Notes

• allowedPrice helps prevent slippage - transaction will fail if price moves beyond this limit
• Close percentages are in basis points (10000 = 100%)
• Take profit and stop loss can be modified without closing the position
• sizeDelta must be less than or equal to current position size