WebSocket API

WebSocket is a new HTML5 protocol that enables full-duplex communication between client and server, allowing data to flow quickly in both directions. A simple handshake establishes the connection; after that, the server can proactively push messages to the client based on business rules. Benefits:

1. Very small header overhead during data transfer (about 2 bytes).
2. Both client and server can actively send data to each other.
3. No repeated TCP connection setup/teardown—saves bandwidth and server resources.

We strongly recommend developers use the WebSocket API to obtain market quotes and order book depth.

Native ws endpoint

• wss://contract.mexc.com/edge

Command details for data exchange

Send ping

{
  "method": "ping"
}

Server response

{
  "channel": "pong",
  "data": 1587453241453
}

Subscribe/unsubscribe command list (except personal/private commands, all others do not require WS auth).

If no ping is received from the client within 1 minute, the connection will be closed. Send a ping every 10–20 seconds.

Subscription filtering

Disable default pushes

{
  "subscribe": false,
  "method": "login",
  "param": {
    "apiKey": "mxU1TzSmRDW1o5AsE",
    "signature": "8c957a757ea31672eca05cb652d26bab7f46a41364adb714dda5475264aff120",
    "reqTime": "1611038237237"
  }
}

Only assets

{
  "method": "personal.filter",
  "param": {
    "filters": [
      {
        "filter": "asset"
      }
    ]
  }
}

Only ADL level

{
  "method": "personal.filter",
  "param": {
    "filters": [
      {
        "filter": "adl.level"
      }
    ]
  }
}

All fills only

{
  "method": "personal.filter",
  "param": {
    "filters": [
      {
        "filter": "order.deal",
        "rules": []
      }
    ]
  }
}

Or

{
  "method": "personal.filter",
  "param": {
    "filters": [
      {
        "filter": "order.deal"
      }
    ]
  }
}

Fills for a single contract only

{
  "method": "personal.filter",
  "param": {
    "filters": [
      {
        "filter": "order.deal",
        "rules": ["BTC_USDT"]
      }
    ]
  }
}

Mixed usage

{
  "method": "personal.filter",
  "param": {
    "filters": [
      {
        "filter": "order",
        "rules": ["BTC_USDT"]
      },
      {
        "filter": "order.deal",
        "rules": ["EOS_USDT", "ETH_USDT", "BTC_USDT"]
      },
      {
        "filter": "position",
        "rules": ["EOS_USDT", "BTC_USDT"]
      },
      {
        "filter": "asset"
      }
    ]
  }
}

After login, all personal data will be pushed by default: order (orders), order.deal (fills), position (positions), plan.order (plan orders), stop.order (TP/SL orders), stop.planorder (TP/SL plan orders), risk.limit (risk limits), adl.level (ADL level), asset (assets).

1. To cancel default pushes, add "subscribe": false to the login params (default is true).
2. After login, send the personal.filter event to filter what you need. To restore all pushes, send {"method":"personal.filter"} or {"method":"personal.filter","param":{"filters":[]}}.
3. Valid filter keys (fixed values; errors if incorrect): order, order.deal, position, plan.order, stop.order, stop.planorder, risk.limit, adl.level, asset.

asset and adl.level do not support per-symbol filtering; others can filter by a single contract.

Subsequent filter events overwrite previous ones.

Public channels

Tickers

Subscribe

{
  "method": "sub.tickers",
  "param": {}
}

If you need plaintext responses (same for other subs):

{
  "method": "sub.tickers",
  "param": {},
  "gzip": false
}

Unsubscribe

{
  "method": "unsub.tickers",
  "param": {}
}

Sample data

{
  "channel": "push.tickers",
  "data": [
    {
      "fairPrice": 183.01,
      "lastPrice": 183,
      "riseFallRate": -0.0708,
      "symbol": "BSV_USDT",
      "volume24": 200,
      "maxBidPrice": 7073.42,
      "minAskPrice": 6661.37
    },
    {
      "fairPrice": 220.22,
      "lastPrice": 220.4,
      "riseFallRate": -0.0686,
      "symbol": "BCH_USDT",
      "volume24": 200,
      "maxBidPrice": 7073.42,
      "minAskPrice": 6661.37
    }
  ]
}

