Limit Close Position

This endpoint supports the closing of orders in USDT futures via Limit sell.

HTTP Request

POST `/v1/trade/close-position`

NOTE

Don't include trailing slash / at the end of the endpoint. Doing so can result in a “not found” error.

Request Parameters

Parameter	Required	Type	Comments
exitPrice	true	number	exit price for the position
id	true	number	id of the position
size	true	number	size of the position
coin	false	string	Values: `BTCUSDT`, `ETHUSDT`, `SOLUSDT`, `XRPUSDT` `1000PEPEUSDT`, `WLDUSDT`, `DOGEUSDT`, `STPTUSDT`, `SUIUSDT`, `ADAUSDT`, `ARBUSDT`, `XLMUSDT`, `HIVEUSDT`, `ONDOUSDT`

Response Parameters

Parameter	Type	Comments
statusCode	number	`200`
result	string	`Success`
message	string	Response message

Parameter	Type	Comments
statusCode	number	`404`
result	string	`Not Found`
message	string	Position not found!

INFO

The ack of limit close position indicates that the request is successfully accepted. Please use websocket order stream to confirm the status.

Request Example

POST /v1/trade/close-position HTTP/1.1
Host: api.heatmex.com
X-HEATMEX-SIGN: XXXXX
X-HEATMEX-API-KEY: XXXXX
Content-Type: application/json
 
{
  "exitPrice": 50000.00, 
  "id": 456, 
  "size": 0.5, 
  "coin": "BTCUSDT", 
}

Response Example

{
  "statusCode": 200,
  "result": "Success",
  "message": "Order Placed successfully!",
}