跳到主要内容

分仓加仓

分仓加仓

对指定分仓仓位追加持仓。该接口仅适用于合约分仓仓位。

调用方只需要传入产品 ID、仓位 ID、订单类型和加仓数量。系统会根据仓位信息自动识别仓位方向、保证金模式和账户信息。

请求地址

POST /deepcoin/trade/increase-position

请求参数

字段名是否必填类型字段描述
instIdstring产品 ID,例如 BTC-USDT-SWAP
posIdstring要加仓的仓位 ID。该值来自 获取持仓列表 接口返回的 posId
ordTypestring订单类型
市价单: market
限价单: limit
只做 maker 单: post_only
立即成交或撤销单: ioc
szstring加仓数量,单位与下单接口一致
pxstring委托价格。limitpost_only 类型订单必填

请求示例

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

市价加仓:

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

响应参数

字段名类型字段描述
ordIdstring订单 ID
posIdstring本次加仓的目标仓位 ID

响应示例

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

说明

功能描述

  • 对指定分仓仓位追加持仓
  • 支持市价、限价、只做 maker、IOC 等订单类型
  • 加仓方向由目标仓位自动决定,调用方不需要传 sideposSide
  • 仓位 ID 必须来自 获取持仓列表 接口返回的 posId

注意事项

  • 仅支持 mrgPosition=split 的分仓仓位
  • posId 必须属于当前 API Key 对应账户
  • 请求中的 instId 必须与目标仓位的产品 ID 一致
  • sz 必须大于 0,并符合产品最小下单数量和数量精度
  • limitpost_only 类型订单必须传 px
  • 如果仓位不存在、仓位不属于当前用户、产品不一致或仓位状态不允许加仓,接口会返回失败