私有频道

下单

描述

ACK 仅表示请求被成功接受，请使用 WebSocket order 推送来确认订单的实际状态。

该接口支持现货、杠杆、合约以及 Reality（rToken）股票下单，并可以自定义包括价格、数量和订单类型等参数

Reality（rToken）限频
用户级：默认 5次/秒/UID，白名单用户 30次/秒/UID（可联系 BD/RM 申请）。
合约交易
合约单向持仓下只减仓订单，如果已经存在减仓单并且减仓单数量已经等于仓位数量，或者你新下的减仓单大于仓位剩余数量，会自动把之前减仓单取消，重新下新的减仓单，此时返回的信息 orderId会为 null，建议一定要传clientOid
杠杆交易
杠杆下单会自动借贷
订单检查
- 合约：Price下单价格要满足价格乘数priceMultiplier的倍数，并且符合pricePrecision小数位。qty要满足大于minOrderAmount并且满足sizeMultiplier的倍数
- 现货：price要满足小数位。qty下单数量必须要大于 minOrderAmount
开仓逻辑
- 双向持仓开多： side=buy & posSide=long
  开空：side=sell & posSide=short
  平多：side=sell & posSide=long
  平空：side=buy & posSide=short
- 单向持仓开多 side
  开空 side
  平多 side reduceOnly
  平空 side reduceOnly
