MEXC Futures API

https://www.mexc.com/api-docs/futures/
Admin
MEXC Futures API is a comprehensive REST and WebSocket API documentation for trading futures...
Tokens:120,226
Snippets:785
Trust Score:5.8
Update:1 day ago
Show doc for...
Tokens:
Raw
### K-line data sample response

Source: https://www.mexc.com/api-docs/futures/websocket-api/k-line-data

Example of a K-line update pushed to the client. The 't' field is the trade time in seconds (window start).

```json
{
  "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"
}
```

--------------------------------

### Fair price push data sample

Source: https://www.mexc.com/api-docs/futures/websocket-api/fair-price

Example of a push message received on the 'push.fair.price' channel. Contains the contract symbol and the fair price, along with a timestamp.

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

--------------------------------

### GET /api/v1/private/account/feeDeductConfigs

Source: https://www.mexc.com/api-docs/futures/account-and-trading-endpoints/deduction-configuration

Retrieves the fee deduction configuration, including the deduction coin, settlement coin, and discount ratio for each entry.

```APIDOC
## GET /api/v1/private/account/feeDeductConfigs

### Description
Retrieves the fee deduction configuration, including the deduction coin, settlement coin, and discount ratio for each entry.

### Method
GET

### Endpoint
/api/v1/private/account/feeDeductConfigs

### Parameters
None

### Response
#### Success Response (200)
- **deductCoin** (string) - Deduction coin
- **settleCoin** (string) - Settlement coin
- **discountRatio** (decimal) - Discount ratio

#### Response Example
{
  "success": true,
  "code": 0,
  "data": [
    {
      "deductCoin": "MX",
      "settleCoin": "USDT",
      "discountRatio": 0.8
    },
    {
      "deductCoin": "MXPOINT",
      "settleCoin": "USDT",
      "discountRatio": 1
    }
  ]
}
```

--------------------------------

### Sample funding rate data push

Source: https://www.mexc.com/api-docs/futures/websocket-api/funding-rate

Example of a funding rate update push. The 'channel' is 'push.funding.rate', and the 'data' object contains the 'rate' and 'symbol'. The 'ts' field is a timestamp.

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

--------------------------------

### GET /api/v1/private/account/asset/{currency}

Source: https://www.mexc.com/api-docs/futures/account-and-trading-endpoints/get-single-currency-asset-information

Retrieves asset information for a single currency. The currency is specified as a path parameter. The response contains detailed balance and margin data.

```APIDOC
## GET /api/v1/private/account/asset/{currency}

### Description
Retrieves detailed asset information for a single currency in the futures account, including balances, margins, and equity.

### Method
GET

### Endpoint
/api/v1/private/account/asset/{currency}

### Parameters
#### Path Parameters
- **currency** (string) - Required - Currency

### Response
#### Success Response (200)
- **currency** (string) - Currency
- **positionMargin** (decimal) - Position margin
- **frozenBalance** (decimal) - Frozen balance
- **availableBalance** (decimal) - Currently available balance
- **cashBalance** (decimal) - Withdrawable balance
- **equity** (decimal) - Total equity
- **unrealized** (decimal) - Unrealized PnL
- **bonus** (decimal) - Trial bonus
- **bonusExpireTime** (long) - Trial bonus expiration time (ms)
- **availableCash** (decimal) - Transferable amount
- **availableOpen** (decimal) - Usable amount
- **debtAmount** (decimal) - Debt amount
- **contributeMarginAmount** (decimal) - Contributed effective margin
- **vcoinId** (string) - Currency ID

#### Response Example
{
  "success": true,
  "code": 0,
  "data": {
    "currency": "MX",
    "positionMargin": 0,
    "availableBalance": 0.99647149597724856,
    "cashBalance": 0.99647149,
    "frozenBalance": 0,
    "equity": 0.99647149,
    "unrealized": 0,
    "bonus": 0,
    "availableCash": 0.99647149597724856,
    "availableOpen": 0.99647149597724856,
    "debtAmount": 0,
    "contributeMarginAmount": 0,
    "vcoinId": "8c1e92655f9a4064808ce03ec1a48d38"
  }
}
```

--------------------------------

### Sample ticker push data

Source: https://www.mexc.com/api-docs/futures/websocket-api/get-a-single-ticker

Example of the push.ticker response data containing latest price, best bid/ask, 24h volume, funding rate, and other market data for the subscribed contract.

```json
{
  "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"
}
```

