ccxt 4.4.30__py2.py3-none-any.whl → 4.4.31__py2.py3-none-any.whl

ccxt/async_support/mexc.py

@@ -832,8 +832,10 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_status(self, params={}):
         """
         the latest known information on the availability of the exchange API
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#test-connectivity
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-the-server-time
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#test-connectivity
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-the-server-time
+
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: a `status structure <https://docs.ccxt.com/#/?id=exchange-status-structure>`
         """
@@ -867,8 +869,10 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_time(self, params={}):
         """
         fetches the current integer timestamp in milliseconds from the exchange server
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#check-server-time
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-the-server-time
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#check-server-time
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-the-server-time
+
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns int: the current integer timestamp in milliseconds from the exchange server
         """
@@ -891,7 +895,9 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_currencies(self, params={}) -> Currencies:
         """
         fetches all available currencies on an exchange
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#query-the-currency-information
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#query-the-currency-information
+
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: an associative dictionary of currencies
         """
@@ -1025,8 +1031,10 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_markets(self, params={}) -> List[Market]:
         """
         retrieves data on all markets for mexc
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#exchange-information
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-the-contract-information
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#exchange-information
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-the-contract-information
+
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict[]: an array of objects representing market data
         """
@@ -1039,9 +1047,11 @@ class mexc(Exchange, ImplicitAPI):
 
     async def fetch_spot_markets(self, params={}):
         """
-         * @ignore
+ @ignore
         retrieves data on all spot markets for mexc
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#exchange-information
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#exchange-information
+
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict[]: an array of objects representing market data
         """
@@ -1161,9 +1171,11 @@ class mexc(Exchange, ImplicitAPI):
 
     async def fetch_swap_markets(self, params={}):
         """
-         * @ignore
+ @ignore
         retrieves data on all swap markets for mexc
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-the-contract-information
+
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-the-contract-information
+
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict[]: an array of objects representing market data
         """
@@ -1282,8 +1294,10 @@ class mexc(Exchange, ImplicitAPI):
 
     async def fetch_order_book(self, symbol: str, limit: Int = None, params={}) -> OrderBook:
         """
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#order-book
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-the-contract-s-depth-information
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#order-book
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-the-contract-s-depth-information
+
         fetches information on open orders with bid(buy) and ask(sell) prices, volumes and other data
         :param str symbol: unified symbol of the market to fetch the order book for
         :param int [limit]: the maximum amount of order book entries to return
@@ -1353,9 +1367,11 @@ class mexc(Exchange, ImplicitAPI):
 
     async def fetch_trades(self, symbol: str, since: Int = None, limit: Int = None, params={}) -> List[Trade]:
         """
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#recent-trades-list
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#compressed-aggregate-trades-list
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-contract-transaction-data
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#recent-trades-list
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#compressed-aggregate-trades-list
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-contract-transaction-data
+
         get the list of most recent trades for a particular symbol
         :param str symbol: unified symbol of the market to fetch trades for
         :param int [since]: timestamp in ms of the earliest trade to fetch
