市場狀態訂閱

資訊

• 訂閱市場24小時狀態
• 此介面推送延遲為：200ms

24小時市場狀態訂閱

• 方法: state.subscribe
• 參數:

參數名	是否必須	類型	說明
market_list	true	[]string	市場名列表，空列表表示訂閱全部市場

• 訂閱範例:

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

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

// 訂閱全部市場
{
    "method": "state.subscribe",
    "params": {"market_list": []},
    "id": 1
}

24小時市場狀態推播

• 方法: state.update
• 參數:

參數名	類型	說明
market	string	市場名
last	string	最新價格
open	string	開盤價
close	string	收盤價
high	string	最高價
low	string	最低價
volume	string	24小時成交量
value	string	24小時成交額
volume_sell	string	賣一量
volume_buy	string	買一量
insurance_fund_size	string	保險基金數量
mark_price	string	標記價格
index_price	string	指數價格
open_interest_size	string	目前持倉量
latest_funding_rate	string	當期資金費率。當期結算時間點的資金費率，每分鐘計算一次，僅供參考。 資金費率為正，則多方支付空方費用； 資金費率為負，則空方支付多方費用。
next_funding_rate	string	下期預測資金費率。與當前資金費率一致。在資金費用收取時刻，預測資金費率=當前資金費率
latest_funding_time	int	當期資金費率收取時間。資金費用每分鐘計算一次，預設8小時支付/收取一次，當溢價率過高時，可動態調整為2h、4h。
next_funding_time	int	下期資金費率收取時間。資金費用每分鐘計算一次，預設8小時支付/收取一次，當溢價率過高時，可動態調整為2h、4h。
period	int	週期，固定為86400，表示該資料是一天的值

• 訂閱範例:

{
    "method": "state.update",
    "data": {
        "state_list": [
            {
                "market": "ETHUSD_SIGNPRICE",
                "last": "1892.29",
                "open": "1884.62",
                "close": "1892.29",
                "high": "1894.09",
                "low": "1863.72",
                "volume": "0",
                "value": "0",
                "volume_sell": "0",
                "volume_buy": "0",
                "open_interest_size": "0",
                "insurance_fund_size": "0",
                "latest_funding_rate": "0",
                "next_funding_rate": "0",
                "latest_funding_time": 1642145331234,
                "next_funding_time": 1642231731234,
                "period": 86400
            },
            {
                "market": "DOTUSDT",
                "last": "5.2483",
                "open": "5.15690000000000000000",
                "close": "5.2483",
                "high": "5.30640000000000000000",
                "low": "5.09040000000000000000",
                "volume": "51996.00000000000000000000",
                "value": "269813.72216000000000000000",
                "volume_sell": "11747.70000000",
                "volume_buy": "14624.70000000",
                "open_interest_size": "92414.6",
                "insurance_fund_size": "24497980.15228462554747551920",
                "mark_price": "5.2513",
                "index_price": "5.2513",
                "latest_funding_rate": "-0.00012921",
                "next_funding_rate": "0.00009768",
                "latest_funding_time": 1642145331234,
                "next_funding_time": 1642231731234,
                "period": 86400
            }
        ]
    ],
    "id": null
}

市場狀態數據取消訂閱

• 方法: state.unsubscribe
• 參數:

參數名	是否必須	類型	說明
market_list	true	[]string	市場名列表，如果為空列表則全部取消訂閱

• 取消訂閱範例:

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

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

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