Market Close Position

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

HTTP Request

POST `/v1/trade/market-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
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	Position closed successfully!

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

INFO

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

Request Example

POST /v1/trade/market-close-position HTTP/1.1
Host: api.okxai.net
X-OKXAI-SIGN: XXXXX
X-OKXAI-API-KEY: XXXXX
Content-Type: application/json
 
{
  "id": 456, 
  "size": 0.5, 
  "coin": "BTCUSDT", 
}

Response Example

{
  "statusCode": 200,
  "result": "Success",
  "message": "Position closed successfully!",
}