@@ -1601,8 +1617,10 @@ class mexc(Exchange, ImplicitAPI):
 
     async def fetch_ohlcv(self, symbol: str, timeframe='1m', since: Int = None, limit: Int = None, params={}) -> List[list]:
         """
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#kline-candlestick-data
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#k-line-data
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#kline-candlestick-data
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#k-line-data
+
         fetches historical candlestick data containing the open, high, low, and close price, and the volume of a market
         :param str symbol: unified symbol of the market to fetch OHLCV data for
         :param str timeframe: the length of time each candle represents
@@ -1709,8 +1727,10 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_tickers(self, symbols: Strings = None, params={}) -> Tickers:
         """
         fetches price tickers for multiple markets, statistical information calculated over the past 24 hours for each market
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#24hr-ticker-price-change-statistics
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-contract-trend-data
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#24hr-ticker-price-change-statistics
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-contract-trend-data
+
         :param str[]|None symbols: unified symbols of the markets to fetch the ticker for, all market tickers are returned if not assigned
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: a dictionary of `ticker structures <https://docs.ccxt.com/#/?id=ticker-structure>`
@@ -1792,8 +1812,10 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_ticker(self, symbol: str, params={}) -> Ticker:
         """
         fetches a price ticker, a statistical calculation with the information calculated over the past 24 hours for a specific market
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#24hr-ticker-price-change-statistics
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-contract-trend-data
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#24hr-ticker-price-change-statistics
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-contract-trend-data
+
         :param str symbol: unified symbol of the market to fetch the ticker for
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: a `ticker structure <https://docs.ccxt.com/#/?id=ticker-structure>`
@@ -1976,7 +1998,9 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_bids_asks(self, symbols: Strings = None, params={}):
         """
         fetches the bid and ask price and volume for multiple markets
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#symbol-order-book-ticker
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#symbol-order-book-ticker
+
         :param str[]|None symbols: unified symbols of the markets to fetch the bids and asks for, all markets are returned if not assigned
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: a dictionary of `ticker structures <https://docs.ccxt.com/#/?id=ticker-structure>`
@@ -2013,7 +2037,9 @@ class mexc(Exchange, ImplicitAPI):
     async def create_market_buy_order_with_cost(self, symbol: str, cost: float, params={}):
         """
         create a market buy order by providing the symbol and cost
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#new-order
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#new-order
+
         :param str symbol: unified symbol of the market to create an order in
         :param float cost: how much you want to trade in units of the quote currency
         :param dict [params]: extra parameters specific to the exchange API endpoint
@@ -2029,7 +2055,9 @@ class mexc(Exchange, ImplicitAPI):
     async def create_market_sell_order_with_cost(self, symbol: str, cost: float, params={}):
         """
         create a market sell order by providing the symbol and cost
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#new-order
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#new-order
+
         :param str symbol: unified symbol of the market to create an order in
         :param float cost: how much you want to trade in units of the quote currency
         :param dict [params]: extra parameters specific to the exchange API endpoint
@@ -2045,9 +2073,11 @@ class mexc(Exchange, ImplicitAPI):
     async def create_order(self, symbol: str, type: OrderType, side: OrderSide, amount: float, price: Num = None, params={}):
         """
         create a trade order
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#new-order
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#order-under-maintenance
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#trigger-order-under-maintenance
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#new-order
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#order-under-maintenance
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#trigger-order-under-maintenance
+
         :param str symbol: unified symbol of the market to create an order in
         :param str type: 'market' or 'limit'
         :param str side: 'buy' or 'sell'
@@ -2059,8 +2089,8 @@ class mexc(Exchange, ImplicitAPI):
         :param bool [params.postOnly]: if True, the order will only be posted if it will be a maker order
         :param bool [params.reduceOnly]: *contract only* indicates if self order is to reduce the size of a position
         :param bool [params.hedged]: *swap only* True for hedged mode, False for one way mode, default is False
-         *
-         * EXCHANGE SPECIFIC PARAMETERS
+
+ EXCHANGE SPECIFIC PARAMETERS
         :param int [params.leverage]: *contract only* leverage is necessary on isolated margin
         :param long [params.positionId]: *contract only* it is recommended to hasattr(self, fill) parameter when closing a position
         :param str [params.externalOid]: *contract only* external order ID
@@ -2118,16 +2148,18 @@ class mexc(Exchange, ImplicitAPI):
 
     async def create_spot_order(self, market, type, side, amount, price=None, marginMode=None, params={}):
         """
-         * @ignore
+ @ignore
         create a trade order
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#new-order
-        :param str symbol: unified symbol of the market to create an order in
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#new-order
+
+        :param str market: unified symbol of the market to create an order in
         :param str type: 'market' or 'limit'
         :param str side: 'buy' or 'sell'
         :param float amount: how much of currency you want to trade in units of base currency
         :param float [price]: the price at which the order is to be fulfilled, in units of the quote currency, ignored in market orders
+        :param str [marginMode]: only 'isolated' is supported for spot-margin trading
         :param dict [params]: extra parameters specific to the exchange API endpoint
-        :param str [params.marginMode]: only 'isolated' is supported for spot-margin trading
         :param float [params.triggerPrice]: The price at which a trigger order is triggered at
         :param bool [params.postOnly]: if True, the order will only be posted if it will be a maker order
         :returns dict: an `order structure <https://docs.ccxt.com/#/?id=order-structure>`
