用戶委託單訂閱

提示

• 此功能使用前需要呼叫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.stop_id	int	關聯的計畫委託訂單id
order.market	string	市場名
order.side	string	訂單方向，buy或sell
order.type	string	訂單類型，limit或market或GTC或IOC或FOK
order.amount	string	訂單數量
order.price	string	價格
order.unfilled_amount	string	未成交數量
order.filled_amount	string	成交量
order.filled_value	string	成交額
order.client_id	string	使用者自訂id
order.fee	string	收取的交易手續費
order.fee_ccy	string	收取的手續費幣種
order.taker_fee_rate	string	taker 費率
order.maker_fee_rate	string	maker 費率
order.last_filled_amount	string	最後一筆成交的數量
order.last_filled_price	string	最後一筆成交的價格
order.created_at	int	下單時間戳(毫秒)
order.updated_at	int	最新更新時間戳(毫秒)

• 範例:

{
    "method": "order.update",
    "data": {
        "event": "put",
        "order": {
            "order_id": 98388656341,
            "stop_id": 0,
            "market": "BTCUSDT",
            "side": "buy",
            "type": "limit",
            "amount": "0.0010",
            "price": "50000.00",
            "unfilled_amount": "0.0010",
            "filled_amount": "0",
            "filled_value": "0",
            "fee": "0",
            "fee_ccy": "USDT",
            "taker_fee_rate": "0.00046",
            "maker_fee_rate": "0.00000000000000000000",
            "client_id": "",
            "last_filled_amount": "0.0010",
            "last_filled_price": "30721.35",
            "created_at": 1689145715129,
            "updated_at": 1689145715129
        }
    },
    "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
}