MEXC Spot Trading API v3

https://www.mexc.com/api-docs/spot-v3/
Admin
MEXC Spot Trading API v3 is a comprehensive REST and WebSocket API for accessing MEXC's spot trading...
Tokens:82,146
Snippets:548
Trust Score:5.8
Update:1 day ago
Show doc for...
Tokens:
Raw
### GET /api/v3/rebate/affiliate/list

Source: https://www.mexc.com/api-docs/spot-v3/change-log

Documentation for the affiliate-only direct sub-affiliate listing endpoint was added, including parameters, wrapped response schema, and a full response example.

```APIDOC
## GET /api/v3/rebate/affiliate/list

### Description
Documentation for the affiliate-only direct sub-affiliate listing endpoint, including parameters, wrapped response schema, and a full response example.

### Method
GET

### Endpoint
/api/v3/rebate/affiliate/list

### Parameters
(Parameters not specified in the source changelog.)

### Response
#### Success Response
(Response schema not specified in the source changelog.)

#### Response Example
(Response example not provided in the source changelog.)
```

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

### GET /api/v3/capital/config/getall

Source: https://www.mexc.com/api-docs/spot-v3/change-log

Queries currency information. Updated to include the depositPreConfirms response field.

```APIDOC
## GET /api/v3/capital/config/getall

### Description
Queries currency information. This endpoint was updated to include the depositPreConfirms response field.

### Method
GET

### Endpoint
/api/v3/capital/config/getall

### Response
#### Success Response (200)
- **depositPreConfirms** (type not specified) - Description not provided in source.

#### Response Example
Updated sample response JSON (not provided in source).
```

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

### Exchange Information Response Example

Source: https://www.mexc.com/api-docs/spot-v3/market-data-endpoints/exchange-information

Example JSON response from the /api/v3/exchangeInfo endpoint, showing symbol details, filters, and commission rates.

```json
{
    "timezone": "CST",
    "serverTime": 1786334624020,
    "rateLimits": [],
    "exchangeFilters": [],
    "symbols": [
        {
            "symbol": "METALUSDT",
            "status": "1",
            "baseAsset": "METAL",
            "baseAssetPrecision": 2,
            "quoteAsset": "USDT",
            "quotePrecision": 5,
            "quoteAssetPrecision": 5,
            "baseCommissionPrecision": 2,
            "quoteCommissionPrecision": 5,
            "orderTypes": [
                "LIMIT",
                "MARKET",
                "LIMIT_MAKER"
            ],
            "isSpotTradingAllowed": true,
            "isMarginTradingAllowed": false,
            "quoteAmountPrecision": "1",
            "baseSizePrecision": "0.1",
            "permissions": [
                "SPOT"
            ],
            "filters": [
                {
                    "filterType": "PERCENT_PRICE_BY_SIDE",
                    "bidMultiplierUp": "0.2",
                    "askMultiplierDown": "0.2"
                }
            ],
            "maxQuoteAmount": "2000000",
            "makerCommission": "0",
            "takerCommission": "0.0005",
            "quoteAmountPrecisionMarket": "1",
            "maxQuoteAmountMarket": "100000",
            "fullName": "Metal Blockchain",
            "tradeSideType": 1,
            "contractAddress": "xtokens",
            "conceptPlateIds": [
                51
            ],
            "conceptPlates": [
                "mc-trade-zone-innovation"
            ],
            "st": false
        }
    ]
}
```

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

### GET /api/v3/apiKeyInfo

Source: https://www.mexc.com/api-docs/spot-v3/spot-account-trade/query-api-key-info

Query information for a specified API Key. Requires SPOT_ACCOUNT_READ permission and has a weight of 1.

```APIDOC
## GET /api/v3/apiKeyInfo

### Description
Query information for a specified API Key.

### Method
GET

### Endpoint
/api/v3/apiKeyInfo

### Parameters
#### Query Parameters
- **timestamp** (string) - Required - Timestamp
- **signature** (string) - Required - Signature
- **accessKey** (string) - Required - The accessKey to query

### Response
#### Success Response (200)
- **note** (string) - APIKey note
- **apikey** (string) - API public key
- **status** (string) - API Key status: VALID, DELETE, or FROZEN
- **permissions** (string) - Enabled APIKey permissions, comma-separated. Available values: SPOT_ACCOUNT_READ, SPOT_ACCOUNT_WRITE, SPOT_DEAL_READ, SPOT_DEAL_WRITE, CONTRACT_ACCOUNT_READ, CONTRACT_ACCOUNT_WRITE, CONTRACT_DEAL_READ, CONTRACT_DEAL_WRITE, SPOT_TRANSFER_READ, SPOT_TRANSFER_WRITE
- **ipWhiteList** (string) - Currently linked IP whitelist
- **createTime** (string) - API Key creation time
- **remainingValidity** (integer) - Remaining validity in days: -999 for permanent, 0 if expired, greater than 0 if active

#### Response Example
{
    "note": "P2P",
    "accessKey": "mx0vgxxxxxxxvwe9Pq",
    "createTime": "2026-08-31T02:22:18.000+00:00",
    "permissions": "CONTRACT_ACCOUNT_READ,CONTRACT_DEAL_WRITE,SPOT_TRANSFER_READ,SPOT_WITHDRAW_WRITE,SPOT_WITHDRAW_READ,SPOT_DEAL_WRITE,CONTRACT_DEAL_READ,SPOT_TRANSFER_WRITE,SPOT_ACCOUNT_WRITE,SPOT_DEAL_READ,SPOT_ACCOUNT_READ",
    "remainingValidity": 66,
    "ipWhiteList": "",
    "status": "VALID"
}
```

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