@@ -2171,24 +2203,26 @@ class mexc(Exchange, ImplicitAPI):
 
     async def create_swap_order(self, market, type, side, amount, price=None, marginMode=None, params={}):
         """
-         * @ignore
+ @ignore
         create a trade order
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#new-order
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#order-under-maintenance
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#trigger-order-under-maintenance
-        :param str symbol: unified symbol of the market to create an order in
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#new-order
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#order-under-maintenance
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#trigger-order-under-maintenance
+
+        :param str market: unified symbol of the market to create an order in
         :param str type: 'market' or 'limit'
         :param str side: 'buy' or 'sell'
         :param float amount: how much of currency you want to trade in units of base currency
         :param float [price]: the price at which the order is to be fulfilled, in units of the quote currency, ignored in market orders
+        :param str [marginMode]: only 'isolated' is supported for spot-margin trading
         :param dict [params]: extra parameters specific to the exchange API endpoint
-        :param str [params.marginMode]: only 'isolated' is supported for spot-margin trading
         :param float [params.triggerPrice]: The price at which a trigger order is triggered at
         :param bool [params.postOnly]: if True, the order will only be posted if it will be a maker order
         :param bool [params.reduceOnly]: indicates if self order is to reduce the size of a position
         :param bool [params.hedged]: *swap only* True for hedged mode, False for one way mode, default is False
-         *
-         * EXCHANGE SPECIFIC PARAMETERS
+
+ EXCHANGE SPECIFIC PARAMETERS
         :param int [params.leverage]: leverage is necessary on isolated margin
         :param long [params.positionId]: it is recommended to hasattr(self, fill) parameter when closing a position
         :param str [params.externalOid]: external order ID
@@ -2296,7 +2330,9 @@ class mexc(Exchange, ImplicitAPI):
     async def create_orders(self, orders: List[OrderRequest], params={}):
         """
         *spot only*  *all orders must have the same symbol* create a list of trade orders
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#batch-orders
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#batch-orders
+
         :param Array orders: list of orders to create, each object should contain the parameters required by createOrder, namely symbol, type, side, amount, price and params
         :param dict [params]: extra parameters specific to api endpoint
         :returns dict: an `order structure <https://docs.ccxt.com/#/?id=order-structure>`
@@ -2353,8 +2389,11 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_order(self, id: str, symbol: Str = None, params={}):
         """
         fetches information on an order made by the user
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#query-order
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#query-the-order-based-on-the-order-number
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#query-order
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#query-the-order-based-on-the-order-number
+
+        :param str id: order id
         :param str symbol: unified symbol of the market the order was made in
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :param str [params.marginMode]: only 'isolated' is supported, for spot-margin trading
@@ -2467,9 +2506,11 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_orders(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}) -> List[Order]:
         """
         fetches information on multiple orders made by the user
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#all-orders
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-all-of-the-user-39-s-historical-orders
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#gets-the-trigger-order-list
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#all-orders
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-all-of-the-user-39-s-historical-orders
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#gets-the-trigger-order-list
+
         :param str symbol: unified market symbol of the market orders were made in
         :param int [since]: the earliest time in ms to fetch orders for
         :param int [limit]: the maximum number of order structures to retrieve
@@ -2696,9 +2737,11 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_open_orders(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}) -> List[Order]:
         """
         fetch all unfilled currently open orders
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#current-open-orders
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-all-of-the-user-39-s-historical-orders
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#gets-the-trigger-order-list
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#current-open-orders
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-all-of-the-user-39-s-historical-orders
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#gets-the-trigger-order-list
+
         :param str symbol: unified market symbol
         :param int [since]: the earliest time in ms to fetch open orders for
         :param int [limit]: the maximum number of  open orders structures to retrieve
@@ -2781,9 +2824,11 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_closed_orders(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}) -> List[Order]:
         """
         fetches information on multiple closed orders made by the user
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#all-orders
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-all-of-the-user-39-s-historical-orders
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#gets-the-trigger-order-list
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#all-orders
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-all-of-the-user-39-s-historical-orders
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#gets-the-trigger-order-list
+
         :param str symbol: unified market symbol of the market orders were made in
         :param int [since]: the earliest time in ms to fetch orders for
         :param int [limit]: the maximum number of order structures to retrieve