--------------------------------

### POST /api/v1/private/order/create

Source: https://www.mexc.com/api-docs/futures/account-and-trading-endpoints/place-order

Places a new futures order. Requires the 'Order Placing' permission and is rate limited to 4 times per 2 seconds.

```APIDOC
## POST /api/v1/private/order/create

### Description
Places a new futures order. Requires the 'Order Placing' permission and is rate limited to 4 times per 2 seconds.

### Method
POST

### Endpoint
/api/v1/private/order/create

### Parameters
#### Request Body
- **symbol** (string) - Required - Contract
- **price** (decimal) - Required - Price
- **vol** (decimal) - Required - Quantity
- **leverage** (int) - Optional - Leverage, must be provided when opening a position
- **side** (int) - Required - Order direction 1 open long, 2 close short, 3 open short, 4 close long
- **type** (int) - Required - Order type,1: limit,2: Post Only (maker only),3: IOC,4: FOK,5: market
- **openType** (int) - Required - Open type,1: isolated,2: cross
- **externalOid** (string) - Optional - External order id
- **positionId** (int) - Optional - Position id
- **stopLossPrice** (decimal) - Optional - Stop-loss price
- **takeProfitPrice** (decimal) - Optional - Take-profit price
- **lossTrend** (int) - Optional - Stop-loss price type;1: latest price (default);2: fair price;3: index price
- **profitTrend** (int) - Optional - Take-profit price type;1: latest price (default);2: fair price;3: index price
- **priceProtect** (int) - Optional - Conditional order trigger protection: "1","0", default "0" disabled. Required only for plan orders/TP-SL orders
- **positionMode** (int) - Optional - Position mode. Default Hedge Mode; 1: Hedge Mode; 2: One-way Mode
- **reduceOnly** (boolean) - Optional - Reduce-only, only applicable in one-way mode
- **marketCeiling** (boolean) - Optional - 100% market open
- **flashClose** (boolean) - Optional - Flash close
- **bboTypeNum** (int) - Optional - Limit order type - BBO type; 0: not BBO;1: opposite-1;2: opposite-5;3: same-side-1;4: same-side-5; When using a BBO order, the externalOid parameter is not supported
- **stpMode** (number) - Optional - Self-trade prevention mode: 0 no action; 1 cancel both taker and maker orders; 2 cancel maker orders only; 3 cancel taker orders only

### Response
#### Success Response (200)
On success, `success` = true and `data` is an object containing `orderId` (string) and `ts` (Unix millisecond timestamp of the server response); on failure, `success` = false and `data` = null

#### Response Example
{
  "success": true,
  "code": 0,
  "data": {
    "orderId": "739113577038255616",
    "ts": 1761888808839
  }
}
```

--------------------------------

### GET /api/v1/contract/kline/fair_price/{symbol}

Source: https://www.mexc.com/api-docs/futures/market-endpoints/get-fair-price-candles

Fetches fair price candlestick data for a specified contract symbol. Supports optional interval, start, and end time parameters. Returns arrays of OHLCV data and related fields.

