市场状态订阅

信息

• 订阅市场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
}