下单

POST🔒 Trading

⚡ Orders: 75 req/s per endpoint · 75 req/s per user

提示

下达 LIMIT（限价）或 MARKET（市价）订单。orderType 字段用于选择请求类型及其必填字段。

请求头

名称	类型	是否必填	描述
BROKER-ID	String	否	可选的经纪商/合作方标识符，用于标记通过其下达的订单

请求体

Limit

名称	类型	是否必填	描述
orderType	String	是	订单类型。此类型必须为 LIMIT。
clOrderId	String	否	用于跟踪和幂等性的客户端分配订单标识符。
symbol	String	是	交易对。
orderSide	String	是	订单方向：BUY 或 SELL。
orderSize	Long	是	订单数量（合约张数）。
takeProfitTriggerType	String	否	用于评估止盈触发的参考价格类型。 — `INDEX_PRICE` · `LAST_PRICE` · `MARK_PRICE`
stopLossTriggerType	String	否	用于评估止损触发的参考价格类型。 — `INDEX_PRICE` · `LAST_PRICE` · `MARK_PRICE`
takeProfitTriggerPrice	Double	否	止盈触发价格。达到时将触发附加的止盈订单。
stopLossTriggerPrice	Double	否	止损触发价格。达到时将触发附加的止损订单。
positionMode	String	否	此订单适用的仓位模式（单向或对冲）。 — `ONE_WAY` · `HEDGE` · `ISOLATED`
reduceOnly	Boolean	否	若为 true，该订单只能减少现有仓位，不能开仓或加仓。
timeInForce	String	否	限价订单的有效期策略。省略时默认为 GTC。 — `FOK` · `GTC` · `IOC` · `HALFSEC` · `HALFMIN` · `FIVEMIN` · `HOUR` · `TWELVEHOUR` · `DAY` · `WEEK` · `MONTH`
postOnly	Boolean	否	若为 true，当订单会吃单（消耗流动性）时将被拒绝，确保仅作为 maker 成交。
orderPrice	Double	是	订单的限价。

Market

名称	类型	是否必填	描述
orderType	String	是	订单类型。此类型必须为 MARKET。 — `LIMIT` · `MARKET` · `OCO` · `TWAP` · `PEG` · `CONDITIONAL` · `TRAILING`
clOrderId	String	否	用于跟踪和幂等性的客户端分配订单标识符。
symbol	String	是	交易对。
orderSide	String	是	订单方向：BUY 或 SELL。
orderSize	Long	是	订单数量（合约张数）。
takeProfitTriggerType	String	否	用于评估止盈触发的参考价格类型。 — `INDEX_PRICE` · `LAST_PRICE` · `MARK_PRICE`
stopLossTriggerType	String	否	用于评估止损触发的参考价格类型。 — `INDEX_PRICE` · `LAST_PRICE` · `MARK_PRICE`
takeProfitTriggerPrice	Double	否	止盈触发价格。达到时将触发附加的止盈订单。
stopLossTriggerPrice	Double	否	止损触发价格。达到时将触发附加的止损订单。
positionMode	String	否	此订单适用的仓位模式（单向或对冲）。 — `ONE_WAY` · `HEDGE` · `ISOLATED`
reduceOnly	Boolean	否	若为 true，该订单只能减少现有仓位，不能开仓或加仓。

响应内容

名称	类型	描述
status	Integer	本次下单返回的订单状态码。
type	Integer	订单类型代码。
symbol	String	交易对。
postOnly	Boolean	若订单被接受为仅 maker，则为 true。
orderSide	String	订单方向：BUY 或 SELL。
orderId	String	服务器分配的订单 ID。
clOrderID	String	从请求中回传的客户端分配订单 ID。
timestamp	Long	下单的服务器时间戳，单位为自 epoch 起的毫秒数。
price	Double	随订单提交的限价。
avgFilledPrice	Double	迄今为止各笔成交的平均成交价。若尚无成交则为零。
message	String	平台返回的可读消息（例如拒绝原因）。
originalOrderSize	Long	提交时的原始订单数量（合约张数）。
currentOrderSize	Long	成交或修改后的当前剩余订单数量。
filledSize	Long	最近一次撮合的成交数量（合约张数）。
totalFilledSize	Long	所有撮合的累计成交数量（合约张数）。
remainingSize	Long	剩余未成交数量（合约张数）。
positionMode	String	此订单适用的仓位模式（单向或对冲）。 — `ONE_WAY` · `HEDGE` · `ISOLATED`
positionDirection	String	订单将影响的仓位方向：LONG 或 SHORT。
positionId	String	订单所绑定仓位的标识符。
timeInForce	String	应用于订单的有效期策略（例如 GTC、IOC、FOK）。

example

POSThttps://api.btse.com/futures/api/v3/trade/orders

Request (Limit)

{
  "symbol": "BTC-PERP",
  "orderType": "LIMIT",
  "orderSide": "BUY",
  "orderSize": 1,
  "orderPrice": 57009.5
}

Request (Market)

{
  "symbol": "BTC-PERP",
  "orderType": "MARKET",
  "orderSide": "BUY",
  "orderSize": 1
}

Response (Limit)

{
  "status": 2,
  "type": 0,
  "symbol": "BTC-PERP",
  "postOnly": false,
  "orderSide": "BUY",
  "orderId": "0251ea47-88b5-48c0-aeb3-b38774fd1f90",
  "clOrderID": "",
  "timestamp": 1784882344361,
  "price": 57009.5,
  "avgFilledPrice": 0,
  "message": null,
  "originalOrderSize": 1,
  "currentOrderSize": 1,
  "filledSize": 0,
  "totalFilledSize": 0,
  "remainingSize": 1,
  "positionMode": "ONE_WAY",
  "positionDirection": null,
  "positionId": "BTC-PERP-USDT",
  "timeInForce": "GTC"
}

Response (Market)

{
  "status": 4,
  "type": 0,
  "symbol": "BTC-PERP",
  "postOnly": false,
  "orderSide": "BUY",
  "orderId": "8ad94105-8cce-4e01-86b8-2d0fb403db66",
  "clOrderID": "",
  "timestamp": 1784882344446,
  "price": 60010,
  "avgFilledPrice": 60010,
  "message": null,
  "originalOrderSize": 1,
  "currentOrderSize": 1,
  "filledSize": 1,
  "totalFilledSize": 1,
  "remainingSize": 0,
  "positionMode": "ONE_WAY",
  "positionDirection": null,
  "positionId": "BTC-PERP-USDT",
  "timeInForce": "GTC"
}

请求头​

请求体​

响应内容​

请求头

请求体

响应内容