@@ -2795,9 +2840,11 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_canceled_orders(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}):
         """
         fetches information on multiple canceled orders made by the user
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#all-orders
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-all-of-the-user-39-s-historical-orders
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#gets-the-trigger-order-list
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#all-orders
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-all-of-the-user-39-s-historical-orders
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#gets-the-trigger-order-list
+
         :param str symbol: unified market symbol of the market orders were made in
         :param int [since]: timestamp in ms of the earliest order, default is None
         :param int [limit]: max number of orders to return, default is None
@@ -2822,9 +2869,11 @@ class mexc(Exchange, ImplicitAPI):
     async def cancel_order(self, id: str, symbol: Str = None, params={}):
         """
         cancels an open order
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#cancel-order
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#cancel-the-order-under-maintenance
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#cancel-the-stop-limit-trigger-order-under-maintenance
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#cancel-order
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#cancel-the-order-under-maintenance
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#cancel-the-stop-limit-trigger-order-under-maintenance
+
         :param str id: order id
         :param str symbol: unified symbol of the market the order was made in
         :param dict [params]: extra parameters specific to the exchange API endpoint
@@ -2927,7 +2976,9 @@ class mexc(Exchange, ImplicitAPI):
     async def cancel_orders(self, ids, symbol: Str = None, params={}):
         """
         cancel multiple orders
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#cancel-the-order-under-maintenance
+
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#cancel-the-order-under-maintenance
+
         :param str[] ids: order ids
         :param str symbol: unified market symbol, default is None
         :param dict [params]: extra parameters specific to the exchange API endpoint
@@ -2959,9 +3010,11 @@ class mexc(Exchange, ImplicitAPI):
     async def cancel_all_orders(self, symbol: Str = None, params={}):
         """
         cancel all open orders
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#cancel-all-open-orders-on-a-symbol
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#cancel-all-orders-under-a-contract-under-maintenance
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#cancel-all-trigger-orders-under-maintenance
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#cancel-all-open-orders-on-a-symbol
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#cancel-all-orders-under-a-contract-under-maintenance
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#cancel-all-trigger-orders-under-maintenance
+
         :param str symbol: unified market symbol, only orders in the market of self symbol are cancelled when symbol is not None
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :param str [params.marginMode]: only 'isolated' is supported for spot-margin trading
@@ -3348,8 +3401,10 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_accounts(self, params={}) -> List[Account]:
         """
         fetch all the accounts associated with a profile
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#account-information
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-all-informations-of-user-39-s-asset
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#account-information
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-all-informations-of-user-39-s-asset
+
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: a dictionary of `account structures <https://docs.ccxt.com/#/?id=account-structure>` indexed by the account type
         """
@@ -3374,8 +3429,10 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_trading_fees(self, params={}) -> TradingFees:
         """
         fetch the trading fees for multiple markets
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#account-information
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-all-informations-of-user-39-s-asset
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#account-information
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-all-informations-of-user-39-s-asset
+
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: a dictionary of `fee structures <https://docs.ccxt.com/#/?id=fee-structure>` indexed by market symbols
         """
@@ -3515,9 +3572,11 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_balance(self, params={}) -> Balances:
         """
         query for balance and get the amount of funds available for trading or funds locked in orders
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#account-information
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-all-informations-of-user-39-s-asset
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#isolated-account
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#account-information
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-all-informations-of-user-39-s-asset
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#isolated-account
+
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :param str [params.symbols]:  # required for margin, market id's separated by commas
         :returns dict: a `balance structure <https://docs.ccxt.com/#/?id=balance-structure>`
@@ -3640,8 +3699,10 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_my_trades(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}):
         """
         fetch all trades made by the user
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#account-trade-list
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-all-transaction-details-of-the-user-s-order
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#account-trade-list
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-all-transaction-details-of-the-user-s-order
+
         :param str symbol: unified market symbol
         :param int [since]: the earliest time in ms to fetch trades for
         :param int [limit]: the maximum number of trades structures to retrieve
@@ -3728,8 +3789,10 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_order_trades(self, id: str, symbol: Str = None, since: Int = None, limit: Int = None, params={}):
         """
         fetch all the trades made from a single order
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#account-trade-list
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#query-the-order-based-on-the-order-number
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#account-trade-list
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#query-the-order-based-on-the-order-number
+
         :param str id: order id
         :param str symbol: unified market symbol
         :param int [since]: the earliest time in ms to fetch trades for
@@ -3821,7 +3884,9 @@ class mexc(Exchange, ImplicitAPI):
     async def reduce_margin(self, symbol: str, amount: float, params={}) -> MarginModification:
         """
         remove margin from a position
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#increase-or-decrease-margin
+
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#increase-or-decrease-margin
+
         :param str symbol: unified market symbol
         :param float amount: the amount of margin to remove
         :param dict [params]: extra parameters specific to the exchange API endpoint
