GroupDepth

Description

1.Interval: 100ms

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

Request

JSON

{
                    "event": "subscribe",
                    "arg": [{
                        "channel": "groupdepth",
                        "sym": "BINANCE_PERP_BTC_USDT"
                        }]
}

Field name	Type	Necessary	Remarks
event	String	Y	subscribe / unsubscribe
arg	Array	Y	Subscribe param. There can be no more than 50 instId parameters per subscribe.
> channel	String	Y	Channel name: groupdepth
> sym	String	Y	Unique identifier

Response

JSON

{
    "event": "SUBSCRIBE",
    "arg": [
        {
            "channel": "groupdepth",
            "sym": "OKX_PERP_BTC_USDT"
        },
        {
            "channel": "groupdepth",
            "sym": "BINANCE_SPOT_BTC_USDT"
        },
        {
            "channel": "groupdepth",
            "sym": "OKX_SPOT_BTC_USDT"
        },
        {
            "channel": "groupdepth",
            "sym": "BINANCE_PERP_BTC_USDT"
        }
    ],
    "code": 0,
    "message": "Success"
}

Field	Type	Remarks
event	String	subscribe / unsubscribe
code	String	Error Code
msg	String	Error Message
arg	Array	Subscribe param
> channel	String	Channel name: groupdepth
> sym	String	Unique identifier

group depth example:

JSON

{
    "arg": {
        "channel": "groupdepth",
        "sym": "BINANCE_PERP_BTC_USDT",
        "updatetype":"all"
    },
    "data": {
        "ts": 1764571807735,
        "seq": 9348681384522,
        "num": 5818843132,
        "bids": [
            [
                "93252.900000",
                "0.000000"
            ],
            [
                "93253.000000",
                "4.086000"
            ],
            [
                "93254.200000",
                "0.003000"
            ],
            [
                "93256.300000",
                "0.055000"
            ],
            [
                "93261.300000",
                "7.568000"
            ]
        ],
        "asks": [
            [
                "93261.400000",
                "1.434000"
            ],
            [
                "93271.700000",
                "0.008000"
            ]
        ]
    }
}

Field	Type	Remarks
channel	String	example: groupdepth
sym	String	Unique identifier
updatetype	String	all/update. Default is all. all : Full snapshot update : Incremental update
ts	String	Market data generation timestamp (milliseconds)
seq	String	Sequence number of the current message (used for ordered processing)
seqNum	String	Sequence number of the previous message (string; appears in incremental updates for continuity validation)
num	String	cumulative incremental sequence number for push messages.
Bids	String	Bid depth data list, with each element being [price, size].
> price	String	Price
> qty	String	Quantity
Asks	String	Ask depth data list, with each element being [price, size].
> price	String	Price
> qty	String	Quantity