Close All of a Symbol at Market Price

/sapi/v1/trade/position

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: Sell designated positions at market price.

Request Address

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

Request Parameter

Parameter	Data Type	Required	Description	Value Range	Default Value
contract_code	String	true	Symbol
margin_mode	String	true	Margin mode	cross: Cross margin
position_side	String	true	Position side	The side of your position. Under the buy/sell mode, "both" is default. Under the long/short mode, "long" refers to going long; "short" refers to going short.
client_order_id	String	false	Order ID you entered

Response Parameter

Parameter	Data Type	Required	Description	Value Range
client_order_id	String	false	Your order ID

Request Example

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

{
    "contract_code": "BTC-USDT",
    "margin_mode": "cross",
    "position_side": "long",
    "client_order_id": "1330969352647610368"
}

Response Example

{
  "code": 200,
  "data": {
    "client_order_id": "1330969352647610368",
    "order_id": 1339200243479453700
  },
  "message": "Success",
  "ts": 1739331819194
}