MEXC

MEXC Spot REST API

The MEXC Spot REST API (v3) provides programmatic access to MEXC's spot exchange, supporting over 1,200 cryptocurrency trading pairs. Developers can retrieve real-time and historical market data, manage orders, query account balances, and handle wallet operations including deposits, withdrawals, and address management. Authentication uses HMAC SHA256 signed requests with API key credentials provided via the X-MEXC-APIKEY header. The API enforces IP-based and UID-based rate limits of 300 and 500 weight units per 10-second window respectively.

GitHub OpenAPI

Documentation

📖
Documentation
https://mexcdevelop.github.io/apidocs/spot_v3_en/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/mexc/refs/heads/main/openapi/mexc-spot-rest-api-openapi.json

OpenAPI Specification

mexc-spot-rest-api-openapi.json Raw ↑ 
{
  "openapi": "3.0.3",
  "info": {
    "title": "MEXC Spot REST API v3",
    "description": "MEXC Spot REST API (v3) providing programmatic access to spot trading, market data, account management, and wallet operations.",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.mexc.com"
    }
  ],
  "paths": {
    "/api/v3/ping": {
      "get": {
        "tags": [
          "Market Date Endpoints"
        ],
        "summary": "Test Connectivity",
        "operationId": "test_connectivity",
        "description": "Test Connectivity",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/time": {
      "get": {
        "tags": [
          "Market Date Endpoints"
        ],
        "summary": "Check Server Time",
        "operationId": "check_server_time",
        "description": "Check Server Time",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/exchangeInfo": {
      "get": {
        "tags": [
          "Market Date Endpoints"
        ],
        "summary": "Exchange Information",
        "operationId": "exchange_information",
        "description": "Exchange Information",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/depth": {
      "get": {
        "tags": [
          "Market Date Endpoints"
        ],
        "summary": "Order Book",
        "operationId": "order_book",
        "description": "Order Book",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "description": "Symbol",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/trades": {
      "get": {
        "tags": [
          "Market Date Endpoints"
        ],
        "summary": "Recent Trades List",
        "operationId": "recent_trades_list",
        "description": "Recent Trades List",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "description": "Symbol",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/historicalTrades": {
      "get": {
        "tags": [
          "Market Date Endpoints"
        ],
        "summary": "Old Trade Lookup",
        "operationId": "old_trade_lookup",
        "description": "Old Trade Lookup",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "description": "Symbol",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/aggTrades": {
      "get": {
        "tags": [
          "Market Date Endpoints"
        ],
        "summary": "Compressed/Aggregate Trades List",
        "operationId": "compressed_aggregate_trades_list",
        "description": "Compressed/Aggregate Trades List",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/klines": {
      "get": {
        "tags": [
          "Market Date Endpoints"
        ],
        "summary": "Kline/Candlestick Data",
        "operationId": "kline_candlestick_data",
        "description": "Kline/Candlestick Data",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "description": "Symbol",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "interval",
            "in": "query",
            "description": "ENUM: Kline interval",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/avgPrice": {
      "get": {
        "tags": [
          "Market Date Endpoints"
        ],
        "summary": "Current Average Price",
        "operationId": "current_average_price",
        "description": "Current Average Price",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "description": "Symbol",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/ticker/24hr": {
      "get": {
        "tags": [
          "Market Date Endpoints"
        ],
        "summary": "24hr Ticker Price Change Statistics",
        "operationId": "24hr_ticker_price_change_statistics",
        "description": "24hr Ticker Price Change Statistics",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/ticker/price": {
      "get": {
        "tags": [
          "Market Date Endpoints"
        ],
        "summary": "Symbol Price Ticker",
        "operationId": "symbol_price_ticker",
        "description": "Symbol Price Ticker",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/ticker/bookTicker": {
      "get": {
        "tags": [
          "Market Date Endpoints"
        ],
        "summary": "Symbol Order Book Ticker",
        "operationId": "symbol_order_book_ticker",
        "description": "Symbol Order Book Ticker",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/defaultSymbols": {
      "get": {
        "tags": [
          "Market Date Endpoints"
        ],
        "summary": "Default Symbols",
        "operationId": "default_symbols",
        "description": "Default Symbols",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/order/test": {
      "post": {
        "tags": [
          "Spot Account/Trade"
        ],
        "summary": "Test New Order",
        "operationId": "test_new_order",
        "description": "Test New Order",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "description": "Symbol",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "side",
            "in": "query",
            "description": "ENUM\uff1aOrder Side",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "type",
            "in": "query",
            "description": "ENUM\uff1aOrder Type",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "quantity",
            "in": "query",
            "description": "Quantity",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "price",
            "in": "query",
            "description": "Price",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "timestamp",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "signature",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/order": {
      "post": {
        "tags": [
          "Spot Account/Trade"
        ],
        "summary": "New Order",
        "operationId": "new_order",
        "description": "New Order",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "description": "Symbol",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "side",
            "in": "query",
            "description": "ENUM\uff1aOrder Side",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "type",
            "in": "query",
            "description": "ENUM\uff1aOrder Type ",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "quantity",
            "in": "query",
            "description": "Quantity",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "price",
            "in": "query",
            "description": "Price",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "timestamp",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "signature",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {}
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      },
      "delete": {
        "tags": [
          "Spot Account/Trade"
        ],
        "summary": "Cancel Orde",
        "operationId": "cancel_orde",
        "description": "Cancel Orde",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "description": "Symbol",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "orderId",
            "in": "query",
            "description": "Order id",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "timestamp",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "signature",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      },
      "get": {
        "tags": [
          "Spot Account/Trade"
        ],
        "summary": "Query Order",
        "operationId": "query_order",
        "description": "Query Order",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "description": "Symbol",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "orderId",
            "in": "query",
            "description": "Order id",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "timestamp",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "signature",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/openOrders": {
      "delete": {
        "tags": [
          "Spot Account/Trade"
        ],
        "summary": "Cancel all Open Orders on a Symbol",
        "operationId": "cancel_all_open_orders_on_a_symbol",
        "description": "Cancel all Open Orders on a Symbol",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "description": "Symbol",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "timestamp",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "signature",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      },
      "get": {
        "tags": [
          "Spot Account/Trade"
        ],
        "summary": "Current Open Orders",
        "operationId": "current_open_orders",
        "description": "Current Open Orders",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "description": "Symbol",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "timestamp",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "signature",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/allOrders": {
      "get": {
        "tags": [
          "Spot Account/Trade"
        ],
        "summary": "All Orders",
        "operationId": "all_orders",
        "description": "All Orders",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "description": "Symbol",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "timestamp",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "signature",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/account": {
      "get": {
        "tags": [
          "Spot Account/Trade"
        ],
        "summary": "Account Information",
        "operationId": "account_information",
        "description": "Account Information",
        "parameters": [
          {
            "name": "timestamp",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "signature",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/myTrades": {
      "get": {
        "tags": [
          "Spot Account/Trade"
        ],
        "summary": "Account Trade List",
        "operationId": "account_trade_list",
        "description": "Account Trade List",
        "parameters": [
          {
            "name": "symbol",
            "in": "query",
            "description": "Symbol",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "timestamp",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "signature",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "recvWindow",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/selfSymbols": {
      "get": {
        "tags": [
          "Spot Account/Trade"
        ],
        "summary": "Query Self Symbols",
        "operationId": "query_self_symbols",
        "description": "Query Self Symbols",
        "parameters": [
          {
            "name": "timestamp",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "signature",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/mxDeduct/enable": {
      "post": {
        "tags": [
          "Spot Account/Trade"
        ],
        "summary": "MxDeduct enable",
        "operationId": "mxdeduct_enable",
        "description": "MxDeduct enable",
        "parameters": [
          {
            "name": "mxDeductEnable",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "timestamp",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "signature",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {}
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      },
      "get": {
        "tags": [
          "Spot Account/Trade"
        ],
        "summary": "Query MxDeduct",
        "operationId": "query_mxdeduct",
        "description": "Query MxDeduct",
        "parameters": [
          {
            "name": "timestamp",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "signature",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/etf/info": {
      "get": {
        "tags": [
          "EFT"
        ],
        "summary": "ETF info",
        "operationId": "etf_info",
        "description": "ETF info",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/capital/withdraw/apply": {
      "post": {
        "tags": [
          "Wallet"
        ],
        "summary": "Withdraw Apply",
        "operationId": "withdraw_apply",
        "description": "Withdraw Apply",
        "parameters": [
          {
            "name": "coin",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "network",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "address",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "amount",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "signature",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "timestamp",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/capital/deposit/hisrec": {
      "get": {
        "tags": [
          "Wallet"
        ],
        "summary": "Query Deposit Hisrec",
        "operationId": "query_deposit_hisrec",
        "description": "Query Deposit Hisrec",
        "parameters": [
          {
            "name": "coin",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "signature",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "timestamp",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ]
      }
    },
    "/api/v3/capital/config/getall": {
      "get": {
        "tags": [
          "Wallet"
        ],
        "summary": "Query All Coins",
        "operationId": "query_all_coins",
        "description": "Query All Coins",
        "parameters": [
          {
            "name": "signature",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "timestamp",
            "in": "query",
            "description": "",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
      

# --- truncated at 32 KB (95 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mexc/refs/heads/main/openapi/mexc-spot-rest-api-openapi.json