```APIDOC
## GET /api/v1/contract/kline/fair_price/{symbol}

### Description
Retrieves fair price candlestick data for a specified contract symbol. Supports optional interval, start, and end time parameters. Returns arrays of OHLCV data and related fields.

### Method
GET

### Endpoint
/api/v1/contract/kline/fair_price/{symbol}

### Parameters
#### Path Parameters
- **symbol** (string) - Required - Contract symbol

#### Query Parameters
- **interval** (string) - Optional - Interval: Min1, Min5, Min15, Min30, Min60, Hour4, Hour8, Day1, Week1, Month1. Default is Min1 if omitted
- **start** (long) - Optional - Unix second timestamp
- **end** (long) - Optional - Unix second timestamp

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful
- **code** (integer) - Response code
- **data** (object) - Contains arrays of candle data
  - **time** (array of long) - Time window timestamps
  - **open** (array of double) - Open prices
  - **close** (array of double) - Close prices
  - **high** (array of double) - High prices
  - **low** (array of double) - Low prices
  - **vol** (array of double) - Volume
  - **amount** (array of double) - Amount
  - **realOpen** (array of double) - Real open prices
  - **realClose** (array of double) - Real close prices
  - **realHigh** (array of double) - Real high prices
  - **realLow** (array of double) - Real low prices

#### Response Example
```json
{
    "success": true,
    "code": 0,
    "data": {
        "time": [
            1761876000,
            1761876900,
            1761877800,
            1761878700,
            1761879600
        ],
        "open": [
            109573.9,
            109003.9,
            109304.4,
            108726.1,
            108794.9
        ],
        "close": [
            109003.9,
            109304.4,
            108726.1,
            108794.9,
            108629.1
        ],
        "high": [
            109631.6,
            109421.8,
            109353.0,
            108904.4,
            108810.6
        ],
        "low": [
            108960.4,
            109003.9,
            108681.1,
            108500.3,
            108555.6
        ],
        "vol": [
            0.0,
            0.0,
            0.0,
            0.0,
            0.0
        ],
        "amount": [
            0.0,
            0.0,
            0.0,
            0.0,
            0.0
        ],
        "realOpen": [
            109003.9,
            109304.4,
            108726.1,
            108794.9,
            108629.1
        ],
        "realClose": [
            109003.9,
            109304.4,
            108726.1,
            108794.9,
            108629.1
        ],
        "realHigh": [
            109003.9,
            109304.4,
            108726.1,
            108794.9,
            108629.1
        ],
        "realLow": [
            109003.9,
            109304.4,
            108726.1,
            108794.9,
            108629.1
        ]
    }
}
```

### Notes
- The maximum number of data points per request is 2000. If your chosen start/end time and granularity exceed this limit, only 2000 data points will be returned. To obtain fine-grained data over a larger time span, make multiple requests with segmented time ranges.
- If only the start time is provided, data from the start time to the current system time is returned. If only the end time is provided, the 2000 data points closest to the end time are returned. If neither is provided, the 2000 most recent data points relative to the current system time are returned.

### Rate Limit
20 times / 2 seconds
```

--------------------------------

### Sample depth data push

Source: https://www.mexc.com/api-docs/futures/websocket-api/depth-specify-minimum-notional-step

Example of a depth data push received after subscribing. Updates are pushed every 200 ms. The 'asks' and 'bids' arrays contain [price, order numbers, order quantity] tuples.

```json
{
  "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"
}
```

--------------------------------

### GET /api/v1/contract/kline/{symbol}

Source: https://www.mexc.com/api-docs/futures/market-endpoints/get-candlestick-data

Fetches candlestick data for a specified contract symbol. Supports optional interval, start, and end time parameters. Returns arrays of open, close, high, low, volume, and other data points.

```APIDOC
## GET /api/v1/contract/kline/{symbol}

### Description
Retrieves candlestick (K-line) data for a specified contract symbol. Supports configurable intervals and time ranges.

### Method
GET

### Endpoint
/api/v1/contract/kline/{symbol}

### Parameters
#### Path Parameters
- **symbol** (string) - Required - Contract symbol

#### Query Parameters
- **interval** (string) - Optional - Interval: Min1, Min5, Min15, Min30, Min60, Hour4, Hour8, Day1, Week1, Month1. Default is Min1 if omitted
- **start** (long) - Optional - Unix second timestamp
- **end** (long) - Optional - Unix second timestamp

### Request Example
GET /api/v1/contract/kline/BTC_USDT?interval=Min15&start=1761876000&end=1761879600

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful
- **code** (integer) - Response code
- **data** (object) - Contains arrays of candlestick data
  - **time** (array of long) - Time window timestamps
  - **open** (array of double) - Open prices
  - **close** (array of double) - Close prices
  - **high** (array of double) - High prices
  - **low** (array of double) - Low prices
  - **vol** (array of double) - Volume
  - **amount** (array of double) - Amount
  - **realOpen** (array of double) - Real open prices
  - **realClose** (array of double) - Real close prices
  - **realHigh** (array of double) - Real high prices
  - **realLow** (array of double) - Real low prices

#### Response Example
{
    "success": true,
    "code": 0,
    "data": {
        "time": [
            1761876000,
            1761876900,
            1761877800,
            1761878700,
            1761879600
        ],
        "open": [
            109573.9,
            109006.4,
            109301.5,
            108725.9,
            108794.7
        ],
        "close": [
            109006.4,
            109301.5,
            108725.9,
            108794.7,
            108669.9
        ],
        "high": [
            109628.1,
            109426.2,
            109350.2,
            108913.8,
            108815.1
        ],
        "low": [
            108953.3,
            109006.4,
            108666.2,
            108498.5,
            108649.0
        ],
        "vol": [
            5587051.0,
            5739575.0,
            5945477.0,
            5863529.0,
            1668892.0
        ],
        "amount": [
            6.106243567181E7,
            6.270099147368E7,
            6.47966331717E7,
            6.374986900458E7,
            1.814907510911E7
        ],
        "realOpen": [
            109574.0,
            109010.0,
            109301.4,
            108726.0,
            108794.8
        ],
        "realClose": [
            109006.4,
            109301.5,
            108725.9,
            108794.7,
            108669.9
        ],
        "realHigh": [
            109628.1,
            109426.2,
            109350.2,
            108913.8,
            108815.1
        ],
        "realLow": [
            108953.3,
            109010.0,
            108666.2,
            108498.5,
            108649.0
        ]
    }
}

### Notes
- The maximum number of data points per request is 2000. If the chosen start/end time and granularity exceed this limit, only 2000 data points will be returned. To obtain fine-grained data over a larger time span, make multiple requests with segmented time ranges.
- If only the start time is provided, data from the start time to the current system time is returned. If only the end time is provided, the 2000 data points closest to the end time are returned. If neither is provided, the 2000 most recent data points relative to the current system time are returned.

### Rate Limit
20 times / 2 seconds
```