@@ -3832,7 +3897,9 @@ class mexc(Exchange, ImplicitAPI):
     async def add_margin(self, symbol: str, amount: float, params={}) -> MarginModification:
         """
         add margin
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#increase-or-decrease-margin
+
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#increase-or-decrease-margin
+
         :param str symbol: unified market symbol
         :param float amount: amount of margin to add
         :param dict [params]: extra parameters specific to the exchange API endpoint
@@ -3843,7 +3910,9 @@ class mexc(Exchange, ImplicitAPI):
     async def set_leverage(self, leverage: Int, symbol: Str = None, params={}):
         """
         set the level of leverage for a market
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#switch-leverage
+
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#switch-leverage
+
         :param float leverage: the rate of leverage
         :param str symbol: unified market symbol
         :param dict [params]: extra parameters specific to the exchange API endpoint
@@ -3871,7 +3940,9 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_funding_history(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}):
         """
         fetch the history of funding payments paid and received on self account
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-details-of-user-s-funding-rate
+
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-details-of-user-s-funding-rate
+
         :param str symbol: unified market symbol
         :param int [since]: the earliest time in ms to fetch funding history for
         :param int [limit]: the maximum number of funding history structures to retrieve
@@ -3986,7 +4057,9 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_funding_interval(self, symbol: str, params={}) -> FundingRate:
         """
         fetch the current funding rate interval
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-contract-funding-rate
+
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-contract-funding-rate
+
         :param str symbol: unified market symbol
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: a `funding rate structure <https://docs.ccxt.com/#/?id=funding-rate-structure>`
@@ -3996,7 +4069,9 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_funding_rate(self, symbol: str, params={}) -> FundingRate:
         """
         fetch the current funding rate
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-contract-funding-rate
+
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-contract-funding-rate
+
         :param str symbol: unified market symbol
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: a `funding rate structure <https://docs.ccxt.com/#/?id=funding-rate-structure>`
@@ -4028,7 +4103,9 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_funding_rate_history(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}):
         """
         fetches historical funding rate prices
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-contract-funding-rate-history
+
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-contract-funding-rate-history
+
         :param str symbol: unified symbol of the market to fetch the funding rate history for
         :param int [since]: not used by mexc, but filtered internally by ccxt
         :param int [limit]: mexc limit is page_size default 20, maximum is 100
@@ -4092,7 +4169,9 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_leverage_tiers(self, symbols: Strings = None, params={}) -> LeverageTiers:
         """
         retrieve information on the maximum leverage, and maintenance margin for trades of varying trade sizes, if a market has a leverage tier of 0, then the leverage tiers cannot be obtained for self market
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-the-contract-information
+
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-the-contract-information
+
         :param str[] [symbols]: list of unified market symbols
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: a dictionary of `leverage tiers structures <https://docs.ccxt.com/#/?id=leverage-tiers-structure>`, indexed by market symbols
@@ -4187,6 +4266,7 @@ class mexc(Exchange, ImplicitAPI):
         #        "isHidden": False
         #    }
         #
+        marketId = self.safe_string(info, 'symbol')
         maintenanceMarginRate = self.safe_string(info, 'maintenanceMarginRate')
         initialMarginRate = self.safe_string(info, 'initialMarginRate')
         maxVol = self.safe_string(info, 'maxVol')
@@ -4200,6 +4280,7 @@ class mexc(Exchange, ImplicitAPI):
             return [
                 {
                     'tier': 0,
+                    'symbol': self.safe_symbol(marketId, market, None, 'contract'),
                     'currency': self.safe_currency_code(quoteId),
                     'minNotional': None,
                     'maxNotional': None,
@@ -4212,6 +4293,7 @@ class mexc(Exchange, ImplicitAPI):
             cap = Precise.string_add(floor, riskIncrVol)
             tiers.append({
                 'tier': self.parse_number(Precise.string_div(cap, riskIncrVol)),
+                'symbol': self.safe_symbol(marketId, market, None, 'contract'),
                 'currency': self.safe_currency_code(quoteId),
                 'minNotional': self.parse_number(floor),
                 'maxNotional': self.parse_number(cap),
@@ -4248,7 +4330,9 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_deposit_addresses_by_network(self, code: str, params={}) -> List[DepositAddress]:
         """
         fetch a dictionary of addresses for a currency, indexed by network
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#deposit-address-supporting-network
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#deposit-address-supporting-network
+
         :param str code: unified currency code of the currency for the deposit address
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: a dictionary of `address structures <https://docs.ccxt.com/#/?id=address-structure>` indexed by the network
@@ -4291,7 +4375,9 @@ class mexc(Exchange, ImplicitAPI):
     async def create_deposit_address(self, code: str, params={}):
         """
         create a currency deposit address
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#generate-deposit-address-supporting-network
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#generate-deposit-address-supporting-network
+
         :param str code: unified currency code of the currency for the deposit address
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :param str [params.network]: the blockchain network name
@@ -4330,7 +4416,9 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_deposit_address(self, code: str, params={}) -> DepositAddress:
         """
         fetch the deposit address for a currency associated with self account
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#deposit-address-supporting-network
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#deposit-address-supporting-network
+
         :param str code: unified currency code
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :param str [params.network]: the chain of currency, self only apply for multi-chain currency, and there is no need for single chain currency
@@ -4357,7 +4445,9 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_deposits(self, code: Str = None, since: Int = None, limit: Int = None, params={}) -> List[Transaction]:
         """
         fetch all deposits made to an account
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#deposit-history-supporting-network
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#deposit-history-supporting-network
+
         :param str code: unified currency code
         :param int [since]: the earliest time in ms to fetch deposits for
         :param int [limit]: the maximum number of deposits structures to retrieve
@@ -4410,7 +4500,9 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_withdrawals(self, code: Str = None, since: Int = None, limit: Int = None, params={}) -> List[Transaction]:
         """
         fetch all withdrawals made from an account
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#withdraw-history-supporting-network
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#withdraw-history-supporting-network
+
         :param str code: unified currency code
         :param int [since]: the earliest time in ms to fetch withdrawals for
         :param int [limit]: the maximum number of withdrawals structures to retrieve