Get latest price, best bid/ask, and 24h volume for all perpetual contracts. No login required. Pushes every 1s.

Response fields:

Field	Type	Description
symbol	string	Contract
timestamp	long	Trade time
lastPrice	decimal	Last price
volume24	decimal	24h volume (in contracts)
amount24	decimal	24h turnover (in currency)
riseFallRate	decimal	Change rate
fairPrice	decimal	Fair price
indexPrice	decimal	Index price
maxBidPrice	decimal	Max buy price
minAskPrice	decimal	Min sell price
lower24Price	decimal	24h low
high24Price	decimal	24h high

Get a single ticker

Subscribe

{
  "method": "sub.ticker",
  "param": {
    "symbol": "BTC_USDT"
  }
}

Unsubscribe

{
  "method": "unsub.ticker",
  "param": {
    "symbol": "BTC_USDT"
  }
}

Sample data

{
  "channel": "push.ticker",
  "data": {
    "ask1": 6866.5,
    "bid1": 6865,
    "contractId": 1,
    "fairPrice": 6867.4,
    "fundingRate": 0.0008,
    "high24Price": 7223.5,
    "indexPrice": 6861.6,
    "lastPrice": 6865.5,
    "lower24Price": 6756,
    "maxBidPrice": 7073.42,
    "minAskPrice": 6661.37,
    "riseFallRate": -0.0424,
    "riseFallValue": -304.5,
    "symbol": "BTC_USDT",
    "timestamp": 1587442022003,
    "holdVol": 2284742,
    "volume24": 164586129
  },
  "symbol": "BTC_USDT"
}

Get latest price, best bid/ask, and 24h volume for a given contract. No login required. Pushes every 1s when trades occur.

Response fields:

Field	Type	Description
symbol	string	Contract
timestamp	long	Trade time
lastPrice	decimal	Last price
bid1	decimal	Best bid
ask1	decimal	Best ask
holdVol	decimal	Open interest
fundingRate	decimal	Funding rate
riseFallRate	decimal	Change rate
riseFallValue	decimal	Change amount
volume24	decimal	24h volume (contracts)
amount24	decimal	24h turnover (currency)
fairPrice	decimal	Fair price
indexPrice	decimal	Index price
maxBidPrice	decimal	Max buy price
minAskPrice	decimal	Min sell price
lower24Price	decimal	24h low
high24Price	decimal	24h high

Deal

Subscribe

{
  "method": "sub.deal",
  "param": {
    "symbol": "BTC_USDT"
  }
}

Unsubscribe

{
  "method": "unsub.deal",
  "param": {
    "symbol": "BTC_USDT"
  }
}

Sample data

{
  "symbol": "BTC_USDT",
  "data": [
    {
      "p": 115309.8,
      "v": 55,
      "T": 2,
      "O": 3,
      "M": 1,
      "t": 1755487578276
    },
    {
      "p": 115309.8,
      "v": 11,
      "T": 1,
      "O": 3,
      "M": 1,
      "t": 1755487578275
    }
  ],
  "channel": "push.deal",
  "ts": 1755487578276
}

Receive recent trades. No login required. Pushed whenever trades occur. Trade stream enables aggregation by default; to disable, set compress=false in the subscription.

Response fields:

Field	Type	Description
p	decimal	Price
v	decimal	Quantity
T	int	Trade side: 1 buy, 2 sell
O	int	Open/close flag: 1 new position, 2 reduce position, 3 position unchanged. If O=1, v is the added position size
M	int	Self-trade: 1 yes, 2 no
t	long	Trade time

Order book depth

Subscribe

{
  "method": "sub.depth",
  "param": {
    "symbol": "BTC_USDT"
  }
}

Unsubscribe

{
  "method": "unsub.depth",
  "param": {
    "symbol": "BTC_USDT"
  }
}

Sample data

{
  "channel": "push.depth",
  "data": {
    "asks": [[6859.5, 3251, 1]],
    "bids": [],
    "version": 96801927
  },
  "symbol": "BTC_USDT",
  "ts": 1587442022003
}

Response fields:

Field	Type	Description
asks	List<Numeric[]>	Ask depth
bids	List<Numeric[]>	Bid depth
version	long	Version