### GET /api/v3/capital/config/getall

Source: https://www.mexc.com/api-docs/spot-v3/wallet-endpoints/query-the-currency-information

Returns detailed coin information and contract addresses. Requires the SPOT_WITHDRAW_READ permission and has a weight of 10 (IP).

```APIDOC
## GET /api/v3/capital/config/getall

### Description
Returns detailed coin information and contract addresses.

### Method
GET

### Endpoint
/api/v3/capital/config/getall

### Parameters
None

### Response
#### Success Response (200)
- **coin** (string) - Coin symbol
- **depositDesc** (string) - Deposit description
- **depositEnable** (boolean) - Whether deposit is enabled
- **minConfirm** (integer) - Minimum confirmations required for deposit
- **depositPreConfirms** (integer) - Pre-confirmation count for deposit
- **name** (string) - Network display name
- **network** (string) - Withdraw network display name (legacy parameter, will be deprecated)
- **withdrawEnable** (boolean) - Whether withdraw is enabled
- **withdrawFee** (string) - Withdraw fee
- **withdrawIntegerMultiple** (string) - Withdraw amount increment
- **withdrawMax** (string) - Max withdraw amount
- **withdrawMin** (string) - Min withdraw amount
- **sameAddress** (boolean) - Whether deposit and withdraw share the same address format
- **contract** (string) - Contract address
- **withdrawTips** (string) - Withdraw tips
- **depositTips** (string) - Deposit tips
- **netWork** (string) - Withdraw network (new parameter, for the new withdraw endpoint)

#### Response Example
```json
[
    {
        "coin": "CATCHOLD",
        "name": "SpaceCatch",
        "networkList": [
            {
                "coin": "CATCHOLD",
                "depositDesc": "Deposit is prohibited (forced deposit may result in asset loss)",
                "depositEnable": false,
                "minConfirm": 3360,
                "depositPreConfirms": 120,
                "name": "SpaceCatch",
                "network": "Arbitrum One(ARB)",
                "withdrawEnable": true,
                "withdrawFee": "0",
                "withdrawIntegerMultiple": "18",
                "withdrawMax": "100000",
                "withdrawMin": "1",
                "sameAddress": false,
                "contract": "0xf0a479C9c3378638EC603b8B6B0d75903902550B",
                "withdrawTips": null,
                "depositTips": null,
                "netWork": "ARB"
            }
        ]
    },
    {
        "coin": "BBC",
        "name": "ByByeCar",
        "networkList": [
            {
                "coin": "BBC",
                "depositDesc": "Deposit is prohibited (forced deposit may result in asset loss)",
                "depositEnable": false,
                "minConfirm": 20,
                "depositPreConfirms": 2,
                "name": "ByByeCar",
                "network": "Tron(TRC20)",
                "withdrawEnable": true,
                "withdrawFee": "0",
                "withdrawIntegerMultiple": "18",
                "withdrawMax": "200000",
                "withdrawMin": "1",
                "sameAddress": false,
                "contract": "TRrkeSxEypfiTn7gU3Gg3tP756cEhK493b",
                "withdrawTips": "",
                "depositTips": "",
                "netWork": "TRX"
            }
        ]
    }
]
```
```

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

### GET /api/v3/capital/convert/list

Source: https://www.mexc.com/api-docs/spot-v3/wallet-endpoints/get-assets-that-can-be-converted-into-mx

Retrieves the list of assets that can be converted into MX. Requires SPOT_ACCOUNT_READ permission and a valid timestamp and signature.

```APIDOC
## GET /api/v3/capital/convert/list

### Description
Retrieves the list of assets that can be converted into MX, including conversion amounts and balances.

### Method
GET

### Endpoint
/api/v3/capital/convert/list

### Parameters
#### Query Parameters
- **timestamp** (string) - Required - Timestamp
- **signature** (string) - Required - Signature

### Response
#### Success Response (200)
- **convertMx** (string) - MX amount (deducted commission fee)
- **convertUsdt** (string) - USDT amount
- **balance** (string) - Convertible balance
- **asset** (string) - Asset
- **code** (string) - Code
- **message** (string) - Message

#### Response Example
```json
[
    {
        "convertMx": "0.000009",
        "convertUsdt": "0.000009",
        "balance": "0.000441",
        "asset": "USDT",
        "code": "30021",
        "message": "xxxxxxx"
    },
    {
        "convertMx": "0.000009",
        "convertUsdt": "0.000009",
        "balance": "0.000441",
        "asset": "BTC",
        "code": "30021",
        "message": "xxxxxxx"
    }
]
```
```

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