@@ -4577,7 +4669,9 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_position(self, symbol: str, params={}):
         """
         fetch data on a single open contract trade position
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-the-user-s-history-position-information
+
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-the-user-s-history-position-information
+
         :param str symbol: unified market symbol of the market the position is held in, default is None
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: a `position structure <https://docs.ccxt.com/#/?id=position-structure>`
@@ -4593,7 +4687,9 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_positions(self, symbols: Strings = None, params={}):
         """
         fetch all open positions
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-the-user-s-history-position-information
+
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-the-user-s-history-position-information
+
         :param str[]|None symbols: list of unified market symbols
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict[]: a list of `position structure <https://docs.ccxt.com/#/?id=position-structure>`
@@ -4739,7 +4835,9 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_transfer(self, id: str, code: Str = None, params={}) -> TransferEntry:
         """
         fetches a transfer
-        :see: https://mexcdevelop.github.io/apidocs/spot_v2_en/#internal-assets-transfer-order-inquiry
+
+        https://mexcdevelop.github.io/apidocs/spot_v2_en/#internal-assets-transfer-order-inquiry
+
         :param str id: transfer id
         :param str [code]: not used by mexc fetchTransfer
         :param dict params: extra parameters specific to the exchange api endpoint
@@ -4774,8 +4872,10 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_transfers(self, code: Str = None, since: Int = None, limit: Int = None, params={}) -> List[TransferEntry]:
         """
         fetch a history of internal transfers made on an account
-        :see: https://mexcdevelop.github.io/apidocs/spot_v2_en/#get-internal-assets-transfer-records
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-the-user-39-s-asset-transfer-records
+
+        https://mexcdevelop.github.io/apidocs/spot_v2_en/#get-internal-assets-transfer-records
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-the-user-39-s-asset-transfer-records
+
         :param str code: unified currency code of the currency transferred
         :param int [since]: the earliest time in ms to fetch transfers for
         :param int [limit]: the maximum number of  transfers structures to retrieve
@@ -4854,7 +4954,9 @@ class mexc(Exchange, ImplicitAPI):
     async def transfer(self, code: str, amount: float, fromAccount: str, toAccount: str, params={}) -> TransferEntry:
         """
         transfer currency internally between wallets on the same account
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#user-universal-transfer
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#user-universal-transfer
+
         :param str code: unified currency code
         :param float amount: amount to transfer
         :param str fromAccount: account to transfer from
@@ -4979,7 +5081,9 @@ class mexc(Exchange, ImplicitAPI):
     async def withdraw(self, code: str, amount: float, address: str, tag=None, params={}) -> Transaction:
         """
         make a withdrawal
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#withdraw-new
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#withdraw-new
+
         :param str code: unified currency code
         :param float amount: the amount to withdraw
         :param str address: the address to withdraw to
