Skip to main content

Close Position

Close Position

Close positions for a given product. If posIds is omitted, closes all positions under the product. Consolidates the batch-close-position and close-position-by-ids endpoints.

Request URL

POST /deepcoin/v2/trade/close-position

Request Parameters

Field NameRequiredTypeDescription
instIdtruestringProduct ID
posIdsfalse[]stringPosition ID list. If omitted, closes all positions under the product

Request Example

// Close all positions for the product
{
"instId": "ETH-USDT-SWAP"
}

// Close by position IDs
{
"instId": "ETH-USDT-SWAP",
"posIds": ["1001063717138767", "1001063717138768"]
}

Response Parameters

Field NameTypeDescription
dataarrayClose result list

data[] item fields:

Field NameTypeDescription
instIdstringProduct ID
posIdstringPosition ID
posSidestringPosition side
memberIdstringMember ID
accountIdstringAccount ID
tradeUnitIdstringTrade unit ID
sCodestringResult code, 0 means success
sMsgstringResult message

Response Example

{
"data": []
}