下批量委託單

資訊

• 此介面需要簽名，具體簽名規則請參閱認證
• 此介面會觸發限頻，具體規則請參閱限頻

危險

• 當伺服器壓力水準過高時，下單會觸發3008 異常報錯。
• 當觸發3008 錯誤時，撤單請求仍然享有高優先級，即伺服器會優先處理撤單請求。

HTTP 請求

POST /futures/batch-order

請求參數

參數名	是否必須	類型	說明
market	true	string	市場名稱
market_type	true	string	市場類型。 注意：在現貨相關功能中，僅可使用SPOT 或MARGIN 在合約相關功能中，只可使用FUTURES
side	true	string	訂單方向
type	true	string	訂單類型
amount	true	string	委託數量
price	false	string	委託價格
client_id	false	string	客戶自訂ID client_id是訂單的自訂ID。伺服器將在訂單回應中傳回使用者自訂的client_id，並且也可以使用client_id作為識別來進行批次撤單，詳見透過client_id撤單相關介面 目前它僅支援大寫和小寫字母，數字，連字符和下劃線，並且應小於32個位元組。
is_hide	false	bool	是否隱藏委託。預設為: false 隱藏訂單會在公開的深度資訊中隱藏本筆訂單，但在使用者自己的深度訂閱回應中會顯示
stp_mode	false	string	自成交保護模式。 ct: 立即取消剩餘的Taker單 cm: 立即取消剩餘的Maker單（剩餘的taker單不受影響，若設定為限價吃單，剩餘沒有成交的taker單以限價繼續掛單） both: 立即取消剩餘的Taker和Maker單 *注意 *：在集合競價期間掛單stp_mode不生效

請求回應

參數名	類型	說明
order_id	int	訂單ID
market	string	市場名稱
market_type	string	市場類型
side	string	訂單方向
type	string	訂單類型
amount	string	委託數量
price	string	委託價格
unfilled_amount	string	未成交數量
filled_amount	string	已成交數量
filled_value	string	已成交價值
client_id	string	客戶端ID
fee	string	收取的交易手續費
fee_ccy	string	收取的手續費幣種
maker_fee_rate	string	maker 手續費費率
taker_fee_rate	string	taker 手續費費率
last_filled_amount	string	最後一筆成交的數量
last_filled_price	string	最後一筆成交的價格
realized_pnl	string	已實現盈虧
created_at	int	訂單創建時間
updated_at	int	訂單更新時間

---

請求範例

{
    "orders": [
        {
            "market": "CETUSDT",
            "market_type": "FUTURES",
            "side": "buy",
            "type": "limit",
            "amount": "10000",
            "price": "1",
            "client_id": "user1",
            "is_hide": true
        }
    ]
}

回應範例

{
    "code": 0,
    "data": [
        {
            "code": 0,
            "data": {
                "order_id": "13400",
                "market": " CETUSDT",
                "market_type": "FUTURES",
                "side": "buy",
                "type": "limit",
                "amount": "10000",
                "price": "1",
                "unfilled_amount": "50241.7185224371",
                "filled_amount": "27564.87468358",
                "filled_value": "27564.87468358",
                "client_id": "client_id_1",
                "fee": "11.6582326221",
                "fee_ccy": "USDT",
                "maker_fee_rate": "0",
                "taker_fee_rate": "0.0003",
                "last_filled_amount": "27564.87468358",
                "last_filled_price": "1",
                "realized_pnl": "-22.142539215",
                "created_at": 1691482451000,
                "updated_at": 1691482451000
            },
            "message": "OK"
        }
    ]
    "message": "OK"
}