下单 (TRADE)

POST /capi/v3/order

请求权重

10s order rate limit(X-ORDER-COUNT-10S)为1; 1min order rate limit(X-ORDER-COUNT-1M)为1; IP rate limit(X-USED-WEIGHT-1M)为0

请求体（Request Body）

参数名	类型	是否必填	说明
symbol	String	是	交易对，例如 `BTCUSDT`。
side	String	是	买卖方向，取值：`BUY`、`SELL`。
positionSide	String	是	持仓方向，取值：`LONG`、`SHORT`。
type	String	是	订单类型，取值：`LIMIT`、`MARKET`。
timeInForce	String	条件必填	有效方式，`type = LIMIT` 时必填，取值：`GTC`、`IOC`、`FOK`、`POST_ONLY`；BBO 下单仅支持 `GTC`。
quantity	String	是	下单数量，必须大于 0。
price	String	条件必填	限价价格，仅在 `type=LIMIT` 且未传 `priceMatch` 时必填，必须大于 0。与 `priceMatch` 互斥。
priceMatch	enum	否	仅对 `LIMIT` 订单有效；不能与 `price` 参数同时传入，`timeInForce` 必须为 `GTC`。枚举值：`OPPONENT`、`OPPONENT_5`、`QUEUE`、`QUEUE_5`。示例：`OPPONENT`。
newClientOrderId	String	是	客户自定义订单号（1-36 位，匹配 `^[\\.A-Z\:/a-z0-9_-]{1,36}$`）。
tpTriggerPrice	String	否	预设止盈触发价。
slTriggerPrice	String	否	预设止损触发价。
TpWorkingType	String	否	止盈触发价计算基准，取值：`CONTRACT_PRICE`、`MARK_PRICE`，默认 `CONTRACT_PRICE`。
SlWorkingType	String	否	止损触发价计算基准，取值：`CONTRACT_PRICE`、`MARK_PRICE`，默认 `CONTRACT_PRICE`。
reduceOnly	Boolean	否	是否只减仓。

BBO 下单规则：仅当 type=LIMIT 且传入 priceMatch 时启用；timeInForce 必须显式传 GTC。请省略 price；传正数价格会报错（兼容接受 price=0，服务向交易所传价格 0）。NONE 仅用于查询响应，不能用于下单。不传 priceMatch 时保留普通订单逻辑；非 LIMIT 订单忽略 priceMatch。

请求示例

Code
curl -X POST "https://api-contract.weex.com/capi/v3/order" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*******" \
   -H "ACCESS-PASSPHRASE:*****" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "Content-Type: application/json" \
   -d '{
     "symbol": "BTCUSDT",
     "side": "BUY",
     "positionSide": "LONG",
     "type": "LIMIT",
     "timeInForce": "GTC",
     "quantity": "0.01",
     "price": "69000",
     "newClientOrderId": "my-order-0001",
     "tpTriggerPrice": "70000",
     "slTriggerPrice": "68000",
     "TpWorkingType": "CONTRACT_PRICE",
     "SlWorkingType": "MARK_PRICE",
     "reduceOnly": false
   }'

返回参数

参数名	类型	说明
orderId	String	系统生成的订单 ID。
clientOrderId	String	回显的 `newClientOrderId`。
success	Boolean	是否受理成功。
errorCode	String	当 `success = false` 时返回错误码；成功时为空。
errorMessage	String	当 `success = false` 时返回错误信息；成功时为空。

返回示例

Code
{
  "orderId": "702345678901234567",
  "clientOrderId": "my-order-0001",
  "success": true,
  "errorCode": "",
  "errorMessage": ""
}

BBO 下单请求体示例

Code
{
  "symbol": "ETHUSDT",
  "side": "BUY",
  "positionSide": "LONG",
  "type": "LIMIT",
  "timeInForce": "GTC",
  "quantity": "0.001",
  "priceMatch": "OPPONENT",
  "newClientOrderId": "bbo-order-0001"
}