--------------------------------

### GET /api/v1/private/account/config/contractFeeDiscountConfig

Source: https://www.mexc.com/api-docs/futures/account-and-trading-endpoints/query-all-spot-discount-configuration-information

Retrieves all spot discount configuration information. Requires the View Account Details permission and has a rate limit of 20 times per 2 seconds. No request parameters are required.

```APIDOC
## [GET] /api/v1/private/account/config/contractFeeDiscountConfig

### Description
Retrieves all spot discount configuration information for the futures account.

### Method
GET

### Endpoint
/api/v1/private/account/config/contractFeeDiscountConfig

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
No request body required.

### Response
#### Success Response (200)
- **currency** (string) - Deduction currency
- **state** (string) - Status: ENABLED, DISABLED
- **discountConfig** (string) - Discount configuration, JSON: `[{ "level":1, "volMin":0, "volMax":12, "day":7, "discount":0.8 }]`
- **blackContractIdSet** (list) - List of contract IDs excluded from discounts

#### Response Example
{
  "success": true,
  "code": 200,
  "message": "success",
  "data": [
    {
      "id": 1,
      "currency": "MX",
      "state": "ENABLED",
      "discountConfig": "[{\"day\":1,\"discount\":0.5,\"level\":1,\"volMax\":2147483647,\"volMin\":500}]",
      "ineffectiveDiscountConfig": "",
      "operator": "",
      "createTime": 1699775818000,
      "updateTime": 1732982217000,
      "enabled": true
    }
  ]
}
```

--------------------------------

### GET /api/v1/contract/ping

Source: https://www.mexc.com/api-docs/futures/market-endpoints/get-server-time

Retrieves the current server time. This endpoint requires no parameters and returns the server time in milliseconds.

```APIDOC
## [GET] /api/v1/contract/ping

### Description
Retrieves the current server time. This endpoint requires no parameters and returns the server time in milliseconds.

### Method
GET

### Endpoint
/api/v1/contract/ping

### Parameters
None

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **code** (integer) - Response code, 0 for success.
- **data** (integer) - Server time in milliseconds.

#### Response Example
{
    "success": true,
    "code": 0,
    "data": 1761875313209
}
```

--------------------------------

### POST /api/v1/private/planorder/place/v2

Source: https://www.mexc.com/api-docs/futures/account-and-trading-endpoints/place-plan-order

Places a plan order on the futures exchange. Requires the 'Order Placing' permission and is rate-limited to 4 requests per 2 seconds. The request body includes contract symbol, quantity, leverage, side, open type, trigger price, trigger type, execution cycle, order type, and trend, along with optional parameters for price protection, position mode, stop-loss/take-profit, and reduce-only.