### GET /api/v3/rebate/affiliate/referral

Source: https://www.mexc.com/api-docs/spot-v3/rebate-endpoints/get-affiliate-referral-dataaffiliate-only

Fetches affiliate referral data for the authenticated affiliate. Requires SPOT_ACCOUNT_READ permission and a valid signature.

```APIDOC
## GET /api/v3/rebate/affiliate/referral

### Description
Retrieves affiliate referral data for the authenticated affiliate account. This endpoint is restricted to affiliate users and requires the SPOT_ACCOUNT_READ permission.

### Method
GET

### Endpoint
/api/v3/rebate/affiliate/referral

### Parameters
#### Query Parameters
- **startTime** (long) - Optional - Start time, Unix millisecond timestamp
- **endTime** (long) - Optional - End time, Unix millisecond timestamp
- **uid** (string) - Optional - uid
- **inviteCode** (string) - Optional - invite code
- **page** (int) - Optional - page
- **pageSize** (int) - Optional - pageSize, default: 10
- **timestamp** (long) - Required - timestamp
- **signature** (string) - Required - signature

### Request Example
GET /api/v3/rebate/affiliate/referral?startTime=1640275818000&endTime=1642875818000&page=1&pageSize=10&timestamp=1642875818000&signature=your_signature

### Response
#### Success Response (200)
- **uid** (int) - uid
- **account** (string) - account email
- **inviteCode** (string) - invite code
- **inviteTime** (long) - invite time
- **nickName** (string) - nickName
- **firstDeposit** (long) - first deposit date
- **firstTrade** (long) - first trade date
- **lastDeposit** (long) - last deposit date
- **lastTrade** (long) - last trade date
- **depositAmount** (string) - deposit amount(USDT)
- **tradingAmount** (string) - trading amount(USDT)
- **amount** (string) - commission amount(USDT)
- **asset** (string) - 0 USDT、1-1,000 USDT、1,000 - 10,000 USDT、 10,000 - 50,000 USDT、50,000 - 100,000 USDT、 100,000 - 500,000 USDT、500,000 - 1,000,000 USDT、 1,000,000 - 5,000,000 USDT、>5,000,000 USDT
- **withdrawalAmount** (string) - withdrawal amount(USDT)
- **identification** (int) - identification,1: Uncertified, 2: primary, 3: Advanced, 4: Institutional

#### Response Example
{
    "success": true,
    "code": 0,
    "message": null,
    "data": {
        "pageSize": 10,
        "totalCount": 15,
        "totalPage": 2,
        "currentPage": 1,
        "resultList": [
            {
                "uid": "42469975",
                "nickName": null,
                "email": "",
                "registerTime": 1640275818000,
                "inviteCode": "mexc-12201950",
                "depositAmount": "0.00000000",
                "tradingAmount": "0.00000000",
                "commission": "0.00000000",
                "firstDepositTime": null,
                "firstTradeTime": null,
                "lastDepositTime": null,
                "lastTradeTime": null,
                "withdrawAmount": "0.00000000",
                "asset": "0 USDT",
                "identification": 1
          }
        ]
    }
}

### Notes
- If startTime and endTime are not provided, the system will query data from T-7 to T by default.
- The time range for a single query must not exceed 30 days.
- Required Permission: SPOT_ACCOUNT_READ
- Weight(IP): 1
```

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

### Sample Data for Spot Account Update

Source: https://www.mexc.com/api-docs/spot-v3/websocket-user-data-streams/spot-account-update

Example response payload from the spot@private.account.v3.api.pb channel, showing account balance changes.

```json
{
  "channel": "spot@private.account.v3.api.pb",
  "createTime": 1736417034305,
  "sendTime": 1736417034307,
  "privateAccount": {
    "vcoinName": "USDT",
    "coinId": "128f589271cb4951b03e71e6323eb7be",
    "balanceAmount": "21.94210356004384",
    "balanceAmountChange": "10",
    "frozenAmount": "0",
    "frozenAmountChange": "0",
    "type": "CONTRACT_TRANSFER",
    "time": 1736416910000
  }
}
```

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

### Sample data for Spot Account Deals

Source: https://www.mexc.com/api-docs/spot-v3/websocket-user-data-streams/spot-account-deals

Example of the data received on the spot@private.deals.v3.api.pb channel, showing trade details.

```json
{
  "channel": "spot@private.deals.v3.api.pb",
  "symbol": "MXUSDT",
  "sendTime": 1736417034332,
  "privateDeals": {
    "price": "3.6962",
    "quantity": "1",
    "amount": "3.6962",
    "tradeType": 2,
    "isMaker": false,
    "tradeId": "505979017439002624X1",
    "orderId": "C02__505979017439002624115",
    "feeAmount": "0.0003998377369698171",
    "feeCurrency": "MX",
    "time": 1736417034280
  }
}
```

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

