用戶委託單訂閱

提示

• 此功能使用前需要呼叫server.sign方法進行簽章鑑權
• 此介面推送延遲為：即時推送

用戶委託單訂閱

• 方法: order.subscribe
• 參數:

參數名	是否必須	類型	說明
market_list	true	[]string	市場列表，空白列表代表訂閱所有市場

• 範例:

// 訂閱單一市場
{
  "method": "order.subscribe",
  "params": {"market_list": ["BTCUSDT"]},
  "id": 1
}

// 訂閱多個市場
{
  "method": "order.subscribe",
  "params": {"market_list": ["BTCUSDT", "ETHUSDT"]},
  "id": 1
}

// 訂閱所有市集
{
  "method": "order.subscribe",
  "params": {"market_list": []},
  "id": 1
}

用戶委託單更新推播

• 方法: order.update
• 參數:

參數名	類型	說明
event	string	訂單更新事件類型
order	object	訂單數據
order.order_id	int	訂單id
order.market	string	市場名
order.margin_market	string	槓桿市場名，如果是非槓桿市場則為空
order.type	string	訂單類型，limit 或market 或maker_only 或IOC 或FOK
order.side	string	訂單方向，buy或sell
order.amount	string	訂單數量
order.price	string	價格
order.unfilled_amount	string	未成交數量
order.filled_value	string	成交額
order.taker_fee_rate	string	taker 費率
order.maker_fee_rate	string	maker 費率
order.base_ccy_fee	string	交易幣種支付的手續費
order.quote_ccy_fee	string	報價幣種支付的手續費
order.discount_ccy_fee	string	主要為cet支付的手續費
order.last_filled_amount	string	最後一筆成交的數量
order.last_filled_price	string	最後一筆成交的價格
order.client_id	string	使用者自訂id
order.created_at	int	下單時間戳，單位毫秒
order.updated_at	int	最新更新時間戳，單位毫秒

• 範例:

{
    "method": "order.update",
    "data": {
        "event": "put",
        "order": {
            "order_id": 12750,
            "market": "BTCUSDT",
            "margin_market": "BTCUSDT",
            "type": "limit",
            "side": "buy",
            "price": "5999.00",
            "amount": "1.50000000",
            "unfill_amount": "1.50000000",
            "fill_value": "1.50000000",
            "taker_fee_rate": "0.0001",
            "maker_fee_rate": "0.0001",
            "base_ccy_fee": "0.0001",
            "quote_ccy_fee": "0.0001",
            "discount_ccy_fee": "0.0001",
            "last_fill_amount": "0",
            "last_fill_price": "0",
            "client_id": "buy1_1234",
            "created_at": 1689152421692,
            "updated_at": 1689152421692,
        }
    },
    "id": null
}

取消委託訂閱

• 方法: order.unsubscribe
• 參數:

參數名	是否必須	類型	說明
market_list	true	[]string	市場列表，空白列表代表取消所有市場的訂閱

• 範例:

// 取消單一市集訂閱
{
  "method": "order.unsubscribe",
  "params": {"market_list": ["BTCUSDT"]},
  "id": 1
}

// 取消多市場訂閱
{
  "method": "order.unsubscribe",
  "params": {"market_list": ["BTCUSDT", "ETHUSDT"]},
  "id": 1
}

// 取消所有市集的訂閱
{
  "method": "order.unsubscribe",
  "params": {"market_list": []},
  "id": 1
}