```APIDOC
## [POST] /api/v1/private/planorder/place/v2

### Description
Places a plan order on the futures exchange. Requires the 'Order Placing' permission and is rate-limited to 4 requests per 2 seconds.

### Method
POST

### Endpoint
/api/v1/private/planorder/place/v2

### Parameters
#### Request Body
- **symbol** (string) - Required - Contract
- **price** (decimal) - Optional - Execution price; not required for market
- **vol** (decimal) - Required - Quantity
- **leverage** (int) - Required - Leverage, required when opening
- **side** (int) - Required - Order direction, 1: open long, 2: close short, 3: open short, 4: close long
- **openType** (int) - Required - Open type, 1: isolated, 2: cross
- **triggerPrice** (decimal) - Required - Trigger price
- **triggerType** (int) - Required - Trigger type, 1: greater than or equal to, 2: less than or equal to
- **executeCycle** (int) - Required - Execution cycle, 1: 24 hours, 2: 7 days
- **orderType** (int) - Required - Order type, 1: limit, 2: Post Only (maker only), 3: IOC, 4: FOK, 5: market
- **trend** (int) - Required - Trigger price type, 1: latest price, 2: fair price, 3: index price
- **priceProtect** (int) - Optional - Conditional order trigger protection: "1", "0", default "0" disabled. Required only for plan orders/TP-SL orders
- **positionMode** (int) - Optional - User-set position mode. Default 0: no record (historical orders); 1: Hedge Mode; 2: One-way Mode
- **lossTrend** (int) - Optional - Stop-loss reference price type 1 latest price 2 fair price 3 index price
- **profitTrend** (int) - Optional - Take-profit reference price type 1 latest price 2 fair price 3 index price
- **stopLossPrice** (decimal) - Optional - Stop-loss price
- **takeProfitPrice** (decimal) - Optional - Take-profit price
- **reduceOnly** (boolean) - Optional - Reduce-only

### Request Example
{
  "symbol": "BTCUSDT",
  "price": 50000,
  "vol": 1,
  "leverage": 10,
  "side": 1,
  "openType": 1,
  "triggerPrice": 51000,
  "triggerType": 1,
  "executeCycle": 1,
  "orderType": 1,
  "trend": 1
}

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful
- **code** (int) - Response code, 0 for success
- **data** (string) - Order ID on success; null on failure

#### Response Example
{
  "success": true,
  "code": 0,
  "data": "739206374277809664"
}
```

--------------------------------

### GET /api/v1/contract/risk_reverse/history

Source: https://www.mexc.com/api-docs/futures/market-endpoints/get-insurance-fund-balance-history

Fetches the insurance fund balance history for a specified contract symbol. Supports pagination via page_num and page_size parameters.

```APIDOC
## GET /api/v1/contract/risk_reverse/history

### Description
Retrieves the historical balance of the insurance fund for a specified futures contract.

### Method
GET

### Endpoint
/api/v1/contract/risk_reverse/history

### Parameters
#### Query Parameters
- **symbol** (string) - Required - Contract symbol
- **page_num** (int) - Required - Current page, default 1
- **page_size** (int) - Required - Page size, default 20, max 100

### Response
#### Success Response (200)
- **pageSize** (int) - Page size
- **totalCount** (int) - Total count
- **totalPage** (int) - Total pages
- **currentPage** (int) - Current page
- **resultList** (list) - Result set
- **symbol** (string) - Contract
- **currency** (string) - Settlement coin
- **available** (decimal) - Balance
- **snapshotTime** (long) - Snapshot time

#### Response Example
{
    "success": true,
    "code": 0,
    "data": {
        "pageSize": 3,
        "totalCount": 42,
        "totalPage": 14,
        "currentPage": 1,
        "resultList": [
            {
                "symbol": "BTC_USDT",
                "currency": "USDT",
                "available": 97284530.448634083318792525314410007362,
                "snapshotTime": 1761883200000
            },
            {
                "symbol": "BTC_USDT",
                "currency": "USDT",
                "available": 97278356.693307391915362536014224404257,
                "snapshotTime": 1761868800000
            },
            {
                "symbol": "BTC_USDT",
                "currency": "USDT",
                "available": 97275052.998679590630831496951543806325,
                "snapshotTime": 1761854400000
            }
        ]
    }
}
```

--------------------------------

### Subscribe to depth with minimum notional step

Source: https://www.mexc.com/api-docs/futures/websocket-api/depth-specify-minimum-notional-step

Subscribes to depth data with a specified minimum notional step. The 'step' parameter is the notional bucket size; e.g., '10' means levels like 100010, 100020, 100030.

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

--------------------------------

### GET /api/v1/contract/detail/country

Source: https://www.mexc.com/api-docs/futures/market-endpoints/get-contract-info

Fetches detailed contract information. Optionally filter by contract symbol. Rate limited to 10 requests per 2 seconds.