Note: [411.8, 10, 1] → 411.8 is price，10 is the order numbers of the contract ,1 is the order quantity

Depth — specify minimum notional step

Subscribe

{ "method": "sub.depth.step", "param": { "symbol": "BTC_USDT", "step": "10" } }

Note: 10 means notional bucket size of 10; e.g., levels like 100010, 100020, 100030.

Unsubscribe

{
  "method": "unsub.depth.step",
  "param": { "symbol": "BTC_USDT", "step": "10" }
}

Sample data

{
  "channel": "push.depth.step",
  "data": {
    "askMarketLevelPrice": 111089.4,
    "asks": [
      [111090, 398676, 26],
      [111100, 410175, 8]
    ],
    "bidMarketLevelPrice": 111085.5,
    "bids": [
      [111080, 461204, 35],
      [111070, 386809, 3]
    ],
    "ct": 1760950364388,
    "version": 27883254360
  },
  "symbol": "BTC_USDT"
}

Response fields:

Field	Type	Description
asks	List<Numeric[]>	Ask depth
bids	List<Numeric[]>	Bid depth
askMarketLevelPrice	decimal	Highest willing ask
bidMarketLevelPrice	decimal	Highest willing bid
version	long	Version

Note: [111090,398676,26] → 111090 is price，398676 is the order numbers of the contract ,26 is the order quantity

K-line data

Subscribe

{
  "method": "sub.kline",
  "param": {
    "symbol": "BTC_USDT",
    "interval": "Min60"
  },
  "gzip": false
}

Unsubscribe

{
  "method": "unsub.kline",
  "param": {
    "symbol": "BTC_USDT"
  }
}

Sample data

{
  "channel": "push.kline",
  "data": {
    "a": 233.740269343644737245,
    "c": 6885,
    "h": 6910.5,
    "interval": "Min60",
    "l": 6885,
    "o": 6894.5,
    "q": 1611754,
    "symbol": "BTC_USDT",
    "t": 1587448800
  },
  "symbol": "BTC_USDT"
}

Receive K-line updates as they occur.

interval options: Min1, Min5, Min15, Min30, Min60, Hour4, Hour8, Day1, Week1, Month1

Response fields:

Field	Type	Description
symbol	string	Contract
interval	string	Interval: Min1, Min5, Min15, Min30, Min60, Hour4, Hour8, Day1, Week1, Month1
a	decimal	Total traded amount
q	decimal	Total traded volume
o	decimal	Open
c	decimal	Close
h	decimal	High
l	decimal	Low
v	decimal	Total volume
ro	decimal	Real open
rc	decimal	Real close
rh	decimal	Real high
rl	decimal	Real low
t	long	Trade time in seconds (window start)

Funding rate

Subscribe

{
  "method": "sub.funding.rate",
  "param": {
    "symbol": "BTC_USDT"
  },
  "gzip": false
}

Unsubscribe

{
  "method": "unsub.funding.rate",
  "param": {
    "symbol": "BTC_USDT"
  }
}

Sample data

{
  "channel": "push.funding.rate",
  "data": {
    "rate": 0.001,
    "symbol": "BTC_USDT"
  },
  "symbol": "BTC_USDT",
  "ts": 1587442022003
}

Get funding rate updates.

Response fields:

Field	Type	Description
symbol	string	Contract
fundingRate	decimal	Funding rate
nextSettleTime	long	Next settlement

Index price

Subscribe

For both linear and inverse contracts, use the same symbol (e.g., for inverse BTC_USD, use BTC_USDT when subscribing to index price).

{
  "method": "sub.index.price",
  "param": {
    "symbol": "BTC_USDT"
  },
  "gzip": false
}

Unsubscribe

{
  "method": "unsub.index.price",
  "param": {
    "symbol": "BTC_USDT"
  }
}

Sample data

{
  "channel": "push.index.price",
  "data": {
    "price": 0.001,
    "symbol": "BTC_USDT"
  },
  "symbol": "BTC_USDT",
  "ts": 1587442022003
}

Pushes once whenever the index price changes.

Response fields:

Field	Type	Description
symbol	string	Contract
price	decimal	Price

Fair price

Subscribe

{
  "method": "sub.fair.price",
  "param": {
    "symbol": "BTC_USDT"
  },
  "gzip": false
}