### GET /api/v3/trades

Source: https://www.mexc.com/api-docs/spot-v3/market-data-endpoints/recent-trades-list

Get recent trades for a symbol. By default, returns the latest 500 trades.

```APIDOC
## GET /api/v3/trades

### Description
Get recent trades for a symbol. By default, returns the latest 500 trades.

### Method
GET

### Endpoint
/api/v3/trades

### Parameters
#### Query Parameters
- **symbol** (string) - Required - Symbol name, e.g. BTCUSDT
- **limit** (integer) - Optional - Number of results returned. Default 500; max 1000

### Response
#### Success Response (200)
- **id** - Trade id
- **price** - Price
- **qty** - Number
- **quoteQty** - Trade total
- **time** - Trade time
- **isBuyerMaker** - Was the buyer the maker?
- **isBestMatch** - Was the trade the best price match?
- **tradeType** - Trade type

#### Response Example
```json
[
    {
        "id": null,
        "price": "63530",
        "qty": "0.00317906",
        "quoteQty": "201.96568180",
        "time": 1781226399689,
        "isBuyerMaker": true,
        "isBestMatch": true,
        "tradeType": "ASK"
    },
    {
        "id": null,
        "price": "63530",
        "qty": "0.00100644",
        "quoteQty": "63.93913320",
        "time": 1781226399688,
        "isBuyerMaker": true,
        "isBestMatch": true,
        "tradeType": "ASK"
    },
    {
        "id": null,
        "price": "63529.99",
        "qty": "0.00232318",
        "quoteQty": "147.5916021682",
        "time": 1781226399687,
        "isBuyerMaker": true,
        "isBestMatch": true,
        "tradeType": "ASK"
    }
]
```

### Weight(IP)
5
```

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

### GET /api/v3/sub-account/list

Source: https://www.mexc.com/api-docs/spot-v3/subaccount-endpoints/query-sub-account-list-for-master-account

Get details of the sub-account list. Requires SPOT_ACCOUNT_READ permission. Weight(IP): 1.

```APIDOC
## GET /api/v3/sub-account/list

### Description
Get details of the sub-account list.

### Method
GET

### Endpoint
/api/v3/sub-account/list

### Parameters
#### Query Parameters
- **subAccount** (STRING) - Optional - Sub-account Name
- **isFreeze** (STRING) - Optional - true or false
- **page** (INT) - Optional - Default value: 1
- **limit** (INT) - Optional - Default value: 10, Max value: 200
- **timestamp** (LONG) - Required
- **recvWindow** (LONG) - Optional

### Response
#### Success Response (200)
- **subAccounts** (array) - List of sub-accounts
  - **subAccount** (string) - subAccount name
  - **isFreeze** (boolean) - isFreeze
  - **createTime** (number) - createTime
  - **uid** (string) - subaccount uid

#### Response Example
{
    "subAccounts":[
        {
            "subAccount":"mexc666",
            "isFreeze":false,
            "createTime":1544433328000,
            "uid": "49910511"
        },
        {
            "subAccount":"mexc888",
            "isFreeze":false,
            "createTime":1544433328000,
            "uid": "91921059"
        }
    ]
}
```

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

### Example 1: All parameters in Request Body - curl command

Source: https://www.mexc.com/api-docs/spot-v3/introduction

Sends the order request with all parameters in the request body using curl. The signature is included in the request body. The command uses the X-MEXC-APIKEY header and Content-Type: application/json.

```shell
curl command:

    (HMAC SHA256)
    $ curl -H "X-MEXC-APIKEY: mx0aBYs33eIilxBWC5" \
           -H "Content-Type: application/json" \
           -X POST \
           'https://api.mexc.com/api/v3/order' \
           --data-raw 'symbol=BTCUSDT&side=BUY&type=LIMIT&quantity=1&price=11&recvWindow=5000&timestamp=1644489390087&signature=fd3e4e8543c5188531eb7279d68ae7d26a573d0fc5ab0d18eb692451654d837a'
```

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

### Sample data for spot@private.orders.v3.api.pb

Source: https://www.mexc.com/api-docs/spot-v3/websocket-user-data-streams/spot-account-orders

Example response payload for the spot account orders stream. Shows the structure with channel, symbol, sendTime, and privateOrders object.

```json
{
  "channel": "spot@private.orders.v3.api.pb",
  "symbol": "MXUSDT",
  "sendTime": 1736417034281,
  "privateOrders": {
    "clientId": "C02__505979017439002624115",
    "price": "3.5121",
    "quantity": "1",
    "amount": "0",
    "avgPrice": "3.6962",
    "orderType": 5,
    "tradeType": 2,
    "remainAmount": "0",
    "remainQuantity": "0",
    "lastDealQuantity": "1",
    "cumulativeQuantity": "1",
    "cumulativeAmount": "3.6962",
    "status": 2,
    "createTime": 1736417034259
  }
}
```

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

