Market Status Subscription

Info

• Subscribe to 24h market status
• The push delay of this method is about：200ms

24h Market Status Subscription

• Method: state.subscribe
• Parameters:

Parameter Name	Required	Type	Notes
market_list	true	[]string	List of market names. Empty list to subscribe to all markets.

• Subscription example:

// Subscribe to a singular market
{
    "method": "state.subscribe",
    "params": {"market_list": ["BTCUSDT"]},
    "id": 1
}

// Subscribe to multiple markets
{
    "method": "state.subscribe",
    "params": {"market_list": ["BTCUSDT", "ETHUSDT", "BNBUSDT"]},
    "id": 1
}

// Subscribe to all markets
{
    "method": "state.subscribe",
    "params": {"market_list": []},
    "id": 1
}

24h Market Status Push

• Method: state.update
• Parameters:

Parameter Name	Type	Notes
market	string	Market name
last	string	Latest price
open	string	Opening price
close	string	Closing price
high	string	Highest price
low	string	Lowest price
volume	string	24H volume
value	string	24h value
volume_sell	string	Best ask size
volume_buy	string	Best bid size
insurance_fund_size	string	Insurance fund amount
mark_price	string	Mark price
index_price	string	Index price
open_interest_size	string	Current position
latest_funding_rate	string	Current funding rate.The funding rate at the current settlement time, calculated every minute, for reference only. If the funding rate is positive, the long positions pay the short side; If the funding rate is negative, the short positions pay the long side.
next_funding_rate	string	Next funding rate.Consistent with the current funding rate.At the time of funding rate collection, the predicted funding rate = current funding rate
latest_funding_time	int	The time when the current funding rate is collected.Funding rates are calculated every minute and are paid/collected once every 8 hours by default. When the premium rate is too high, it can be dynamically adjusted to 2h or 4h.
next_funding_time	int	The time when the next funding rate will be collected.Funding rates are calculated every minute and are paid/collected once every 8 hours by default. When the premium rate is too high, it can be dynamically adjusted to 2h or 4h.
period	int	Period, fixed at 86400, indicates that the data is a one-day value

• Subscription example:

{
    "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
}

Cancel Market Status Data Subscription

• Method: state.unsubscribe
• Parameters:

Parameter Name	Required	Type	Notes
market_list	true	[]string	List of market names. Empty list to unsubscribe to all markets.

• Unsubscribe example:

// Cancel all subscribed markets
{
    "method": "state.unsubscribe",
    "params": {"market_list": []},
    "id": 1
}

// Cancel a singular subscribed market
{
    "method": "state.unsubscribe",
    "params": {"market_list": ["BTCUSDT"]},
    "id": 1
}

// Cancel multiple subscribed markets
{
    "method": "state.unsubscribe",
    "params": {"market_list": ["BTCUSDT", "ETHUSDT", "BNBUSDT"]},
    "id": 1
}