Unsubscribe

{
  "method": "unsub.fair.price",
  "param": {
    "symbol": "BTC_USDT"
  }
}

Sample data

{
  "channel": "push.fair.price",
  "data": {
    "price": 0.001,
    "symbol": "BTC_USDT"
  },
  "symbol": "BTC_USDT",
  "ts": 1587442022003
}

Response fields:

Field	Type	Description
symbol	string	Contract
price	decimal	Price

Contract metadata

Subscribe

{ "method": "sub.contract" }

Unsubscribe

{ "method": "unsub.contract" }

Sample data

{
  "channel": "push.contract",
  "data": {
    "amountScale": 4,
    "askLimitPriceRate": 0.2,
    "baseCoin": "CLO",
    "baseCoinName": "CLO",
    "bidLimitPriceRate": 0.2,
    "conceptPlate": [],
    "conceptPlateId": [],
    "contractSize": 10,
    "depthStepList": ["0.0001", "0.001", "0.01", "0.1"],
    "displayName": "CLO_USDT永续",
    "displayNameEn": "CLO_USDT PERPETUAL",
    "feeRateMode": "NORMAL",
    "futureType": 1,
    "indexOrigin": ["MEXC_FUTURE", "MEXC", "KUCOIN"],
    "initialMarginRate": 0.02,
    "isHidden": false,
    "isHot": false,
    "isNew": false,
    "liquidationFeeRate": 0.0002,
    "limitMaxVol": 9000,
    "maintenanceMarginRate": 0.01,
    "makerFeeRate": 0,
    "maxLeverage": 50,
    "maxNumOrders": [200, 50],
    "maxVol": 9000,
    "minLeverage": 1,
    "minVol": 1,
    "openingCountdownOption": 1,
    "openingTime": 1760440200000,
    "positionOpenType": 3,
    "priceCoefficientVariation": 0.4,
    "priceScale": 4,
    "priceUnit": 0.0001,
    "quoteCoin": "USDT",
    "quoteCoinName": "USDT",
    "riskBaseVol": 9000,
    "riskIncrImr": 0.005,
    "riskIncrMmr": 0.005,
    "riskIncrVol": 9000,
    "riskLevelLimit": 1,
    "riskLimitMode": "INCREASE",
    "riskLimitType": "BY_VOLUME",
    "riskLongShortSwitch": 0,
    "settleCoin": "USDT",
    "state": 0,
    "symbol": "CLO_USDT",
    "takerFeeRate": 0.0002,
    "triggerProtect": 0.1,
    "volScale": 0,
    "volUnit": 1
  },
  "symbol": "CLO_USDT",
  "ts": 1760942212002
}

Response fields:

Field	Type	Description
symbol	string	Contract, e.g., BTC_USDT
displayName	string	Display name, e.g., BTC_USDT 永续
displayNameEn	string	Display English name, e.g., BTC_USDT PERPETUAL
positionOpenType	int	Open mode: 1 both cross & isolated; 2 cross; 3 isolated
baseCoin	string	Base currency (e.g., BTC)
quoteCoin	string	Quote currency (e.g., USDT)
baseCoinName	string	Base currency name
quoteCoinName	string	Quote currency name
futureType	int	1 PERPETUAL, 2 DAILY
settleCoin	string	Settlement currency
contractSize	decimal	Contract size
minLeverage	int	Min leverage
maxLeverage	int	Max leverage
priceScale	int	Price decimals
volScale	int	Volume decimals
amountScale	int	Amount decimals
priceUnit	decimal	Min price tick
volUnit	decimal	Min volume step
minVol	decimal	Min order size (contracts)
maxVol	decimal	Max order size (contracts)
limitMaxVol	decimal	Max size for limit orders
bidLimitPriceRate	decimal	Order price limit—seller
askLimitPriceRate	decimal	Order price limit—buyer
takerFeeRate	decimal	Taker fee
makerFeeRate	decimal	Maker fee
maintenanceMarginRate	decimal	Maintenance margin rate
initialMarginRate	decimal	Initial margin rate
riskBaseVol	decimal	Base contracts for risk limit
riskIncrVol	decimal	Incremental contracts
riskIncrMmr	decimal	MMR increment
riskIncrImr	decimal	IMR increment
riskLevelLimit	decimal	Number of risk tiers
priceCoefficientVariation	decimal	Fair vs index price deviation coefficient
state	int	0 enabled, 1 deliver, 2 delivered, 3 delist, 4 paused
isNew	boolean	New contract tag
isHot	boolean	Hot contract tag
isHidden	boolean	Hidden contract
triggerProtect	decimal	Price protection threshold
riskLongShortSwitch	int	Separate long/short risk limits (0 off, 1 on)
riskBaseVolLong	decimal	Long base contracts
riskIncrVolLong	decimal	Long incremental contracts
riskBaseVolShort	decimal	Short base contracts
riskIncrVolShort	decimal	Short incremental contracts
openingCountdownOption	int	Opening countdown option
openingTime	long	Opening timestamp
liquidationFeeRate	decimal	Liquidation fee rate
tieredDealAmount	decimal	Tiered turnover amount
tieredEffectiveDay	int	Effective days
tieredExcludeZeroFee	boolean	Exclude zero-fee turnover? (false no, true yes)
tieredAppointContract	boolean	Specify contracts? (false no, true yes)
tieredExcludeContractId	boolean	Include/exclude contracts (false exclude, true include)

