API Reference

MarkPrice

Description

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

Request

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

Response

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

Mark price example:

{
    "channel": "MARK_PRICE",
    "localTs": 1736423655001,
    "instId": "BINANCE_PERP_BTC_USDT",
    "markPrice": "93476.2"
}
FieldTypeRemarks
channelString"MARK_PRICE"
instIdStringUnique identifier
markPriceStringMark price
localTsLongUpdate time