Set Position Mode

/sapi/v1/position/mode

Request type: POST

Signature verification: Yes

Interface permission: Trade

Rate Limit: Generally, the private interface rate limit of API key is at most 144 times every 3 seconds for each UID (Trade Interface: at most 72 times every 3 seconds. Read Interface: at most 72 times every 3 seconds) (this rate limit is shared by all the altcoins contracts delivered by different date).

Interface description: Switch the current position mode.

Request Address

Environment	Address
Online (preferred by aws customers)	https://api.sunx.io
Online	https://api.sunx.io

Request Parameter

Parameter	Data Type	Required	Description	Value Range	Default Value
position_mode	string	true	Position mode	single_side: One-way mode; dual_side: Hedge mode

Response Parameter

Parameter	Data Type	Required	Description	Value Range
position_mode	string	true	Position mode	single_side: One-way mode; dual_side: Hedge mode

Request Example

POST https://api.sunx.io/sapi/v1/position/risk/limit?margin_mode=cross&SignatureVersion=2&SignatureVersion=2&AccessKeyId=<your key>&Signature=<your signature>&SignatureMethod=HmacSHA256&Timestamp=2025-09-16T07%3A16%3A15

{
    "position_mode": "dual_side"
}

Response Example

{
  "code": 200,
  "message": "Success",
  "data": {
    "position_mode": "dual_side"
  },
  "ts": 1740463132267
}