Event contracts

Subscribe

{ "method": "sub.event.contract" }

Unsubscribe

{ "method": "unsub.event.contract" }

Response fields:

Field	Type	Description
contractId	string	Contract ID
symbol	string	Contract, e.g., BTC_USDT
baseCoin	string	Base currency, e.g., BTC
quoteCoin	string	Quote currency, e.g., USDT
baseCoinName	string	Base currency name
quoteCoinName	string	Quote currency name
settleCoin	string	Settlement currency
baseCoinIconUrl	string	Base currency
baseCoinName	string	Base currency icon config
investMinAmount	decimal	Minimum investment
investMaxAmount	decimal	Maximum investment
amountScale	int	Quantity precision
payRateScale	int	Payout rate precision
indexPriceScale	int	Index price precision
availableScale	int	Availability precision

Private channels

Signature method:

Concatenate api_key and req_time, then HMAC-SHA256 with sec_key. api_key and sec_key are your ACCESS KEY and SECRET KEY.

Signature string

"mx0aBYs33eIilxBW5C1657186536762"

Login authentication

Example

{ "channel": "rs.login", "data": "success", "ts": "1587442022003" }

{
  "method": "login",
  "param": {
    "token": "token", // web & app must provide token to complete auth
    "apiKey": "apiKey", // for openapi; construct per openapi docs
    "reqTime": "reqTime", // for openapi; construct per openapi docs
    "signature": "signature" // for openapi; construct per openapi docs
  }
}

Response:

Success: none. Failure: return error info, channel = rs.error.

On success: channel = rs.login.

Order

Sample

{
  "channel": "push.personal.order",
  "data": {
    "category": 1,
    "createTime": 1610005069976,
    "dealAvgPrice": 0.731,
    "dealVol": 1,
    "errorCode": 0,
    "externalOid": "_m_95bc2b72d3784bce8f9efecbdef9fe35",
    "feeCurrency": "USDT",
    "leverage": 0,
    "makerFee": 0,
    "openType": 1,
    "orderId": "102067003631907840",
    "orderMargin": 0,
    "orderType": 5,
    "positionId": 1397818,
    "price": 0.707,
    "profit": -0.0005,
    "remainVol": 0,
    "side": 4,
    "state": 3,
    "symbol": "CRV_USDT",
    "takerFee": 0.00004386,
    "updateTime": 1610005069983,
    "usedMargin": 0,
    "version": 2,
    "vol": 1
  },
  "ts": 1610005069989
}

Request: channel = push.personal.order

Response fields:

