跳到主要內容

下委託單

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

HTTP 請求​

POST /spot/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訂單更新時間

請求範例​

// 下限价委托单
{
    "market": "CETUSDT",
    "market_type": "MARGIN",
    "side": "buy",
    "type": "limit",
    "amount": "10000",
    "price": "1",
    "client_id": "user1",
    "is_hide": true
}

// 下市价委托单
{
    "market": "CETUSDT",
    "market_type": "MARGIN",
    "side": "buy",
    "type": "market",
    "amount": "100",
    "ccy": "CET",
    "client_id": "user1",
    "is_hide": true
}

回應範例​

{
    "code": 0,
    "data": {
        "order_id": "13400",
        "market": " CETUSDT",
        "market_type": "MARGIN",
        "ccy": "CET",
        "side": "buy",
        "type": "limit",
        "amount": "10000",
        "price": "1",
        "ccy": "CET",
        "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"
}