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 | Taker selling volume |
volume_buy | string | Taker buying volume |
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
}