### GET /api/v3/ticker/price

Source: https://www.mexc.com/api-docs/spot-v3/market-data-endpoints/symbol-price-ticker

Get the latest price for a symbol or all symbols. If the symbol parameter is not sent, all symbols will be returned in an array.

```APIDOC
## GET /api/v3/ticker/price

### Description
Get the latest price for a symbol or all symbols.

### Method
GET

### Endpoint
/api/v3/ticker/price

### Parameters
#### Query Parameters
- **symbol** (string) - Optional - If the symbol is not sent, all symbols will be returned in an array.

### Response
#### Success Response (200)
- **symbol** (string) - The trading pair symbol.
- **price** (string) - Last price.

#### Response Example
```json
{
    "symbol": "BTCUSDT",
    "price": "184.34"
}
```

Or when no symbol is provided:
```json
[
  {
    "symbol": "BTCUSDT",
    "price": "6.65"
  },
  {
    "symbol": "ETHUSDT",
    "price": "5.65"
  }
]
```
```

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

### POST /api/v3/apiKeyInfo

Source: https://www.mexc.com/api-docs/spot-v3/change-log

Configures the IP whitelist and note for a specified API Key. Requires the SPOT_ACCOUNT_WRITE permission. Weight(IP): 1.

```APIDOC
## POST /api/v3/apiKeyInfo

### Description
Configures the IP whitelist and note for a specified API Key.

### Method
POST

### Endpoint
/api/v3/apiKeyInfo

### Parameters
#### Request Body
- **apikey** (string) - Required - The API key to configure.
- **ipWhiteList** (string) - Optional - IP whitelist for the API key.
- **note** (string) - Optional - Note for the API key.
- **timestamp** (integer) - Required - Timestamp of the request.
- **signature** (string) - Required - Signature for authentication.

### Response
#### Success Response (200)
- **note** (string) - The note associated with the API key.
- **apikey** (string) - The API key.
- **ipWhiteList** (string) - The IP whitelist for the API key.

#### Response Example
{
  "note": "My API Key",
  "apikey": "exampleApiKey",
  "ipWhiteList": "192.168.1.1"
}

### Required Permission
SPOT_ACCOUNT_WRITE

### Weight(IP)
1
```

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

### GET /api/v3/depth

Source: https://www.mexc.com/api-docs/spot-v3/market-data-endpoints/order-book

Get order book depth for a symbol. By default, returns 100 bids and 100 asks.

```APIDOC
## GET /api/v3/depth

### Description
Get order book depth for a symbol. By default, returns 100 bids and 100 asks.

### Method
GET

### Endpoint
/api/v3/depth

### Parameters
#### Query Parameters
- **symbol** (string) - Required - Symbol
- **limit** (integer) - Optional - Return number; default 100; max 5000

### Response
#### Success Response (200)
- **lastUpdateId** (long) - Last Update Id
- **bids** (list) - Bid [Price, Quantity]
- **asks** (list) - Ask [Price, Quantity]

#### Response Example
{
  "lastUpdateId": 1112416,
  "bids": [
      ["15.00000", "49999.00000"]
  ],
  "asks": [
    ["14.0000", "1.0000"]
  ]
}
```

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

### Example 2: All parameters in Query String - curl command

Source: https://www.mexc.com/api-docs/spot-v3/introduction

Sends the order request with all parameters in the query string using curl. The signature is appended to the query string. No Content-Type header is used.

```shell
curl command:

    (HMAC SHA256)
    $ curl -H "X-MEXC-APIKEY: mx0aBYs33eIilxBWC5" \
           -X POST \
           'https://api.mexc.com/api/v3/order?symbol=BTCUSDT&side=BUY&type=LIMIT&quantity=1&price=11&recvWindow=5000&timestamp=1644489390087&signature=fd3e4e8543c5188531eb7279d68ae7d26a573d0fc5ab0d18eb692451654d837a'
```

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

### GET /api/v3/capital/deposit/address

Source: https://www.mexc.com/api-docs/spot-v3/wallet-endpoints/deposit-address-supporting-network

Retrieves the deposit address for a specified coin. Optionally, you can specify a network to get the address for that specific network. Requires the SPOT_WITHDRAW_READ permission.

