BBO

Description

Rate Limit: 10 requests per second per IP for Subscribe and Unsubscribe.

Request

JSON

{
    "event": "SUBSCRIBE",
    "arg": [
        {
            "channel": "BBO",
            "instId": "BINANCE_PERP_BTC_USDT"
        }
    ]
}

Field name	Type	Necessary	Remarks
event	String	Y	SUBSCRIBE, UNSUBSCRIBE
args	Array	Y	Subscribe param，there can be no more than 50 instId parameters per subscribe.
> channel	String	Y	Channel name
> instId	String	Y	Unique identifier

Response

JSON

{
    "event": "SUBSCRIBE",
    "arg": [
        {
            "channel": "BBO",
            "instId": "BINANCE_PERP_BTC_USDT"
        }
    ],
    "code": 0,
    "message": "Success"
}

Field	Type	Remarks
event	String	Event
code	String	Error Code
msg	String	Error Message
arg	Array	Subscribe param
> channel	String	Channel name
> instId	String	Unique identifier

BBO example:

JSON

{
    "instId": "BINANCE_PERP_BTC_USDT",
    "channel": "BBO",
    "localTs": 1736426853914123300,
    "exchangeTs": 1736426853913000000,
    "seqNum": 1000006372173616600,
    "exchange": "BINANCE_USDM",
    "bid": {
        "price": "93281.9",
        "qty": "5.795000"
    },
    "ask": {
        "price": "93282.0",
        "qty": "0.005000"
    }
}

Field	Type	Remarks
instId	String	Unique identifier
channel	String	example:BBO
exchangeTs	Long	Exchange timestamp
localTs	Long	Local timestamp
seqNum	Long	Message sequence number
exchange	String	Exchange
bid	Object	Bid best price and quantity
> price	String	Price
> qty	String	Quantity
ask	Object	Ask price and quantity
> price	String	Price
> qty	String	Quantity