```APIDOC
## GET /api/v1/contract/detail/country

### Description
Retrieves detailed contract information for a futures contract, including trading specifications, risk limits, and fee rates.

### Method
GET

### Endpoint
/api/v1/contract/detail/country

### Parameters
#### Query Parameters
- **symbol** (string) - Optional - Contract symbol

### Response
#### Success Response (200)
- **symbol** (string) - Contract symbol
- **displayName** (string) - Display name
- **displayNameEn** (string) - English display name
- **positionOpenType** (int) - Opening type: 1 isolated, 2 cross, 3 both supported
- **baseCoin** (string) - Base asset (e.g. BTC)
- **quoteCoin** (string) - Quote asset (e.g. USDT)
- **baseCoinName** (string) - Base asset name
- **quoteCoinName** (string) - Quote currency name
- **futureType** (int) - Contract type: 1 perpetual, 2 delivery
- **settleCoin** (string) - Settlement asset
- **contractSize** (decimal) - Contract size
- **minLeverage** (int) - Minimum leverage
- **maxLeverage** (int) - Maximum leverage
- **countryConfigContractMaxLeverage** (int) - Country-configured maximum leverage for this contract
- **priceScale** (int) - Price precision
- **volScale** (int) - Volume precision
- **amountScale** (int) - Amount precision
- **priceUnit** (decimal) - Minimum price tick
- **volUnit** (decimal) - Minimum quantity step
- **minVol** (decimal) - Minimum order size (contracts)
- **maxVol** (decimal) - Maximum order size (contracts)
- **bidLimitPriceRate** (decimal) - Buy-side limit price protection ratio
- **askLimitPriceRate** (decimal) - Sell-side limit price protection ratio
- **takerFeeRate** (decimal) - Taker fee rate
- **makerFeeRate** (decimal) - Maker fee rate
- **maintenanceMarginRate** (decimal) - Maintenance margin rate
- **initialMarginRate** (decimal) - Initial margin rate
- **riskBaseVol** (decimal) - Base risk volume (contracts)
- **riskIncrVol** (decimal) - Incremental risk volume (contracts)
- **riskLongShortSwitch** (int) - Separate long/short risk limits: 0 off, 1 on
- **riskIncrMmr** (decimal) - Maintenance margin rate increment per tier
- **riskIncrImr** (decimal) - Initial margin rate increment per tier
- **riskLevelLimit** (int) - Number of risk limit tiers
- **priceCoefficientVariation** (decimal) - Fair price deviation coefficient from index price
- **indexOrigin** (List<String>) - Index price sources
- **state** (int) - Status: 0 enabled, 1 delivery, 2 delivered, 3 offline, 4 paused
- **isNew** (boolean) - Whether this is the new-listing tag; `true` yes, `false` no
- **isHot** (boolean) - Whether this is the hot symbol tag; `true` yes, `false` no
- **isHidden** (boolean) - Whether hidden from default display; `true` yes, `false` no
- **conceptPlate** (List<String>) - Sector tags (matches sector list `entryKey`)
- **conceptPlateId** (List<Integer>) - Sector tag IDs
- **riskLimitType** (string) - Risk limit type: `BY_VOLUME` (by contracts), `BY_VALUE` (by position value)
- **maxNumOrders** (List<Integer>) - Max open orders: [hedged mode max, one-way mode max]
- **marketOrderMaxLevel** (int) - Max market-order taker depth levels
- **marketOrderPriceLimitRate1** (decimal) - Price protection coefficient for market orders when depth exceeds 20 levels
- **marketOrderPriceLimitRate2** (decimal) - Price protection coefficient for market orders when depth is 20 levels or fewer
- **triggerProtect** (decimal) - Conditional order trigger threshold for priceProtect; 0 disables protection
- **appraisal** (int) - Assessment flag: 1 on, 0 off
- **showAppraisalCountdown** (int) - Show assessment countdown: 1 on, 0 off
- **automaticDelivery** (int) - Auto delivery flag: 1 on, 0 off
- **apiAllowed** (boolean) - Whether API trading is allowed
- **depthStepList** (List<String>) - Order book depth step list
- **limitMaxVol** (decimal) - Max contracts per limit order
- **threshold** (long) - `0` disabled; greater than `0` indicates an active configuration
- **baseCoinIconUrl** (string) - Base asset icon URL
- **id** (int) - Contract ID
- **vid** (string) - Settlement coin vcoin ID
- **baseCoinId** (string) - Base coin vcoin ID
- **createTime** (long) - Creation time; Unix millisecond timestamp
- **openingTime** (long) - Market open time; Unix millisecond timestamp
- **openingCountdownOption** (int) - Opening countdown UI: 1 show open time and countdown; 2 show open time only; 3 show neither
- **showBeforeOpen** (boolean) - Whether shown on the new listing board before market open; true: yes, false: no
- **isMaxLeverage** (boolean) - Whether this is the max leverage tag; true: yes, false: no
- **isZeroFeeRate** (boolean) - Whether this is a zero-fee tag; true: yes, false: no
- **riskLimitMode** (string) - Risk limit mode: `INCREASE` = incremental mode, `CUSTOM` = custom mode
- **isZeroFeeSymbol** (boolean) - Whether this is a zero-fee symbol; true: participates in the zero-fee program, false: no
- **riskLimitCustom** (array) - Custom risk limit list in CUSTOM mode; each item is an object containing level (tier), maxVol (maximum contracts), mmr (maintenance margin rate), imr (initial margin rate), and maxLeverage (maximum leverage)

### Rate Limit
10 time / 2 seconds
```

