API Reference

BBO

Description

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


Request

{ "event": "SUBSCRIBE", "arg": [ { "channel": "BBO", "instId": "BINANCE_PERP_BTC_USDT" } ] }
Field nameTypeNecessaryRemarks
eventStringYSUBSCRIBE, UNSUBSCRIBE
argArrayYSubscribe param,there can be no more than 50 instId parameters per subscribe.
> channelStringYChannel name
> instIdStringYUnique identifier

Response

{ "event": "SUBSCRIBE", "arg": [ { "channel": "BBO", "instId": "BINANCE_PERP_BTC_USDT" } ], "code": 0, "message": "Success" }
FieldTypeRemarks
eventStringEvent
codeStringError Code
msgStringError Message
argArraySubscribe param
> channelStringChannel name
> instIdStringUnique identifier

BBO example:

{ "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" } }
FieldTypeRemarks
instIdStringUnique identifier
channelStringexample:BBO
exchangeTsLongExchange timestamp
localTsLongLocal timestamp
seqNumLongMessage sequence number
exchangeStringExchange
bidObjectBid best price and quantity
> priceStringPrice
> qtyStringQuantity
askObjectAsk price and quantity
> priceStringPrice
> qtyStringQuantity