```APIDOC
## GET /api/v3/capital/deposit/address

### Description
Retrieves the deposit address for a specified coin. Optionally, you can specify a network to get the address for that specific network. Requires the SPOT_WITHDRAW_READ permission.

### Method
GET

### Endpoint
/api/v3/capital/deposit/address

### Parameters
#### Query Parameters
- **coin** (string) - Required - The coin for which to retrieve the deposit address.
- **network** (string) - Optional - The deposit network (e.g., TRC20, ERC20).
- **timestamp** (string) - Required - The timestamp of the request.
- **signature** (string) - Required - The signature for authentication.

### Response
#### Success Response (200)
- **address** (string) - The deposit address.
- **coin** (string) - The coin.
- **memo** (string/null) - The memo, if applicable.
- **network** (string) - The network.

#### Response Example
[
  {
      "coin": "USDT",
      "network": "TRC20",
      "address": "TXobiKkdciupZrhdvZyTSSLjE8CmZAufS",
      "memo": null
  },
  {
      "coin": "USDT",
      "network": "BEP20(BSC)",
      "address": "0xebe4804f7ecc22d5011c42e6ea1f2e6c891d89b",
      "memo": null
  },
  {
      "coin": "USDT",
      "network": "ERC20",
      "address": "0x3f4d1f43761b52fd594e5a77cd83cab6955e85b",
      "memo": null
  }
]
```

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

### GET /api/v3/exchangeInfo

Source: https://www.mexc.com/api-docs/spot-v3/market-data-endpoints/exchange-information

Get current exchange trading rules and symbol information. Supports optional query parameters to filter by symbol or a list of symbols.

```APIDOC
## GET /api/v3/exchangeInfo

### Description
Get current exchange trading rules and symbol information.

### Method
GET

### Endpoint
/api/v3/exchangeInfo

### Parameters
#### Query Parameters
- **symbol** (string) - Optional - Trading symbol, e.g., MXUSDT
- **symbols** (string) - Optional - Comma-separated list of symbols, e.g., MXUSDT,BTCUSDT

### Request Example
```
curl -X GET "https://api.mexc.com/api/v3/exchangeInfo"
curl -X GET "https://api.mexc.com/api/v3/exchangeInfo?symbol=MXUSDT"
curl -X GET "https://api.mexc.com/api/v3/exchangeInfo?symbols=MXUSDT,BTCUSDT"
```

### Response
#### Success Response (200)
- **timezone** (string) - timezone
- **serverTime** (long) - server Time
- **rateLimits** (Array) - rate Limits
- **exchangeFilters** (Array) - exchange Filters
- **symbols** (Array) - Array of symbol objects
  - **symbol** (String) - symbol
  - **status** (String) - status:1 - online, 2 - Pause, 3 - offline
  - **baseAsset** (String) - base Asset
  - **baseAssetPrecision** (Int) - base Asset Precision
  - **quoteAsset** (String) - quote Asset
  - **quotePrecision** (Int) - quote Precision
  - **quoteAssetPrecision** (Int) - quote Asset Precision
  - **baseCommissionPrecision** (Int) - base Commission Precision
  - **quoteCommissionPrecision** (Int) - quote Commission Precision
  - **orderTypes** (Array) - ENUM: [Order Type](https://www.mexc.com/api-docs/spot-v3/public-api-definitions#order-type)
  - **isSpotTradingAllowed** (Boolean) - allow api spot trading
  - **isMarginTradingAllowed** (Boolean) - allow api margin trading
  - **permissions** (Array) - permissions
  - **filterType** (String) - filter type:PERCENT_PRICE_BY_SIDE
  - **bidMultiplierUp** (String) - bidMultiplierUp
  - **askMultiplierDown** (String) - askMultiplierDown
  - **maxQuoteAmount** (String) - max Quote Amount
  - **makerCommission** (String) - marker Commission
  - **takerCommission** (String) - taker Commission
  - **quoteAmountPrecision** (string) - min order amount
  - **baseSizePrecision** (string) - min order quantity
  - **quoteAmountPrecisionMarket** (string) - min order amount in market order
  - **maxQuoteAmountMarket** (String) - max quote Amount in market order
  - **tradeSideType** (String) - tradeSide Type:1 - All, 2 - buy order only, 3 - Sell order only, 4 - Close
  - **contractAddress** (String) - contract Address
  - **conceptPlateIds** (Array) - concept plate IDs
  - **conceptPlates** (Array) - concept plate names
  - **firstOpenTime** (long) - Initial listing time, represented as a 13-digit millisecond timestamp
  - **st** (String) - symbol st status:false,true

#### Response Example
```json
{
    "timezone": "CST",
    "serverTime": 1786334624020,
    "rateLimits": [],
    "exchangeFilters": [],
    "symbols": [
        {
            "symbol": "METALUSDT",
            "status": "1",
            "baseAsset": "METAL",
            "baseAssetPrecision": 2,
            "quoteAsset": "USDT",
            "quotePrecision": 5,
            "quoteAssetPrecision": 5,
            "baseCommissionPrecision": 2,
            "quoteCommissionPrecision": 5,
            "orderTypes": [
                "LIMIT",
                "MARKET",
                "LIMIT_MAKER"
            ],
            "isSpotTradingAllowed": true,
            "isMarginTradingAllowed": false,
            "quoteAmountPrecision": "1",
            "baseSizePrecision": "0.1",
            "permissions": [
                "SPOT"
            ],
            "filters": [
                {
                    "filterType": "PERCENT_PRICE_BY_SIDE",
                    "bidMultiplierUp": "0.2",
                    "askMultiplierDown": "0.2"
                }
            ],
            "maxQuoteAmount": "2000000",
            "makerCommission": "0",
            "takerCommission": "0.0005",
            "quoteAmountPrecisionMarket": "1",
            "maxQuoteAmountMarket": "100000",
            "fullName": "Metal Blockchain",
            "tradeSideType": 1,
            "contractAddress": "xtokens",
            "conceptPlateIds": [
                51
            ],
            "conceptPlates": [
                "mc-trade-zone-innovation"
            ],
            "st": false
        }
    ]
}
```

### Notes
- Weight(IP): 25
- Filter parameter description:
  - lastPrice means using the latest trade price, orderPrice means the order placement price.
  - For buy orders (only for LIMIT, IMMEDIATE_OR_CANCEL, FILL_OR_KILL): `orderPrice <= lastPrice * (1 + bidMultiplierUp)`
  - For sell orders: `orderPrice >= lastPrice * (1 - askMultiplierDown)`
```

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