--------------------------------

### GET /api/v1/private/order/open_order_total_count

Source: https://www.mexc.com/api-docs/futures/account-and-trading-endpoints/query-in-flight-order-counts

Retrieves the total count of open orders and counts by order type (limit, stop, plan, trailing). No request parameters are required.

```APIDOC
## GET /api/v1/private/order/open_order_total_count

### Description
Retrieves the total count of in-flight (open) orders, including limit, stop, plan, and trailing orders.

### Method
GET

### Endpoint
/api/v1/private/order/open_order_total_count

### Parameters
None

### Response
#### Success Response (200)
- **sumCount** (int) - Total count of open orders
- **limitOrderCount** (int) - Count of limit orders
- **stopOrderCount** (int) - Count of take-profit/stop-loss orders
- **planOrderCount** (int) - Count of plan orders
- **trackOrderCount** (int) - Count of trailing orders

#### Response Example
{
  "success": true,
  "code": 0,
  "data": {
    "sumCount": 1,
    "limitOrderCount": 1,
    "stopOrderCount": 0,
    "planOrderCount": 0,
    "trackOrderCount": 0
  }
}
```

--------------------------------

### Error Code 8931

Source: https://www.mexc.com/api-docs/futures/error-code

Your leverage exceeds the maximum limit of {max}x in your country/region. Please adjust your leverage and try again.

```APIDOC
## Error Code 8931

### Description
The leverage exceeds allowed limits for your region or current position. Reduce leverage or adjust position size according to contract and account rules.

### Error Code
8931

### Error Message
Your leverage exceeds the maximum limit of {max}x in your country/region. Please adjust your leverage and try again.

### Recommended Action
Reduce leverage or adjust position size according to contract and account rules.
```

--------------------------------

### GET /api/v1/private/stoporder/open_orders

Source: https://www.mexc.com/api-docs/futures/account-and-trading-endpoints/get-current-take-profitstop-loss-order-list

Retrieves the current take-profit/stop-loss order list. Requires the 'View Order Details' permission. Rate limit: 20 times/2 seconds.

