跳到主要内容

下单

下单​

只有当您的账户有足够的资金才能下单

限频：每秒 1 次

请求地址​

POST /deepcoin/trade/order

请求参数​

字段名是否必填类型字段描述
instId是string产品 ID
tdMode是string交易模式
逐仓: isolated
全仓: cross
ccy否string保证金币种，仅适用于单币种保证金模式下的全仓杠杆订单
clOrdId否string客户自定义订单 ID 字母(区分大小写) 与数字的组合 可以是纯字母 纯数字且长度要在 1-32 位之间 暂不支持该参数传参
tag否string订单标签 字母(区分大小写) 与数字的组合 可以是纯字母 纯数字 且长度在 1-16 位之间 暂不支持该参数传参
side是string订单方向
买: buy
卖: sell
posSide否string持仓方向
产品类型为 SWAP 时必填
多: long
空: short
mrgPositio n否string合并合仓
产品类型为 SWAP 时必填
合仓: merge
分仓: split
closePosId否string等待平仓的仓位 ID 分仓模式必填
ordType是string订单类型
市价单: market
限价单: limit
只做 maker 单: post_only
立即成交或撤销单: ioc
sz是string委托数量,通过 获取交易产品基础信息 接口获取 最小下单数量(minSz)
px否string委托价格,通过 获取交易产品基础信息 接口获取 下单价格精度(tickSz)
仅适用于 limit,post_only 类型的订单
reduceOnly否boolean是否只减仓,true 或 false
默认 false 仅适用于币币杠杆 以及买卖模式下的交割/永续 仅适用于单币种保证金模式和跨币种保证金模式
tgtCcy否string市价单委托数量的类型，仅适用于币币订单
交易货币: base_ccy
计价货币: quote_ccy
tpTriggerPx否string止盈触发价 仅适用于止盈止损单
slTriggerPx否string止损触发价 仅适用于止盈止损单

请求示例​

{
  "instId": "BTC-USDT",
  "tdMode": "cash",
  "ccy": "USDT",
  "clOrdId": "string",
  "tag": "string",
  "side": "buy",
  "posSide": "long",
  "mrgPosition": "merge",
  "closePosId": "1001063717138767",
  "ordType": "limit",
  "sz": "0.0004",
  "px": "0.01",
  "reduceOnly": "boolean",
  "tgtCcy": "string",
  "tpTriggerPx": "10000.1",
  "slTriggerPx": "9000.1"
}



// 市价做多，买入开多
{
    "instId": "BTC-USDT-SWAP",
    "tdMode": "cross",
    "side": "buy",
    "ordType": "market",
    "sz": "5",
    "posSide": "long",
    "mrgPosition": "merge",
}

// 市价卖出平多
{
    "instId": "BTC-USDT-SWAP",
    "tdMode": "cross",
    "side": "sell",
    "ordType": "market",
    "sz": "5",
    "posSide": "long",
    "mrgPosition": "merge",
}

// 市价做空,卖出开空
{
    "instId": "BTC-USDT-SWAP",
    "tdMode": "cross",
    "side": "sell",
    "ordType": "market",
    "sz": "1",
    "posSide": "short",
    "mrgPosition": "merge",
}

// 市价买入平空
{
    "instId": "BTC-USDT-SWAP",
    "tdMode": "cross",
    "side": "buy",
    "ordType": "market",
    "sz": "1",
    "posSide": "short",
    "mrgPosition": "merge",
}

// 限价买入开多
{
    "instId": "BTC-USDT-SWAP",
    "tdMode": "cross",
    "side": "buy",
    "ordType": "limit",
    "sz": "1",
    "px": "23000",
    "posSide": "long",
    "mrgPosition": "merge",
}

// 限价卖出做空
{
    "instId": "BTC-USDT-SWAP",
    "tdMode": "cross",
    "side": "sell",
    "ordType": "limit",
    "sz": "1",
    "px": "35000",
    "posSide": "short",
    "mrgPosition": "merge",
}


响应参数​

字段名类型字段描述
ordIdstring订单 ID
clOrdIdstring客户自定义订单 ID
tagstring订单标签
sCodestring事件执行结果的状态码 0:成功;
sMsgstring事件执行失败时的消息

响应示例​

{
    "code": "0",
    "msg": "",
    "data": {
        "ordId": "1000587866646229",
        "clOrdId": "",
        "tag": "",
        "sCode": "0",
        "sMsg": ""
    }
}