BBO

Subscribe

Rate Limit: 1 requests per 1 seconds per IP

Request

JSON

{  
    "action":"SUBSCRIBE",  
    "args":[  
        {  
            "channel":"BBO",  
            "instId":"BINANCE_SPOT_BTC_USDT"  
        },  
        {  
            "channel":"BBO",  
            "instId":"OKX_SPOT_BTC_USDT"  
        },{  
            "channel":"BBO",  
            "instId":"BINANCE_PERP_BTC_USDT"  
        },  
        {  
            "channel":"BBO",  
            "instId":"OKX_PERP_BTC_USDT"  
        }
    ]  
}
 

Field name	Type	Necessary	Remarks
action	String	Y	Action
args	Array	Y	Subscribe param，there can be no more than 20 instId parameters per subscribe
> channel	String	Y	Channel name
> instId	String	Y	Unique identifier

Response

JSON

{  
    "event": "SUBSCRIBE",  
    "args": [  
        {  
            "channel":"BBO",  
            "instId":"BINANCE_SPOT_BTC_USDT"  
        },  
        {  
            "channel":"BBO",  
            "instId":"OKEX_SPOT_BTC_USDT"  
        },{  
            "channel":"BBO",  
            "instId":"BINANCE_PERP_BTC_USDT"  
        },  
        {  
            "channel":"BBO",  
            "instId":"OKX_PERP_BTC_USDT"  
        }   
    ],  
    "code": 0  
}
 

Field	Type	Remarks
event	String	Event
code	String	Code
args	Array	Data
> channel	String	Channel
> instId	String	Unique identifier

BBO example:

JSON

{
    "instId": "BINANCE_SPOT_BNB_USDT",
    "publicChannelTypeEnum": "BBO",
    "exchangeTs": 1701048908942000000,
    "localTs": 1701048908944715333,
    "seqNum": 685893995,
    "symbol": "BNBUSDT",
    "exchange": "BINANCE_SPOT",
    "bid":
    {
        "price": 231.6,
        "qty": 282.5720000000001
    },
    "ask":
    {
        "price": 231.7,
        "qty": 407.454
    }
}

Field	Type	Remarks
instId	String	Unique identifier
publicChannelTypeEnum	String	PublicChannelType, example: ORDER_BOOK
exchangeTs	Long	Exchange timestamp
localTs	Long	Local timestamp
seqNum	Long	Message sequence number
symbol	String	Trading symbol , example: BTCUSDT
exchange	String	Exchange
bid	Object	Bid best price and quantity
> price	Double	Price
> qty	Double	Quantity
ask	Object	Ask price and quantity
> price	Double	Price
> qty	Double	Quantity

Unsubscribe

Rate Limit: 1 requests per 1 seconds per IP

Request

JSON

{  
    "action":"UNSUBSCRIBE",  
    "args":[  
        {  
            "channel":"BBO",  
            "instId":"BINANCE_SPOT_BTC_USDT"  
        },  
        {  
            "channel":"BBO",  
            "instId":"OKX_SPOT_BTC_USDT"  
        },{  
            "channel":"BBO",  
            "instId":"BINANCE_PERP_BTC_USDT"  
        },  
        {  
            "channel":"BBO",  
            "instId":"OKX_PERP_BTC_USDT"  
        }   
    ]  
}
 

Field name	Type	Necessary	Remarks
action	String	Y	Action
args	Array	Y	Data
> channel	String	Y	Channel name
> instId	String	Y	Unique identifier

Response

JSON

 {  
    "event": "UNSUBSCRIBE",  
    "args": [  
        {  
            "channel":"BBO",  
            "instId":"BINANCE_SPOT_BTC_USDT"  
        },  
        {  
            "channel":"BBO",  
            "instId":"OKX_SPOT_BTC_USDT"  
        },{  
            "channel":"BBO",  
            "instId":"BINANCE_PERP_BTC_USDT"  
        },  
        {  
            "channel":"BBO",  
            "instId":"OKX_PERP_BTC_USDT"  
        }   
    ],  
    "code": 0  
}

Field	Type	Remarks
event	String	Event
code	String	Code
args	Array	Data
> channel	String	Channel name
> instId	String	Unique identifier