Skip to main content

Increase Position

Increase Position

Add to an existing split position. This endpoint is only applicable to contract split positions.

Callers only need to provide the product ID, position ID, order type, and increase quantity. The system will automatically identify the position direction, margin mode, and account information based on position information.

Request URL

POST /deepcoin/trade/increase-position

Request Parameters

Field NameRequiredTypeDescription
instIdtruestringProduct ID, e.g. BTC-USDT-SWAP
posIdtruestringPosition ID to increase. This value comes from the posId returned by Get Positions API
ordTypetruestringOrder type
Market: market
Limit: limit
Post only: post_only
Immediate or cancel: ioc
sztruestringIncrease quantity, same unit as the place order API
pxfalsestringOrder price. Required for limit and post_only order types

Request Example

{
"instId": "BTC-USDT-SWAP",
"posId": "1000587858872759",
"ordType": "limit",
"sz": "5",
"px": "65000"
}

Market increase:

{
"instId": "BTC-USDT-SWAP",
"posId": "1000587858872759",
"ordType": "market",
"sz": "5"
}

Response Parameters

Field NameTypeDescription
ordIdstringOrder ID
posIdstringTarget position ID for this increase

Response Example

{
"code": "0",
"msg": "",
"data": {
"ordId": "1000587866646229",
"posId": "1000587858872759"
}
}

Notes

Description

  • Add to an existing split position
  • Supports market, limit, post-only, and IOC order types
  • The increase direction is automatically determined by the target position; callers do not need to pass side or posSide
  • Position ID must come from the posId returned by Get Positions API

Precautions

  • Only supports split positions with mrgPosition=split
  • posId must belong to the account associated with the current API Key
  • The instId in the request must match the product ID of the target position
  • sz must be greater than 0 and conform to the product's minimum order quantity and quantity precision
  • limit and post_only order types must include px
  • The API will return an error if the position does not exist, does not belong to the current user, the product does not match, or the position status does not allow increase