订单持有上限:
- 合约: USDT合约/币本位合约/USDC合约所有交易对加起来一共最多支持400个订单
- 现货: 现货/杠杆所有交易对最多支持400订单
ClientOid 校验规则:
请确保您的 clientOid 满足正则表达式 ^[0-9A-Za-z_:#\\-+\\s]{1,32}$
请求监控:将针对您的 API 请求进行统计监控，当单日 (UTC 0点 - UTC 24点) 单账号（母账号和子账号整体运算）订单总数超过一定上限，平台将保留提醒、警告，以及进行必要性限制的权利。使用API的客户预设接收本条款并负有配合调整的义务。
下单出现错误 { "code":"40762", "msg":"The order size is greater than the max open size", "requestTime":1627293504612 }
两种原因
- 账户余额不足
当前交易对当前杠杆仓位梯度已满，具体仓位梯度请参考仓位档位说明
注意：操作订单时出现以下错误，请用clientOid查询订单详情，以确认操作的最终结果
币本位合约说明:
- 新币本位业务线symbol格式为"XXXUSD_CM"，例如BTCUSD交易对在币本位合约的格式为BTCUSD_CM
- 新币本位暂时不支持修改订单，ADL，策略单，预设止盈止损


Code
{ "code": "40010", "msg": "Request timed out", "id": 1666268894074, "event":"error" }
{ "code": "40725", "msg": "service return an error", "id": 1666268894071, "event":"error" }
{ "code": "45001", "msg": "Unknown error", "id": 1666268894071, "event":"error" }


Code
{
  "op": "trade",
  "id": "1750034396082",
  "category": "spot",
  "topic": "place-order",
  "requestTime": "1750034396082",
  "args": [
    {
      "orderType": "limit",
      "price": "100",
      "qty": "0.1",
      "side": "buy",
      "symbol": "BTCUSDT",
      "timeInForce": "gtc",
    }
  ]
}

请求参数

参数名	参数类型	是否必须	描述
op	String	是	操作: `trade` 交易
id	String	是	请求标识
topic	String	是	频道名: `place-order` 下单
category	String	是	业务线（必须小写） `spot`现货交易 `margin` 杠杆交易 `usdt-futures` U本位合约 `coin-futures` 币本位合约 `usdc-futures` USDC合约
apiCode	String	否	API返佣标识
requestTime	String	否	请求时间（客户端时间戳）用于与 `receiveWindow` 比对时间差值不传则 `receiveWindow` 参数无效
args	List<Object>	是	请求订阅的频道列表
> symbol	String	是	交易对名称
> orderType	String	是	订单类型 `limit` : 限价 `market` : 市价
> qty	String	是	下单数量 - 现货市价买单，单位为quote coin 限价及市价卖单，单位为base coin USDT/USDC合约：单位为base coin 币本位合约：单位为 quote coin
> price	String	否	下单价格订单类型为限价单`limit`时，该字段必填订单类型为市价单`market`时，该字段失效
> side	String	是	下单方向 `buy`: 买 `sell`: 卖
> posSide	String	否	交易方向 `long` 多仓 `short` 空仓只限于合约传此参数其他忽略用于合约双向持仓
> timeInForce	String	否	订单执行策略 `gtc`: 普通订单, 订单会一直有效，直到被成交或者取消 `ioc`: 无法立即成交的部分就撤销 `fok`: 无法全部立即成交就撤销 `post_only`: 只做maker `rpi`: 零售价格优化订单，为零售订单流提供价格优化的非显示限价单。仅限拥有RPI做市商权限的账户使用。订单类型为限价单limit时必填，若省略则默认为gtc 订单类型为市价单market时，该字段失效，系统会按照ioc执行
> reduceOnly	String	否	是否只减仓 `YES`是 `NO`否默认值为`NO`; 仅适用于买卖单向持仓模式下
> clientOid	String	否	自定义订单ID 需满足正则表达式 `^[0-9A-Za-z_:#\-+\s]{1,32}$`，即 1-32 个字符，可包含大小写字母、数字、下划线(_)、连字符(-)、加号(+)、冒号(:)、井号(#)和空格
> stpMode	String	否	STP（自成交预防）模式 `none`：不比较双方用户ID，订单正常成交，不触发STP（默认值） `cancel_taker`：检测到自成交时，取消taker（吃单方）订单，maker（挂单方）订单保留在订单簿中 `cancel_maker`：检测到自成交时，取消maker（挂单方）订单，taker（吃单方）订单继续执行 `cancel_both`：检测到自成交时，taker和maker订单都取消 STP判定以taker订单自身携带的`stpMode`为准，不看maker订单原有的`stpMode`设置
> tpTriggerBy	String	否	预设止盈触发类型 `market`市场价格 `mark`标记价格如不填写，默认值为`market`市场价格该字段仅针对合约业务线`usdt-futures`，`coin-futures`及`usdc-futures`生效
> slTriggerBy	String	否	预设止损触发类型 `market`市场价格 `mark`标记价格如不填写，默认值为`market`市场价格该字段仅针对合约业务线`usdt-futures`，`coin-futures`及`usdc-futures`生效
> takeprofit	String	否	预设止盈触发价格
> stoploss	String	否	预设止损触发价格
> tpOrderType	String	否	止盈触发的策略单类型 `limit` 限价单 `market` 市价单
> slOrderType	String	否	止损触发的策略单类型 `limit` 限价单 `market` 市价单
> tpLimitPrice	String	否	止盈策略单执行价格仅限价单`tpOrderType=limit`时有效，市价单忽略该参数
> slLimitPrice	String	否	止损策略单执行价格仅限价单`slOrderType=limit`时有效，市价单忽略该参数
> marginMode	String	否	保证金模式 `crossed` 全仓 `isolated` 逐仓不传默认为全仓仅适用于合约
> autoBorrow	String	否	自动借币开关 `yes` 开启 `no` 关闭（默认）仅用于现货下单。开启后，若得到币不支持借贷、消耗币支持借贷，则在消耗币可用余额不足时，系统将自动借入消耗币，补足委托所需金额。
> receiveWindow	String	否	有效窗口期（订单TTL机制）单位为毫秒，有效范围：[10, 60000] 不填则不设置有效期，订单长期有效直至撤单或成交注意：`receiveWindow` 仅在同时传入 `requestTime` 时生效


Code
{
  "event": "trade",
  "id": "1750034396082",
  "category": "spot",
  "topic": "place-order",
  "args": [
    {
      "symbol": "BTCUSDT",
      "orderId": "xxxxxxxx",
      "clientOid": "xxxxxxxx",
      "cTime": "1750034397008",
      "receiveTime": "1750034396998123",
      "pushTime": "1750034397076456"
    }
  ],
  "code": "0",
  "msg": "success",
  "connId": "xxxxxxxxxx",
  "rateLimit": [
    {
      "limit": "10",
      "remaining": "9"
    }
  ],
  "ts": "1750034397076"
}

响应参数说明

返回字段	参数类型	字段说明
event	String	事件 `trade` 交易 `error`参数错误
id	String	请求标识
topic	String	频道名 `place-order`下单
category	String	业务线 `spot`现货交易 `margin` 杠杆交易 `usdt-futures` U本位合约 `coin-futures` 币本位合约 `usdc-futures` USDC合约
args	List<Object>	订单列表
> symbol	String	交易对名称，如`BTCUSDT`
> orderId	String	订单ID
> clientOid	String	自定义订单ID
> cTime	String	订单创建时间 Unix毫秒时间戳
> receiveTime	String	网关接收时间 Unix微秒时间戳
> pushTime	String	网关推送时间 Unix微秒时间戳
code	String	状态码
msg	String	状态消息
connId	String	连接ID
rateLimit	Array	限频余额数组
> limit	String	该维度限额
> remaining	String	剩余可用次数
ts	String	时间戳

公共强平撤单

{ "code": "40010", "msg": "Request timed out", "id": 1666268894074, "event":"error" }
{ "code": "40725", "msg": "service return an error", "id": 1666268894071, "event":"error" }
{ "code": "45001", "msg": "Unknown error", "id": 1666268894071, "event":"error" }

{
  "op": "trade",
  "id": "1750034396082",
  "category": "spot",
  "topic": "place-order",
  "requestTime": "1750034396082",
  "args": [
    {
      "orderType": "limit",
      "price": "100",
      "qty": "0.1",
      "side": "buy",
      "symbol": "BTCUSDT",
      "timeInForce": "gtc",
    }
  ]
}

参数名

参数类型

是否必须

描述

String

是

操作:
trade 交易

String

是

请求标识

topic

String

是

频道名:
place-order 下单

category

String

是

业务线（必须小写）
spot现货交易
margin 杠杆交易
usdt-futures U本位合约
coin-futures 币本位合约
usdc-futures USDC合约

apiCode

String

否

API返佣标识

requestTime

String

否

请求时间（客户端时间戳）
用于与 receiveWindow 比对时间差值
不传则 receiveWindow 参数无效

args

List<Object>

是

请求订阅的频道列表

> symbol

String

是

交易对名称

> orderType

String

是

订单类型
limit : 限价
market : 市价

> qty

String

是

下单数量
- 现货
市价买单，单位为quote coin
限价及市价卖单，单位为base coin
USDT/USDC合约：
单位为base coin
币本位合约：
单位为 quote coin

> price

String

否

下单价格
订单类型为限价单limit时，该字段必填
订单类型为市价单market时，该字段失效

> side

String

是

下单方向
buy: 买
sell: 卖

> posSide

String

否

交易方向
long 多仓
short 空仓
只限于合约传此参数其他忽略
用于合约双向持仓

> timeInForce

String

否

订单执行策略
gtc: 普通订单, 订单会一直有效，直到被成交或者取消
ioc: 无法立即成交的部分就撤销
fok: 无法全部立即成交就撤销
post_only: 只做maker
rpi: 零售价格优化订单，为零售订单流提供价格优化的非显示限价单。仅限拥有RPI做市商权限的账户使用。
订单类型为限价单limit时必填，若省略则默认为gtc
订单类型为市价单market时，该字段失效，系统会按照ioc执行

> reduceOnly

String

否

是否只减仓
YES是
NO否
默认值为NO; 仅适用于买卖单向持仓模式下

> clientOid

String

否

自定义订单ID
需满足正则表达式 ^[0-9A-Za-z_:#\-+\s]{1,32}$，即 1-32 个字符，可包含大小写字母、数字、下划线(_)、连字符(-)、加号(+)、冒号(:)、井号(#)和空格

> stpMode

String

否

STP（自成交预防）模式
none：不比较双方用户ID，订单正常成交，不触发STP（默认值）
cancel_taker：检测到自成交时，取消taker（吃单方）订单，maker（挂单方）订单保留在订单簿中
cancel_maker：检测到自成交时，取消maker（挂单方）订单，taker（吃单方）订单继续执行
cancel_both：检测到自成交时，taker和maker订单都取消
STP判定以taker订单自身携带的stpMode为准，不看maker订单原有的stpMode设置

> tpTriggerBy

String

否

预设止盈触发类型
market市场价格
mark标记价格
如不填写，默认值为market市场价格
该字段仅针对合约业务线usdt-futures，coin-futures及usdc-futures生效

> slTriggerBy

String

否

预设止损触发类型
market市场价格
mark标记价格
如不填写，默认值为market市场价格
该字段仅针对合约业务线usdt-futures，coin-futures及usdc-futures生效

> takeprofit

String

否

预设止盈触发价格

> stoploss

String

否

预设止损触发价格

> tpOrderType

String

否

止盈触发的策略单类型
limit 限价单
market 市价单

> slOrderType

String

否

止损触发的策略单类型
limit 限价单
market 市价单

> tpLimitPrice

String

否

止盈策略单执行价格
仅限价单tpOrderType=limit时有效，市价单忽略该参数

> slLimitPrice

String

否

止损策略单执行价格
仅限价单slOrderType=limit时有效，市价单忽略该参数

> marginMode

String

否

保证金模式
crossed 全仓
isolated 逐仓
不传默认为全仓
仅适用于合约

> autoBorrow

String

否

自动借币开关
yes 开启
no 关闭（默认）
仅用于现货下单。开启后，若得到币不支持借贷、消耗币支持借贷，则在消耗币可用余额不足时，系统将自动借入消耗币，补足委托所需金额。

> receiveWindow

String

否

有效窗口期（订单TTL机制）
单位为毫秒，有效范围：[10, 60000]
不填则不设置有效期，订单长期有效直至撤单或成交
注意：receiveWindow 仅在同时传入 requestTime 时生效

{
  "event": "trade",
  "id": "1750034396082",
  "category": "spot",
  "topic": "place-order",
  "args": [
    {
      "symbol": "BTCUSDT",
      "orderId": "xxxxxxxx",
      "clientOid": "xxxxxxxx",
      "cTime": "1750034397008",
      "receiveTime": "1750034396998123",
      "pushTime": "1750034397076456"
    }
  ],
  "code": "0",
  "msg": "success",
  "connId": "xxxxxxxxxx",
  "rateLimit": [
    {
      "limit": "10",
      "remaining": "9"
    }
  ],
  "ts": "1750034397076"
}

返回字段

参数类型

字段说明

event

String

事件
trade 交易
error参数错误

String

请求标识

topic

String

频道名
place-order下单