Field	Type	Description
orderId	long	Order ID
symbol	string	Contract
positionId	long	Position ID
price	decimal	Order price
vol	decimal	Order quantity
leverage	long	Leverage
side	int	1 open long, 2 close short, 3 open short, 4 close long
category	int	1 limit, 2 forced liquidation custody, 3 custody close, 4 ADL
orderType	int	1 limit, 2 Post Only, 3 IOC, 4 FOK, 5 market, 6 market-to-limit
dealAvgPrice	decimal	Average fill price
dealVol	decimal	Filled quantity
orderMargin	decimal	Order margin
usedMargin	decimal	Used margin
takerFee	decimal	Taker fee
makerFee	decimal	Maker fee
profit	decimal	Close PnL
feeCurrency	string	Fee currency
openType	int	1 isolated, 2 cross
state	int	1 pending, 2 open, 3 filled, 4 canceled, 5 invalid
errorCode	int
externalOid	string	External order ID
createTime	long	Create time
updateTime	long	Update time
remainVol	decimal	Remaining quantity
positionMode	int	Position mode
reduceOnly	boolean	Reduce-only
bboTypeNum	int	BBO limit order subtype
makerFeeRate	decimal	Maker fee rate
takerFeeRate	decimal	Taker fee rate

Assets

Sample

{
  "channel": "push.personal.asset",
  "data": {
    "availableBalance": 0.7514236,
    "bonus": 0,
    "currency": "USDT",
    "frozenBalance": 0,
    "positionMargin": 0
  },
  "ts": 1610005070083
}

Request: channel = push.personal.asset

Response fields:

Field	Type	Description
currency	string	Currency
positionMargin	decimal	Position margin
frozenBalance	decimal	Frozen balance
availableBalance	decimal	Currently available balance
bonus	decimal	Trial bonus

Position

Sample

{
  "channel": "push.personal.position",
  "data": {
    "autoAddIm": false,
    "closeAvgPrice": 0.731,
    "closeVol": 1,
    "frozenVol": 0,
    "holdAvgPrice": 0.736,
    "holdFee": 0,
    "holdVol": 0,
    "im": 0,
    "leverage": 15,
    "liquidatePrice": 0,
    "oim": 0,
    "openAvgPrice": 0.736,
    "openType": 1,
    "positionId": 1397818,
    "positionType": 1,
    "realised": -0.0005,
    "state": 3,
    "symbol": "CRV_USDT"
  },
  "ts": 1610005070157
}

Request: channel = push.personal.position

Response fields:

Field	Type	Description
positionId	long	Position ID
symbol	string	Contract
holdVol	decimal	Position size
positionType	int	1 long, 2 short
openType	int	1 isolated, 2 cross
state	int	1 holding, 2 system custody, 3 closed
frozenVol	decimal	Frozen quantity
closeVol	decimal	Closed quantity
holdAvgPrice	decimal	Position average price
holdAvgPriceFullyScale	string	Full-precision position avg price
closeAvgPrice	decimal	Close average price
openAvgPrice	decimal	Open average price
openAvgPriceFullyScale	string	Full-precision open avg price
liquidatePrice	decimal	Liquidation price (isolated)
oim	decimal	Original initial margin
adlLevel	int	ADL level
im	decimal	Initial margin (adjustable in isolated to tune liq price)
holdFee	decimal	Funding fee (positive received, negative paid)
realised	decimal	Realized PnL
leverage	int	Leverage
autoAddIm	boolean	Auto-add margin
pnl	decimal	Unrealized PnL
marginRatio	decimal	Margin ratio
newOpenAvgPrice	decimal	Open average price
newCloseAvgPrice	decimal	Close average price
closeProfitLoss	decimal	Close PnL
fee	decimal	Fee
deductFeeList	array	Deduction info
makerFeeRate	decimal	Maker fee rate
takerFeeRate	decimal	Taker fee rate
createTime	long	Create time
updateTime	long	Update time
version	long	Version

Deduction info

Request: none

Response fields:

Field	Type	Description
currency	string	Deduction currency
deductFee	decimal	Fee in deduction currency
convertSettleFee	decimal	Fee converted to settlement currency

Plan orders

Request: channel = push.personal.plan.order

Response fields:

