跳到主要內容

下批量委託單

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

HTTP 請求​

POST /spot/batch-order

請求參數​

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

請求回應​

參數名類型說明
order_idint訂單ID
marketstring市場名稱
market_typestring市場類型
sidestring訂單方向
typestring訂單類型
ccystring幣種名稱
amountstring委託數量
pricestring委託價格
unfilled_amountstring未成交數量
filled_amountstring已成交數量
filled_valuestring已成交價值
client_idstring客戶端ID
base_feestring收取的交易幣種手續費
quote_feestring收取的報價幣種手續費
discount_feestring收取的抵扣幣種手續費
maker_fee_ratestringmaker 手續費費率
taker_fee_ratestringtaker 手續費費率
last_filled_amountstring最後一筆成交的數量
last_filled_pricestring最後一筆成交的價格
created_atint訂單創建時間
updated_atint訂單更新時間

請求範例​

{
    "orders": [
        {
            "market": "CETUSDT",
            "market_type": "MARGIN",
            "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": "MARGIN",
                "ccy": "CET",
                "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",
                "base_fee": "11.6582326221",
                "quote_fee": "0",
                "discount_fee": "0",
                "maker_fee_rate": "0",
                "taker_fee_rate": "0.0003",
                "last_fill_amount": "27564.87468358",
                "last_fill_price": "1",
                "created_at": 1691482451000,
                "updated_at": 1691482451000
            },
            "message": "OK"
        }
    ]
    "message": "OK"
}