### Sample data for spot@public.bookTicker.batch.v3.api.pb@BTCUSDT

Source: https://www.mexc.com/api-docs/spot-v3/websocket-market-streams/individual-symbol-book-ticker-streamsbatch-aggregation

Example response payload for the batch book ticker stream. It includes the channel, symbol, sendTime, and a publicBookTickerBatch object with bid/ask prices and quantities, version, and lastOrderCreateTime.

```json
{
  "channel" : "spot@public.bookTicker.batch.v3.api.pb@BTCUSDT",
  "symbol" : "BTCUSDT",
  "sendTime" : "1778075380611",
  "publicBookTickerBatch" : {
    "items" : [ {
      "bidPrice" : "100",
      "bidQuantity" : "4",
      "askPrice" : "",
      "askQuantity" : ""
    } ],
    "version" : "10023",
    "lastOrderCreateTime" : "1778075380572"
  }
}
```

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

### GET /api/v3/myTrades

Source: https://www.mexc.com/api-docs/spot-v3/spot-account-trade/account-trade-list

Get trade history for a symbol on the account. Only trades within the last month can be queried; use the web client export for more history (up to 540 days).

```APIDOC
## GET /api/v3/myTrades

### Description
Get trade history for a symbol on the account. Only trades within the last month can be queried; use the web client export for more history (up to 540 days).

### Method
GET

### Endpoint
/api/v3/myTrades

### Parameters
#### Query Parameters
- **symbol** (string) - Required - 
- **orderId** (string) - Optional - order Id
- **startTime** (long) - Optional - Start time, Unix millisecond timestamp
- **endTime** (long) - Optional - End time, Unix millisecond timestamp
- **limit** (int) - Optional - Default 10; max 1000;
- **recvWindow** (long) - Optional - 
- **timestamp** (long) - Required - 

### Response
#### Success Response (200)
- **symbol** (string) - 
- **id** (string) - deal id
- **orderId** (string) - order id
- **orderListId** (number) - Order list ID
- **price** (string) - Price
- **qty** (string) - Quantity
- **quoteQty** (string) - Deal quantity
- **commission** (string) - 
- **commissionAsset** (string) - 
- **time** (number) - Trade time
- **isBuyer** (boolean) - Whether the account was the buyer for this trade
- **isMaker** (boolean) - Whether the account was the maker for this trade
- **isBestMatch** (boolean) - 
- **isSelfTrade** (boolean) - isSelfTrade
- **clientOrderId** (string) - clientOrderId

#### Response Example
```json
[
  {
    "symbol": "BNBBTC",
    "id": "fad2af9e942049b6adbda1a271f990c6",
    "orderId": "bb41e5663e124046bd9497a3f5692f39",
    "orderListId": -1,
    "price": "4.00000100", 
    "qty": "12.00000000", 
    "quoteQty": "48.000012", 
    "commission": "10.10000000", 
    "commissionAsset": "BNB", 
    "time": 1499865549590, 
    "isBuyer": true, 
    "isMaker": false, 
    "isBestMatch": true,
    "isSelfTrade": true,
    "clientOrderId": null
  }
]
```
```

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

### POST /api/v3/sub-account/apiKey

Source: https://www.mexc.com/api-docs/spot-v3/subaccount-endpoints/create-an-apikey-for-a-sub-account-for-master-account

Creates an API key for a sub-account. Requires the SPOT_ACCOUNT_WRITE permission. The request must include the sub-account name, a note, permissions, and a timestamp. The response contains the generated API key and secret key.