Field	Type	Description
id	long	Order ID
symbol	string	Contract
leverage	int	Leverage
side	int	1 open long, 2 close short, 3 open short, 4 close long
triggerPrice	decimal	Trigger price
price	decimal	Execution price
vol	decimal	Quantity
openType	int	1 isolated, 2 cross
triggerType	int	1 ≥, 2 ≤
state	int	1 untriggered, 2 canceled, 3 executed, 4 expired, 5 execution failed
executeCycle	int	Execution cycle (hours)
trend	int	Reference price: 1 last, 2 fair, 3 index
errorCode	int	0 if normal
orderId	long	Order ID after execution
orderType	int	1 limit, 2 Post Only, 3 IOC, 4 FOK, 5 market
marketOrderLevel	int	Custom level for market orders
positionMode	int	0 historical none, 2 one-way, 1 hedge
lossTrend	int	SL reference: 1 last, 2 fair, 3 index
profitTrend	int	TP reference: 1 last, 2 fair, 3 index
stopLossPrice	decimal	SL price
takeProfitPrice	decimal	TP price
reduceOnly	boolean	Reduce-only
createTime	long	Create time
updateTime	long	Update time

Risk limit

Request: channel = push.personal.risk.limit

Response fields:

Field	Type	Description
symbol	string	Contract
positionType	int	1 long, 2 short
riskSource	int	0 other, 1 liquidation service
level	int	Current risk tier
maxVol	decimal	Max position size
maxLeverage	int	Max leverage
mmr	decimal	Maintenance margin rate
imr	decimal	Initial margin rate
leverage	int	Current leverage
openType	int	Margin mode, default isolated
limitBySys	boolean	Limited by system
maxVolView	decimal	Front-end slider helper (independent of lev)

TP/SL plan orders

Request: channel = push.personal.stop.planorder

Response fields:

Field	Type	Description
id	long	Primary ID
orderId	long	Order ID
symbol	string	Contract
positionId	long	Position ID
lossTrend	int	SL reference type
profitTrend	int	TP reference type
stopLossPrice	decimal	SL price
takeProfitPrice	decimal	TP price
state	int	State
triggerSide	int	Trigger direction: 1 TP, 2 SL
positionType	int	Position type
vol	decimal	Quantity
takeProfitVol	decimal	TP quantity
stopLossVol	decimal	SL quantity
realityVol	decimal	Actual placed quantity
placeOrderId	long	Actual placed order ID
version	int	Version
isFinished	int	Completed
profitLossVolType	string	TP/SL qty type (SAME / SEPARATE)
volType	int	1 staged TP/SL, 2 position TP/SL
takeProfitReverse	int	TP reverse: 1 yes, 2 no
stopLossReverse	int	SL reverse: 1 yes, 2 no
closeTryTimes	int	Close retry count
reverseTryTimes	int	Reverse retry count
reverseErrorCode	int	Reverse open error code (0 default)
stopLossType	int	0 market SL, 1 limit SL
stopLossOrderPrice	decimal	Limit SL price
createTime	long	Create time
updateTime	long	Update time

Trailing orders

Request: channel = push.personal.track.order

Response fields:

Field	Type	Description
id	long	Primary ID
symbol	string	Contract
leverage	int	Leverage
side	int	1 open long, 2 close short, 3 open short, 4 close long
vol	decimal	Quantity
openType	int	1 isolated, 2 cross
trend	int	Reference price (1 last, 2 fair, 3 index)
activePrice	decimal	Activation price
markPrice	decimal	Reference price after activation (highest/lowest)
backType	int	Callback type (1 percentage, 2 absolute)
backValue	decimal	Callback value
triggerPrice	decimal	Trigger price (updates with reference)
triggerType	int	Trigger condition
orderId	long	Order ID after triggering
errorCode	int	Error code if trigger failed
state	int	0 not active, 1 active, 2 success, 3 failed, 4 canceled
positionMode	int	Position mode
reduceOnly	boolean	Reduce-only
createTime	long	Create time
updateTime	long	Update time

TP/SL prices

Request: channel = push.personal.stop.order

Response fields:

Field	Type	Description
symbol	string	Contract
orderId	long	Order ID
lossTrend	int	SL reference type
profitTrend	int	TP reference type
stopLossPrice	decimal	SL price
takeProfitPrice	decimal	TP price

Fill details

Request: channel = push.personal.order.deal

Response fields:

Field	Type	Description
id	long	Fill ID
symbol	string	Contract
side	int	1 open long, 2 close short, 3 open short, 4 close long
vol	decimal	Quantity
price	decimal	Price
feeCurrency	string	Fee currency
fee	decimal	One-side fee (positive = paid by user, negative = received by user)
timestamp	long	Fill time
profit	decimal	PnL
isTaker	boolean	Taker?
category	int	Order category
orderId	long	Order ID
isSelf	boolean	Self-trade?
externalOid	string	External order ID
positionMode	int	Position mode
reduceOnly	boolean	Reduce-only
opponentUid	long	Counterparty UID