```APIDOC
## GET /api/v1/private/stoporder/open_orders

### Description
Retrieves the current take-profit/stop-loss order list for a specified contract symbol.

### Method
GET

### Endpoint
/api/v1/private/stoporder/open_orders

### Parameters
#### Query Parameters
- **symbol** (string) - Optional - Contract symbol (e.g., BTC_USDT)

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful
- **code** (integer) - Response code (0 for success)
- **data** (array) - List of TP/SL orders
  - **id** (long) - TP/SL order id
  - **symbol** (string) - Contract symbol
  - **orderId** (long) - Limit order id; 0 if placed by position
  - **positionId** (long) - Position id
  - **lossTrend** (int) - Stop-loss type: 1 latest price, 2 fair price, 3 index price
  - **profitTrend** (int) - Take-profit type: 1 latest price, 2 fair price, 3 index price
  - **stopLossPrice** (decimal) - Stop-loss price
  - **takeProfitPrice** (decimal) - Take-profit price
  - **state** (int) - Status: 1 untriggered, 2 canceled, 3 executed, 4 invalidated, 5 execution failed
  - **triggerSide** (int) - Trigger direction: 0 not triggered, 1 take-profit, 2 stop-loss
  - **positionType** (int) - Position type: 1 long, 2 short
  - **vol** (decimal) - Order quantity
  - **realityVol** (decimal) - Actual placed quantity
  - **placeOrderId** (long) - Order id after successful placement
  - **errorCode** (int) - Error code: 0 normal, others see error code details
  - **isFinished** (int) - Whether order is in final state: 0 non-final, 1 final
  - **version** (int) - Version
  - **priceProtect** (int) - Trigger protection: "1", "0"
  - **profitLossVolType** (string) - TP/SL quantity type: SAME or SEPARATE
  - **takeProfitVol** (decimal) - Take-profit quantity (when profitLossVolType == SEPARATE)
  - **stopLossVol** (decimal) - Stop-loss quantity (when profitLossVolType == SEPARATE)
  - **createTime** (long) - Created time
  - **updateTime** (long) - Updated time
  - **volType** (int) - Quantity type: 1 partial TP/SL, 2 position TP/SL
  - **takeProfitReverse** (int) - Take-profit reverse: 1 yes, 2 no
  - **stopLossReverse** (int) - Stop-loss reverse: 1 yes, 2 no
  - **takeProfitType** (int) - Take-profit type: 0 market TP, 1 limit TP
  - **takeProfitOrderPrice** (decimal) - Limit TP order price
  - **stopLossType** (long) - Stop-loss type: 0 market SL, 1 limit SL
  - **stopLossOrderPrice** (decimal) - Limit SL order price

#### Response Example
```json
{
  "success": true,
  "code": 0,
  "data": [
    {
      "id": 357859177,
      "orderId": "720733527158642176",
      "symbol": "BTC_USDT",
      "positionId": "1027177055",
      "lossTrend": 1,
      "profitTrend": 1,
      "stopLossPrice": 111325,
      "takeProfitPrice": 113573.9,
      "state": 3,
      "triggerSide": 2,
      "positionType": 1,
      "vol": 2,
      "realityVol": 2,
      "placeOrderId": "720744238723187712",
      "errorCode": 0,
      "version": 2,
      "isFinished": 1,
      "priceProtect": 0,
      "profitLossVolType": "SEPARATE",
      "takeProfitVol": 2,
      "stopLossVol": 2,
      "createTime": 1757506663000,
      "updateTime": 1757509217000,
      "volType": 1,
      "takeProfitReverse": 2,
      "stopLossReverse": 2,
      "closeTryTimes": 0,
      "reverseTryTimes": 0,
      "reverseErrorCode": 0,
      "takeProfitType": 0,
      "profit_LOSS_VOL_TYPE_SAME": "SAME",
      "profit_LOSS_VOL_TYPE_DIFFERENT": "SEPARATE"
    }
  ]
}
```
```

--------------------------------

### Index price push response (push.index.price)

Source: https://www.mexc.com/api-docs/futures/websocket-api/index-price

Sample data pushed when the index price changes. Contains the contract symbol and the updated price.

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

--------------------------------

### Error Code 8916

Source: https://www.mexc.com/api-docs/futures/error-code

The file size exceeds the limit and cannot be generated, or has not been generated yet. Please download it from the web version or try again later.

```APIDOC
## Error Code 8916

### Description
The activity or campaign request could not be completed. Check eligibility, account type, event status, and required conditions. Contact MEXC customer service or API support if the issue persists.

### Error Code
8916

### Error Message
The file size exceeds the limit and cannot be generated, or has not been generated yet. Please download it from the web version or try again later.

### Recommended Action
Check eligibility, account type, event status, and required conditions. Contact MEXC customer service or API support if the issue persists.
```

--------------------------------

### Subscribe to index price (sub.index.price)

Source: https://www.mexc.com/api-docs/futures/websocket-api/index-price

Use this JSON request to subscribe to index price updates. For inverse contracts, use the same symbol as linear (e.g., BTC_USDT for BTC_USD). Updates are pushed whenever there are changes.

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

--------------------------------

### Error Code 8930

Source: https://www.mexc.com/api-docs/futures/error-code

Not yet listed, unable to place an order.

```APIDOC
## Error Code 8930

### Description
The contract may be delisted or not yet listed. Check contract status; new positions may be disabled while existing positions may still be managed according to platform rules.

### Error Code
8930

### Error Message
Not yet listed, unable to place an order

### Recommended Action
Check contract status; new positions may be disabled while existing positions may still be managed according to platform rules.
```
Tokens:
Raw