```APIDOC
## POST /api/v3/sub-account/apiKey

### Description
Creates an API key for a sub-account. Requires the SPOT_ACCOUNT_WRITE permission.

### Method
POST

### Endpoint
/api/v3/sub-account/apiKey

### Parameters
#### Query Parameters
- **subAccount** (STRING) - Required - Sub-account Name
- **note** (STRING) - Required - APIKey note
- **permissions** (STRING) - Required - Permission of APIKey: SPOT_ACCOUNT_READ, SPOT_ACCOUNT_WRITE, SPOT_DEAL_READ, SPOT_DEAL_WRITE, CONTRACT_ACCOUNT_READ, CONTRACT_ACCOUNT_WRITE, CONTRACT_DEAL_READ, CONTRACT_DEAL_WRITE, SPOT_TRANSFER_READ, SPOT_TRANSFER_WRITE
- **ip** (STRING) - Optional - Link IP addresses, separate with commas if more than one. Support up to 20 addresses.
- **recvWindow** (LONG) - Optional - (no description provided)
- **timestamp** (LONG) - Required - (no description provided)

### Response
#### Success Response (200)
- **subAccount** (string) - Sub-account name
- **note** (string) - APIKey note
- **apiKey** (string) - API public key
- **secretKey** (string) - API secret key
- **permissions** (string) - APIKey permissions
- **ip** (string) - Linked IP addresses
- **createTime** (long) - Creation time, Unix millisecond timestamp

#### Response Example
{
    "subAccount": "mexc1",
    "note": "1",
    "apiKey": "arg13sdfgs",
    "secretKey": "nkjwn21973ihi",
    "permissions": "SPOT_ACCOUNT_READ",
    "ip": "135.181.193",
    "createTime": 1597026383085
}
```

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

### GET /api/v3/userDataStream

Source: https://www.mexc.com/api-docs/spot-v3/websocket-user-data-streams/listen-key

Retrieves all currently valid listen keys.

```APIDOC
## GET /api/v3/userDataStream

### Description
Retrieves all currently valid listen keys.

### Method
GET

### Endpoint
/api/v3/userDataStream

### Parameters
#### Query Parameters
None

### Request Example
No request body required.

### Response
#### Success Response (200)
- **listenKey** (array of strings) - List of valid listen keys.
- **total** (string) - Total number of listenKeys.
- **available** (string) - Available listenKeys.

#### Response Example
{
  "total": 200,
  "listenKey": [
    "342e83dfc434e8a5639a6f405d3cf9dc3caaf11ca6f6b9a475a6f2e9a4e1bf8d",
    "c716a755cc12fc905159c4f318920ccd25938224230d676431607735609719ed"
  ],
  "available": 198
}
```

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

### GET /api/v3/uid

Source: https://www.mexc.com/api-docs/spot-v3/spot-account-trade/query-uid

Retrieves the account UID. Requires SPOT_ACCOUNT_READ permission and a valid signature.

```APIDOC
## GET /api/v3/uid

### Description
Retrieves the account UID. Requires SPOT_ACCOUNT_READ permission and a valid signature.

### Method
GET

### Endpoint
/api/v3/uid

### Parameters
#### Query Parameters
- **timestamp** (long) - Required - timestamp
- **signature** (string) - Required - signature

### Response
#### Success Response (200)
- **uid** (string) - account uid

#### Response Example
{
    "uid": "209302839"
}

```

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

### GET /api/v3/exchangeInfo - No Parameter

Source: https://www.mexc.com/api-docs/spot-v3/market-data-endpoints/exchange-information

Curl command to retrieve exchange information without any parameters.

```bash
curl -X GET "https://api.mexc.com/api/v3/exchangeInfo"
```

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

### POST /api/v3/sub-account/virtualSubAccount

Source: https://www.mexc.com/api-docs/spot-v3/subaccount-endpoints/create-a-sub-accountfor-master-account

Creates a new sub-account from the master account. Requires the SPOT_ACCOUNT_WRITE permission and has an IP weight of 1.

```APIDOC
## POST /api/v3/sub-account/virtualSubAccount

### Description
Create a sub-account from the master account.

### Method
POST

### Endpoint
/api/v3/sub-account/virtualSubAccount

### Parameters
#### Request Body
- **subAccount** (STRING) - Required - Sub-account Name
- **note** (STRING) - Required - Sub-account notes
- **recvWindow** (LONG) - Optional - 
- **timestamp** (LONG) - Required - 

### Request Example
{
  "subAccount": "mexc1",
  "note": "1"
}

### Response
#### Success Response (200)
- **subAccount** (STRING) - Sub-account Name
- **note** (STRING) - Sub-account notes

#### Response Example
{
  "subAccount": "mexc1",
  "note": "1"
}
```

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

### Subscribe to spot@public.bookTicker.batch.v3.api.pb@BTCUSDT

Source: https://www.mexc.com/api-docs/spot-v3/websocket-market-streams/individual-symbol-book-ticker-streamsbatch-aggregation

Use this JSON message to subscribe to the batch book ticker stream for the BTCUSDT trading pair. The subscription method is 'SUBSCRIPTION' and the parameter format is 'spot@public.bookTicker.batch.v3.api.pb@<symbol>'.

```json
{
    "method": "SUBSCRIPTION",
    "params": [
                "spot@public.bookTicker.batch.v3.api.pb@BTCUSDT"
      ]
}
```
Tokens:
Raw