@@ -5016,7 +5120,9 @@ class mexc(Exchange, ImplicitAPI):
     async def set_position_mode(self, hedged: bool, symbol: Str = None, params={}):
         """
         set hedged to True or False for a market
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#change-position-mode
+
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#change-position-mode
+
         :param bool hedged: set to True to use dualSidePosition
         :param str symbol: not used by mexc setPositionMode()
         :param dict [params]: extra parameters specific to the exchange API endpoint
@@ -5037,7 +5143,9 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_position_mode(self, symbol: Str = None, params={}):
         """
         fetchs the position mode, hedged or one way, hedged for binance is set identically for all linear markets or all inverse markets
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-position-mode
+
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-position-mode
+
         :param str symbol: not used by mexc fetchPositionMode
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: an object detailing whether the market is in hedged or one-way mode
@@ -5059,7 +5167,9 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_transaction_fees(self, codes: Strings = None, params={}):
         """
         fetch deposit and withdrawal fees
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#query-the-currency-information
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#query-the-currency-information
+
         :param str[]|None codes: returns fees for all currencies if None
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict[]: a list of `fee structures <https://docs.ccxt.com/#/?id=fee-structure>`
@@ -5152,7 +5262,9 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_deposit_withdraw_fees(self, codes: Strings = None, params={}):
         """
         fetch deposit and withdrawal fees
-        :see: https://mexcdevelop.github.io/apidocs/spot_v3_en/#query-the-currency-information
+
+        https://mexcdevelop.github.io/apidocs/spot_v3_en/#query-the-currency-information
+
         :param str[]|None codes: returns fees for all currencies if None
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict[]: a list of `fee structures <https://docs.ccxt.com/#/?id=fee-structure>`
@@ -5238,7 +5350,9 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_leverage(self, symbol: str, params={}) -> Leverage:
         """
         fetch the set leverage for a market
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-leverage
+
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-leverage
+
         :param str symbol: unified market symbol
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: a `leverage structure <https://docs.ccxt.com/#/?id=leverage-structure>`
@@ -5305,7 +5419,7 @@ class mexc(Exchange, ImplicitAPI):
 
     def handle_margin_mode_and_params(self, methodName, params={}, defaultValue=None):
         """
-         * @ignore
+ @ignore
         marginMode specified by params["marginMode"], self.options["marginMode"], self.options["defaultMarginMode"], params["margin"] = True or self.options["defaultType"] = 'margin'
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :param bool [params.margin]: True for trading spot-margin
@@ -5322,15 +5436,17 @@ class mexc(Exchange, ImplicitAPI):
     async def fetch_positions_history(self, symbols: Strings = None, since: Int = None, limit: Int = None, params={}) -> List[Position]:
         """
         fetches historical positions
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-the-user-s-history-position-information
+
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#get-the-user-s-history-position-information
+
         :param str[] [symbols]: unified contract symbols
         :param int [since]: not used by mexc fetchPositionsHistory
         :param int [limit]: the maximum amount of candles to fetch, default=1000
-        :param dict params: extra parameters specific to the exchange api endpoint
-         *
-         * EXCHANGE SPECIFIC PARAMETERS
-        :param int type: position type，1: long, 2: short
-        :param int page_num: current page number, default is 1
+        :param dict [params]: extra parameters specific to the exchange api endpoint
+
+ EXCHANGE SPECIFIC PARAMETERS
+        :param int [params.type]: position type，1: long, 2: short
+        :param int [params.page_num]: current page number, default is 1
         :returns dict[]: a list of `position structures <https://docs.ccxt.com/#/?id=position-structure>`
         """
         await self.load_markets()
@@ -5390,7 +5506,9 @@ class mexc(Exchange, ImplicitAPI):
     async def set_margin_mode(self, marginMode: str, symbol: Str = None, params={}):
         """
         set margin mode to 'cross' or 'isolated'
-        :see: https://mexcdevelop.github.io/apidocs/contract_v1_en/#switch-leverage
+
+        https://mexcdevelop.github.io/apidocs/contract_v1_en/#switch-leverage
+
         :param str marginMode: 'cross' or 'isolated'
         :param str [symbol]: required when there is no position, else provide params["positionId"]
         :param dict [params]: extra parameters specific to the exchange API endpoint