SBE Basic Information
MMWS / Gateway only
All SBE-based feeds are described in this section are available only via the Market Maker WebSocket (MMWS) / Market Maker Gateway (GW) infrastructure. For access and architecture details, see the official announcement: Market Maker Gateway
This page gives a unified introduction to Bybit's SBE-based market data channels and how they fit into the MMWS/GW environment. Detailed, feature-specific behavior and code examples are provided in the sub-pages for:
- BBO SBE (Level 1, with RPI fields)
- Level-50 SBE (50-level order book snapshots + deltas)
- PublicTrade SBE (Spot & Futures)
- WS order entry SBE (Spot & Futures & Options)
SBE path
- Spot market:
wss://{MMWS url}/v5/public-sbe/spot - USDT/USDC contracts market:
wss://{MMWS url}/v5/public-sbe/linear - Coin-margin contracts market:
wss://{MMWS url}/v5/public-sbe/inverse - WS order entry:
wss://{MMWS url}/v5/sbe/trade
What is SBE?
Bybit uses Simple Binary Encoding (SBE) in accordance with the FIX/SBE 1.0 specification:
- Binary, little-endian encoding
- Fixed-width fields where possible
- Explicit message header + message body layout
- High-efficiency decoding suitable for HFT and MM strategies
Compared with JSON WebSocket feeds, SBE provides:
- Smaller payloads (up to ~30–50% reduction vs equivalent JSON data)
- Deterministic binary layouts
- Microsecond timestamp precision
- Lower CPU usage for both encoding and decoding
SBE Connection Limit
- Spot: 1500 connections limit per dedicated MMWS host.
- Futures (linear + inverse): 3000 connections limit per dedicated MMWS host.
- Once you breach the connection limit, new connections return HTTP 429.
Behavior Of PreLaunch Contracts
- There is no feed until
ContinuousTradingstage for orderbook & publicTrade
Market SBE XML Template
<?xml version="1.0" encoding="UTF-8"?>
<sbe:messageSchema xmlns:sbe="http://fixprotocol.io/2016/sbe" xmlns:mbx="https://bybit-exchange.github.io/docs/v5/intro" package="quote.sbe" id="1" version="0" semanticVersion="1.0.0" description="Bybit market data streams SBE message schema" byteOrder="littleEndian" headerType="messageHeader">
<types>
<composite name="messageHeader" description="Template ID and length of message root">
<type name="blockLength" primitiveType="uint16"/>
<type name="templateId" primitiveType="uint16"/>
<type name="schemaId" primitiveType="uint16"/>
<type name="version" primitiveType="uint16"/>
</composite>
<composite name="varString8" description="Variable length UTF-8 string.">
<type name="length" primitiveType="uint8"/>
<type name="varData" length="0" primitiveType="uint8" semanticType="String" characterEncoding="UTF-8"/>
</composite>
<composite name="groupSize16Encoding" description="Repeating group dimensions.">
<type name="blockLength" primitiveType="uint16"/>
<type name="numInGroup" primitiveType="uint16"/>
</composite>
<enum name="pkgTypeEnum" encodingType="uint8">
<validValue name="SNAPSHOT">0</validValue>
<validValue name="DELTA">1</validValue>
</enum>
<enum name="SideType" encodingType="uint8">
<validValue name="UNKNOWN">0</validValue>
<validValue name="BUY">1</validValue>
<validValue name="SELL">2</validValue>
<validValue name="NON_REPRESENTABLE">254</validValue>
</enum>
<enum name="BoolEnum" encodingType="uint8">
<validValue name="FALSE">0</validValue>
<validValue name="TRUE">1</validValue>
<validValue name="NON_REPRESENTABLE">254</validValue>
</enum>
</types>
<!-- Stream event for "ob.rpi.1.sbe.<symbol>" channel -->
<sbe:message name="BestOBRpiEvent" id="20000">
<field id="1" name="ts" type="int64" description="The timestamp in microseconds that the system generates the data"/>
<field id="2" name="seq" type="int64" description="Cross sequence ID"/>
<field id="3" name="cts" type="int64" description="The timestamp in microseconds from the matching engine when this orderbook data is produced."/>
<field id="4" name="u" type="int64" description="Update Id"/>
<field id="5" name="askNormalPrice" type="int64" mbx:exponent="priceExponent" description="Mantissa for the best ask normal price"/>
<field id="6" name="askNormalSize" type="int64" mbx:exponent="sizeExponent" description="Mantissa for the best ask normal size"/>
<field id="7" name="askRpiPrice" type="int64" mbx:exponent="priceExponent" description="Mantissa for the best ask rpi price"/>
<field id="8" name="askRpiSize" type="int64" mbx:exponent="sizeExponent" description="Mantissa for the best ask rpi size"/>
<field id="9" name="bidNormalPrice" type="int64" mbx:exponent="priceExponent" description="Mantissa for the best bid normal price"/>
<field id="10" name="bidNormalSize" type="int64" mbx:exponent="sizeExponent" description="Mantissa for the best bid normal size"/>
<field id="11" name="bidRpiPrice" type="int64" mbx:exponent="priceExponent" description="Mantissa for the best bid rpi price"/>
<field id="12" name="bidRpiSize" type="int64" mbx:exponent="sizeExponent" description="Mantissa for the best bid rpi size"/>
<field id="13" name="priceExponent" type="int8" description="Price exponent for decimal point positioning"/>
<field id="14" name="sizeExponent" type="int8" description="Size exponent for decimal point positioning"/>
<data id="55" name="symbol" type="varString8"/>
</sbe:message>
<!-- Stream event for "ob.50.sbe.<symbol>" channel -->
<sbe:message name="OBL50Event" id="20001">
<field id="1" name="ts" type="int64" description="The timestamp in microseconds that the system generates the data"/>
<field id="2" name="seq" type="int64" description="Cross sequence ID"/>
<field id="3" name="cts" type="int64" description="The timestamp in microseconds from the matching engine when this orderbook data is produced."/>
<field id="4" name="u" type="int64" description="Update Id"/>
<field id="5" name="priceExponent" type="int8" description="Price exponent for decimal point positioning"/>
<field id="6" name="sizeExponent" type="int8" description="Size exponent for decimal point positioning"/>
<field id="7" name="pkgType" type="pkgTypeEnum" description="Package type"/>
<group id="40" name="asks" dimensionType="groupSize16Encoding" description="Sell side order book updates">
<field id="1" name="price" type="int64" description="Price mantissa"/>
<field id="2" name="size" type="int64" description="Size mantissa"/>
</group>
<group id="41" name="bids" dimensionType="groupSize16Encoding" description="Buy side order book updates">
<field id="1" name="price" type="int64" description="Price mantissa"/>
<field id="2" name="size" type="int64" description="Size mantissa"/>
</group>
<data id="55" name="symbol" type="varString8"/>
</sbe:message>
<!-- Stream event for "publicTrade.sbe.<symbol>" channel -->
<sbe:message name="PublicTradeEvent" id="20002">
<field id="1" name="ts" type="int64" description="The timestamp in microseconds that the system generates the data"/>
<field id="2" name="priceExponent" type="int8" description="Price exponent for decimal point positioning"/>
<field id="3" name="sizeExponent" type="int8" description="Size exponent for decimal point positioning"/>
<group id="40" name="tradeItems" dimensionType="groupSize16Encoding" description="trade items">
<field id="1" name="fillTime" type="int64" description="The timestamp in microseconds that the order is filled"/>
<field id="2" name="price" type="int64" description="Price mantissa"/>
<field id="3" name="size" type="int64" description="Size mantissa"/>
<field id="4" name="seq" type="int64" description="Cross sequence ID"/>
<field id="5" name="side" type="SideType" description="Side of taker"/>
<field id="6" name="isBlockTrade" type="BoolEnum" description="Whether it is a block trade order or not"/>
<field id="7" name="isRPI" type="BoolEnum" description="Whether it is a RPI trade or not"/>
<data id="100" name="execId" type="varString8" description="Trade ID"/>
</group>
<data id="55" name="symbol" type="varString8"/>
</sbe:message>
</sbe:messageSchema>
WS Order Entry SBE XML Template
<?xml version="1.0" encoding="UTF-8"?>
<sbe:messageSchema xmlns:sbe="http://fixprotocol.io/2016/sbe"
package="order.trading.api.sbe"
id="2"
version="1"
semanticVersion="1.0.0"
description="Order Trading API SBE Schema"
byteOrder="littleEndian">
<types>
<composite name="messageHeader" description="Standard message header">
<type name="blockLength" primitiveType="uint16"/>
<type name="templateId" primitiveType="uint16"/>
<type name="schemaId" primitiveType="uint16"/>
<type name="version" primitiveType="uint16"/>
</composite>
<composite name="groupSize16Encoding" description="Repeating group dimensions">
<type name="blockLength" primitiveType="uint16"/>
<type name="numInGroup" primitiveType="uint16"/>
</composite>
<type name="String8" primitiveType="char" length="8"/>
<type name="String16" primitiveType="char" length="16"/>
<type name="String32" primitiveType="char" length="32"/>
<type name="String64" primitiveType="char" length="64"/>
<composite name="varString8" description="Variable length UTF-8 string">
<type name="length" primitiveType="uint8"/>
<type name="varData" length="0" primitiveType="uint8" semanticType="String" characterEncoding="UTF-8"/>
</composite>
<composite name="Decimal64" description="Decimal floating point: value = mantissa × 10^exponent">
<type name="exponent" primitiveType="int8"/>
<type name="mantissa" primitiveType="int64"/>
</composite>
<enum name="CategoryType" encodingType="uint8">
<validValue name="UNKNOWN">0</validValue>
<validValue name="SPOT">1</validValue>
<validValue name="LINEAR">2</validValue>
<validValue name="INVERSE">3</validValue>
<validValue name="OPTION">4</validValue>
<validValue name="NON_REPRESENTABLE">254</validValue>
</enum>
<enum name="PositionIdxType" encodingType="uint8">
<validValue name="ONE_WAY">0</validValue>
<validValue name="HEDGE_BUY">1</validValue>
<validValue name="HEDGE_SELL">2</validValue>
<validValue name="UNKNOWN">253</validValue>
<validValue name="NON_REPRESENTABLE">254</validValue>
</enum>
<enum name="OrderType" encodingType="uint8">
<validValue name="UNKNOWN">0</validValue>
<validValue name="MARKET">1</validValue>
<validValue name="LIMIT">2</validValue>
<validValue name="NON_REPRESENTABLE">254</validValue>
</enum>
<enum name="SideType" encodingType="uint8">
<validValue name="UNKNOWN">0</validValue>
<validValue name="BUY">1</validValue>
<validValue name="SELL">2</validValue>
<validValue name="NON_REPRESENTABLE">254</validValue>
</enum>
<enum name="TimeInForceType" encodingType="uint8">
<validValue name="UNKNOWN">0</validValue>
<validValue name="GOOD_TILL_CANCEL">1</validValue>
<validValue name="POST_ONLY">2</validValue>
<validValue name="IMMEDIATE_OR_CANCEL">3</validValue>
<validValue name="FILL_OR_KILL">4</validValue>
<validValue name="RPI">5</validValue>
<validValue name="NON_REPRESENTABLE">254</validValue>
</enum>
<enum name="SmpType" encodingType="uint8">
<validValue name="UNKNOWN">0</validValue>
<validValue name="CANCEL_TAKER">1</validValue>
<validValue name="CANCEL_MAKER">2</validValue>
<validValue name="CANCEL_BOTH">3</validValue>
<validValue name="NON_REPRESENTABLE">254</validValue>
</enum>
<enum name="MarketUnitType" encodingType="uint8">
<validValue name="UNKNOWN">0</validValue>
<validValue name="BASE_COIN">1</validValue>
<validValue name="QUOTE_COIN">2</validValue>
<validValue name="NON_REPRESENTABLE">254</validValue>
</enum>
<enum name="BoolEnum" encodingType="uint8">
<validValue name="FALSE">0</validValue>
<validValue name="TRUE">1</validValue>
<validValue name="NON_REPRESENTABLE">254</validValue>
</enum>
<composite name="ApiRequestHeader" description="API Request header">
<type name="reqId" primitiveType="char" length="64"/>
<type name="timestamp" primitiveType="uint64"/>
<type name="recvWindow" primitiveType="uint32"/>
<type name="referer" primitiveType="char" length="64"/>
</composite>
<composite name="ApiRespHeader" description="Response header">
<type name="reqId" primitiveType="char" length="64"/>
<type name="connId" primitiveType="char" length="64"/>
<type name="traceId" primitiveType="char" length="64"/>
<type name="timeNow" primitiveType="int64"/>
<type name="inTime" primitiveType="int64"/>
<type name="bapiLimit" primitiveType="int64"/>
<type name="bapiLimitStatus" primitiveType="int64"/>
<type name="bapiLimitResetTimestamp" primitiveType="int64"/>
</composite>
<composite name="CommonOrderRespData" description="Common order response data">
<type name="orderId" primitiveType="char" length="64"/>
<type name="orderLinkId" primitiveType="char" length="64"/>
</composite>
</types>
<message name="AuthReq" id="1" description="Authentication request">
<field name="reqId" id="1" type="String64"/>
<field name="apiKey" id="2" type="String64"/>
<field name="expires" id="3" type="uint64"/>
<field name="signature" id="4" type="String64"/>
</message>
<message name="AuthResp" id="2" description="Authentication response">
<field name="reqId" id="1" type="String64"/>
<field name="retCode" id="2" type="int32"/>
<field name="connId" id="3" type="String64"/>
<data name="retMsg" id="20" type="varString8"/>
</message>
<message name="PingReq" id="3" description="Ping request">
<field name="timestamp" id="1" type="uint64"/>
</message>
<message name="PongResp" id="4" description="Pong response">
<field name="timestamp" id="1" type="uint64"/>
<field name="pongTime" id="2" type="uint64"/>
</message>
<message name="CreateOrderReqV5" id="5" description="Create order request">
<field name="header" id="1" type="ApiRequestHeader"/>
<field name="category" id="2" type="CategoryType"/>
<field name="symbolId" id="3" type="int64"/>
<field name="side" id="4" type="SideType"/>
<field name="orderType" id="5" type="OrderType"/>
<field name="qty" id="6" type="Decimal64"/>
<field name="price" id="7" type="Decimal64"/>
<field name="orderLinkId" id="8" type="String64"/>
<field name="timeInForce" id="9" type="TimeInForceType"/>
<field name="positionIdx" id="10" type="PositionIdxType"/>
<field name="marketUnit" id="11" type="MarketUnitType"/>
<field name="isLeverage" id="12" type="BoolEnum"/>
<field name="reduceOnly" id="13" type="BoolEnum"/>
<field name="closeOnTrigger" id="14" type="BoolEnum"/>
<field name="mmp" id="15" type="BoolEnum"/>
<field name="smpType" id="16" type="SmpType"/>
</message>
<message name="CreateOrderRespV5" id="6" description="Create order response">
<field name="respHeader" id="1" type="ApiRespHeader"/>
<field name="retCode" id="2" type="int32"/>
<field name="result" id="3" type="CommonOrderRespData"/>
<data name="retMsg" id="20" type="varString8"/>
</message>
<message name="ReplaceOrderReqV5" id="7" description="Replace order request">
<field name="header" id="1" type="ApiRequestHeader"/>
<field name="category" id="2" type="CategoryType"/>
<field name="symbolId" id="3" type="int64"/>
<field name="orderId" id="4" type="String64"/>
<field name="orderLinkId" id="5" type="String64"/>
<field name="qty" id="6" type="Decimal64"/>
<field name="price" id="7" type="Decimal64"/>
</message>
<message name="ReplaceOrderRespV5" id="8" description="Replace order response">
<field name="respHeader" id="1" type="ApiRespHeader"/>
<field name="retCode" id="2" type="int32"/>
<field name="result" id="3" type="CommonOrderRespData"/>
<data name="retMsg" id="20" type="varString8"/>
</message>
<message name="CancelOrderReqV5" id="9" description="Cancel order request">
<field name="header" id="1" type="ApiRequestHeader"/>
<field name="category" id="2" type="CategoryType"/>
<field name="symbolId" id="3" type="int64"/>
<field name="orderId" id="4" type="String64"/>
<field name="orderLinkId" id="5" type="String64"/>
</message>
<message name="CancelOrderRespV5" id="10" description="Cancel order response">
<field name="respHeader" id="1" type="ApiRespHeader"/>
<field name="retCode" id="2" type="int32"/>
<field name="result" id="3" type="CommonOrderRespData"/>
<data name="retMsg" id="20" type="varString8"/>
</message>
<message name="BatchCreateOrderReqV5" id="11" description="Batch create order request">
<field name="header" id="1" type="ApiRequestHeader"/>
<field name="category" id="2" type="CategoryType"/>
<group name="request" id="200" dimensionType="groupSize16Encoding">
<field name="symbolId" id="1" type="int64"/>
<field name="side" id="2" type="SideType"/>
<field name="orderType" id="3" type="OrderType"/>
<field name="qty" id="4" type="Decimal64"/>
<field name="price" id="5" type="Decimal64"/>
<field name="orderLinkId" id="6" type="String64"/>
<field name="timeInForce" id="7" type="TimeInForceType"/>
<field name="positionIdx" id="8" type="PositionIdxType"/>
<field name="marketUnit" id="9" type="MarketUnitType"/>
<field name="isLeverage" id="10" type="BoolEnum"/>
<field name="reduceOnly" id="11" type="BoolEnum"/>
<field name="closeOnTrigger" id="12" type="BoolEnum"/>
<field name="mmp" id="13" type="BoolEnum"/>
<field name="smpType" id="14" type="SmpType"/>
</group>
</message>
<message name="BatchCreateOrderRespV5" id="12" description="Batch create order response">
<field name="respHeader" id="1" type="ApiRespHeader"/>
<field name="retCode" id="2" type="int32"/>
<group name="list" id="100" dimensionType="groupSize16Encoding">
<field name="code" id="1" type="int32"/>
<field name="category" id="2" type="CategoryType"/>
<field name="symbolId" id="3" type="int64"/>
<field name="orderId" id="4" type="String64"/>
<field name="orderLinkId" id="5" type="String64"/>
<data name="msg" id="20" type="varString8"/>
<data name="createAt" id="21" type="varString8"/>
</group>
<data name="retMsg" id="200" type="varString8"/>
</message>
<message name="BatchReplaceOrderReqV5" id="13" description="Batch replace order request">
<field name="header" id="1" type="ApiRequestHeader"/>
<field name="category" id="2" type="CategoryType"/>
<group name="request" id="200" dimensionType="groupSize16Encoding">
<field name="symbolId" id="1" type="int64"/>
<field name="orderId" id="2" type="String64"/>
<field name="orderLinkId" id="3" type="String64"/>
<field name="qty" id="4" type="Decimal64"/>
<field name="price" id="5" type="Decimal64"/>
</group>
</message>
<message name="BatchReplaceOrderRespV5" id="14" description="Batch replace order response">
<field name="respHeader" id="1" type="ApiRespHeader"/>
<field name="retCode" id="2" type="int32"/>
<group name="list" id="100" dimensionType="groupSize16Encoding">
<field name="code" id="1" type="int32"/>
<field name="category" id="2" type="CategoryType"/>
<field name="symbolId" id="3" type="int64"/>
<field name="orderId" id="4" type="String64"/>
<field name="orderLinkId" id="5" type="String64"/>
<data name="msg" id="20" type="varString8"/>
</group>
<data name="retMsg" id="200" type="varString8"/>
</message>
<message name="BatchCancelOrderReqV5" id="15" description="Batch cancel order request">
<field name="header" id="1" type="ApiRequestHeader"/>
<field name="category" id="2" type="CategoryType"/>
<group name="request" id="200" dimensionType="groupSize16Encoding">
<field name="symbolId" id="1" type="int64"/>
<field name="orderId" id="2" type="String64"/>
<field name="orderLinkId" id="3" type="String64"/>
</group>
</message>
<message name="BatchCancelOrderRespV5" id="16" description="Batch cancel order response">
<field name="respHeader" id="1" type="ApiRespHeader"/>
<field name="retCode" id="2" type="int32"/>
<group name="list" id="100" dimensionType="groupSize16Encoding">
<field name="code" id="1" type="int32"/>
<field name="category" id="2" type="CategoryType"/>
<field name="symbolId" id="3" type="int64"/>
<field name="orderId" id="4" type="String64"/>
<field name="orderLinkId" id="5" type="String64"/>
<data name="msg" id="20" type="varString8"/>
</group>
<data name="retMsg" id="200" type="varString8"/>
</message>
<message name="CommonErrResp" id="17" description="Common error response">
<field name="respHeader" id="1" type="ApiRespHeader"/>
<field name="retCode" id="2" type="int32"/>
<data name="retMsg" id="20" type="varString8"/>
</message>
</sbe:messageSchema>