Chase order failure

Request: channel = push.personal.order.chase

Response fields:

Field	Type	Description
ec	int	Error code
s	string	Contract

Liquidation risk change

Request: channel = push.personal.liquidate.risk

Response fields:

Field	Type	Description
symbol	string	Contract
positionId	long	Position ID
liquidatePrice	decimal	Liq price
marginRatio	decimal	Margin ratio
adlLevel	int	ADL level

Leverage mode change

Request: channel = push.personal.leverage.mode

Response fields:

Field	Type	Description
lm	int	Leverage mode

Position mode change

Request: channel = push.personal.position.mode

Response fields:

Field	Type	Description
positionMode	int	Position mode (1 hedge, 2 one-way)

Close-all failure

Request: channel = push.personal.position.closeall.fail

Response: No body; channel message only.

Reverse position

Request: channel = push.personal.reverse.position

Response fields:

Field	Type	Description
contractId	int	Contract ID
positionId	long	Position ID
state	int	State
errorCode	int	Error code

Trial bonus notification

Request: channel = push.personal.bonus

Response fields:

Field	Type	Description
c	string	Currency
b	decimal	Trial bonus amount
be	long	Trial bonus expiry time
g	boolean	Whether trial bonus granted
ret	long	Most recent expiry time
rea	decimal	Most recent expiring amount

User notifications — liquidation warning/notice

Request: channel = push.personal.generic.notify

Response fields:

Field	Type	Description
type	int	Notification type (1 liquidation)
param	object	Notification parameters

Notification params (for liquidation types)

Field	Type	Description
notifyType	int	1 liquidation, 2 liquidation warning
openType	int	1 isolated, 2 cross
dn	string	Display name
dne	string	Display name (EN)
multiAssets	boolean	Multi-asset mode enabled?
marginRate	decimal	Margin ratio

Event contract positions

Request: channel = push.personal.event.contract.position

Response fields:

Field	Type	Description
positionId	long	Position ID
symbol	string	Contract
side	string	Side
payRate	decimal	Bonus pay rate
amount	decimal	Order amount
openPrice	decimal	Open price
closePrice	decimal	Close price
rewardAmount	decimal	Reward amount
rewardAmountUsdt	decimal	Reward amount in USDT
state	string	State
closeResult	string	Close result
createTime	long	Create time
closeTime	long	Close time
pnlAmount	decimal	Total PnL

How to maintain depth

Example: subscribe to trades

{
  "method": "sub.deal",
  "param": {
    "symbol": "BTC_USDT"
  }
}

Subscription success

{ "channel": "rs.sub.deal", "data": "success", "ts": "1587442022003" }

Subscription failure

{
  "channel": "rs.error",
  "data": "Contract does not exist!",
  "ts": "1587442022003"
}

Position mode

Sample

{
  "channel": "push.personal.position.mode",
  "data": {
    "positionMode": 1
  },
  "ts": 1610005070157
}

Request: channel = push.personal.position.mode

Response fields:

Field	Type	Description
positionMode	int	Position mode, 1 hedge, 2 one-way

How to maintain incremental depth:

1. Fetch full depth via https://contract.mexc.com/api/v1/contract/depth/BTC_USDT and store the current version.
2. Subscribe to WS depth updates. Upon receiving an update with version > current version, for the same price level, the later update overwrites the earlier one.
3. Fetch the latest 1000 depth snapshots via https://contract.mexc.com/api/v1/contract/depth_commits/BTC_USDT/1000.
4. In your cached depth, discard entries at the same price where version < the snapshot’s versions.
5. Apply the snapshot to your local cache, then continue processing WS events from there.
6. Each new event’s version must equal the previous event’s version + 1. If versions are not continuous or packets were lost, re-initialize from step 3.
7. The quantity in each event is the absolute order size at that price, not a delta.
8. A quantity of zero at a price means that level should be removed.

On successful subscription events:

channel will be rs. + the subscribed method, and data will be "success".