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

ccxt/bybit.py

@@ -1091,7 +1091,7 @@ class bybit(Exchange, ImplicitAPI):
     def enable_demo_trading(self, enable: bool):
         """
         enables or disables demo trading mode
-        :see: https://bybit-exchange.github.io/docs/v5/demo
+        https://bybit-exchange.github.io/docs/v5/demo
         :param boolean [enable]: True if demo trading should be enabled, False otherwise
         """
         if self.isSandboxModeEnabled:
@@ -1122,9 +1122,13 @@ class bybit(Exchange, ImplicitAPI):
 
     def is_unified_enabled(self, params={}):
         """
-        :see: https://bybit-exchange.github.io/docs/v5/user/apikey-info#http-request
-        :see: https://bybit-exchange.github.io/docs/v5/account/account-info
+        :param dict [params]: extra parameters specific to the exchange API endpoint
+
+        https://bybit-exchange.github.io/docs/v5/user/apikey-info#http-request
+        https://bybit-exchange.github.io/docs/v5/account/account-info
+
         returns [enableUnifiedMargin, enableUnifiedAccount] so the user can check if unified account is enabled
+        :returns any: [enableUnifiedMargin, enableUnifiedAccount]
         """
         # The API key of user id must own one of permissions will be allowed to call following API endpoints.
         # SUB UID: "Account Transfer"
@@ -1207,8 +1211,12 @@ class bybit(Exchange, ImplicitAPI):
 
     def upgrade_unified_trade_account(self, params={}):
         """
-        :see: https://bybit-exchange.github.io/docs/v5/account/upgrade-unified-account
         upgrades the account to unified trade account *warning* self is irreversible
+
+        https://bybit-exchange.github.io/docs/v5/account/upgrade-unified-account
+
+        :param dict [params]: extra parameters specific to the exchange API endpoint
+        :returns any: nothing
         """
         return self.privatePostV5AccountUpgradeToUta(params)
 
@@ -1330,7 +1338,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_time(self, params={}):
         """
         fetches the current integer timestamp in milliseconds from the exchange server
-        :see: https://bybit-exchange.github.io/docs/v5/market/time
+
+        https://bybit-exchange.github.io/docs/v5/market/time
+
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns int: the current integer timestamp in milliseconds from the exchange server
         """
@@ -1352,7 +1362,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_currencies(self, params={}) -> Currencies:
         """
         fetches all available currencies on an exchange
-        :see: https://bybit-exchange.github.io/docs/v5/asset/coin-info
+
+        https://bybit-exchange.github.io/docs/v5/asset/coin-info
+
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: an associative dictionary of currencies
         """
@@ -1477,7 +1489,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_markets(self, params={}) -> List[Market]:
         """
         retrieves data on all markets for bybit
-        :see: https://bybit-exchange.github.io/docs/v5/market/instrument
+
+        https://bybit-exchange.github.io/docs/v5/market/instrument
+
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict[]: an array of objects representing market data
         """
@@ -2068,7 +2082,9 @@ class bybit(Exchange, ImplicitAPI):
     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://bybit-exchange.github.io/docs/v5/market/tickers
+
+        https://bybit-exchange.github.io/docs/v5/market/tickers
+
         :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>`
@@ -2138,7 +2154,9 @@ class bybit(Exchange, ImplicitAPI):
     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://bybit-exchange.github.io/docs/v5/market/tickers
+
+        https://bybit-exchange.github.io/docs/v5/market/tickers
+
         :param str[] 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
         :param str [params.subType]: *contract only* 'linear', 'inverse'
@@ -2255,10 +2273,12 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_ohlcv(self, symbol: str, timeframe='1m', since: Int = None, limit: Int = None, params={}) -> List[list]:
         """
         fetches historical candlestick data containing the open, high, low, and close price, and the volume of a market
-        :see: https://bybit-exchange.github.io/docs/v5/market/kline
-        :see: https://bybit-exchange.github.io/docs/v5/market/mark-kline
-        :see: https://bybit-exchange.github.io/docs/v5/market/index-kline
-        :see: https://bybit-exchange.github.io/docs/v5/market/preimum-index-kline
+
+        https://bybit-exchange.github.io/docs/v5/market/kline
+        https://bybit-exchange.github.io/docs/v5/market/mark-kline
+        https://bybit-exchange.github.io/docs/v5/market/index-kline
+        https://bybit-exchange.github.io/docs/v5/market/preimum-index-kline
+
         :param str symbol: unified symbol of the market to fetch OHLCV data for
         :param str timeframe: the length of time each candle represents
         :param int [since]: timestamp in ms of the earliest candle to fetch
@@ -2417,7 +2437,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_funding_rates(self, symbols: Strings = None, params={}) -> FundingRates:
         """
         fetches funding rates for multiple markets
-        :see: https://bybit-exchange.github.io/docs/v5/market/tickers
+
+        https://bybit-exchange.github.io/docs/v5/market/tickers
+
         :param str[] symbols: unified symbols of the markets to fetch the funding rates for, all market funding rates are returned if not assigned
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict[]: a list of `funding rate structures <https://docs.ccxt.com/#/?id=funding-rate-structure>`
@@ -2487,7 +2509,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_funding_rate_history(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}):
         """
         fetches historical funding rate prices
-        :see: https://bybit-exchange.github.io/docs/v5/market/history-fund-rate
+
+        https://bybit-exchange.github.io/docs/v5/market/history-fund-rate
+
         :param str symbol: unified symbol of the market to fetch the funding rate history for
         :param int [since]: timestamp in ms of the earliest funding rate to fetch
         :param int [limit]: the maximum amount of `funding rate structures <https://docs.ccxt.com/#/?id=funding-rate-history-structure>` to fetch
@@ -2739,7 +2763,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_trades(self, symbol: str, since: Int = None, limit: Int = None, params={}) -> List[Trade]:
         """
         get the list of most recent trades for a particular symbol
-        :see: https://bybit-exchange.github.io/docs/v5/market/recent-trade
+
+        https://bybit-exchange.github.io/docs/v5/market/recent-trade
+
         :param str symbol: unified symbol of the market to fetch trades for
         :param int [since]: timestamp in ms of the earliest trade to fetch
         :param int [limit]: the maximum amount of trades to fetch
@@ -2794,7 +2820,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_order_book(self, symbol: str, limit: Int = None, params={}) -> OrderBook:
         """
         fetches information on open orders with bid(buy) and ask(sell) prices, volumes and other data
-        :see: https://bybit-exchange.github.io/docs/v5/market/orderbook
+
+        https://bybit-exchange.github.io/docs/v5/market/orderbook
+
         :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
         :param dict [params]: extra parameters specific to the exchange API endpoint
@@ -3007,9 +3035,11 @@ class bybit(Exchange, ImplicitAPI):
     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://bybit-exchange.github.io/docs/v5/spot-margin-normal/account-info
-        :see: https://bybit-exchange.github.io/docs/v5/asset/all-balance
-        :see: https://bybit-exchange.github.io/docs/v5/account/wallet-balance
+
+        https://bybit-exchange.github.io/docs/v5/spot-margin-normal/account-info
+        https://bybit-exchange.github.io/docs/v5/asset/all-balance
+        https://bybit-exchange.github.io/docs/v5/account/wallet-balance
+
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :param str [params.type]: wallet type, ['spot', 'swap', 'funding']
         :returns dict: a `balance structure <https://docs.ccxt.com/#/?id=balance-structure>`
@@ -3407,8 +3437,10 @@ class bybit(Exchange, ImplicitAPI):
 
     def create_market_buy_order_with_cost(self, symbol: str, cost: float, params={}):
         """
-        :see: https://bybit-exchange.github.io/docs/v5/order/create-order
         create a market buy order by providing the symbol and cost
+
+        https://bybit-exchange.github.io/docs/v5/order/create-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
@@ -3422,8 +3454,10 @@ class bybit(Exchange, ImplicitAPI):
 
     def create_market_sell_order_with_cost(self, symbol: str, cost: float, params={}):
         """
-        :see: https://bybit-exchange.github.io/docs/v5/order/create-order
         create a market sell order by providing the symbol and cost
+
+        https://bybit-exchange.github.io/docs/v5/order/create-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
@@ -3442,8 +3476,10 @@ class bybit(Exchange, ImplicitAPI):
     def create_order(self, symbol: str, type: OrderType, side: OrderSide, amount: float, price: Num = None, params={}):
         """
         create a trade order
-        :see: https://bybit-exchange.github.io/docs/v5/order/create-order
-        :see: https://bybit-exchange.github.io/docs/v5/position/trading-stop
+
+        https://bybit-exchange.github.io/docs/v5/order/create-order
+        https://bybit-exchange.github.io/docs/v5/position/trading-stop
+
         :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'
@@ -3694,8 +3730,11 @@ class bybit(Exchange, ImplicitAPI):
     def create_orders(self, orders: List[OrderRequest], params={}):
         """
         create a list of trade orders
-        :see: https://bybit-exchange.github.io/docs/v5/order/batch-place
+
+        https://bybit-exchange.github.io/docs/v5/order/batch-place
+
         :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 the exchange API endpoint
         :returns dict: an `order structure <https://docs.ccxt.com/#/?id=order-structure>`
         """
         self.load_markets()
@@ -3839,9 +3878,11 @@ class bybit(Exchange, ImplicitAPI):
     def edit_order(self, id: str, symbol: str, type: OrderType, side: OrderSide, amount: Num = None, price: Num = None, params={}):
         """
         edit a trade order
-        :see: https://bybit-exchange.github.io/docs/v5/order/amend-order
-        :see: https://bybit-exchange.github.io/docs/derivatives/unified/replace-order
-        :see: https://bybit-exchange.github.io/docs/api-explorer/derivatives/trade/contract/replace-order
+
+        https://bybit-exchange.github.io/docs/v5/order/amend-order
+        https://bybit-exchange.github.io/docs/derivatives/unified/replace-order
+        https://bybit-exchange.github.io/docs/api-explorer/derivatives/trade/contract/replace-order
+
         :param str id: cancel order id
         :param str symbol: unified symbol of the market to create an order in
         :param str type: 'market' or 'limit'
@@ -3913,7 +3954,9 @@ class bybit(Exchange, ImplicitAPI):
     def cancel_order(self, id: str, symbol: Str = None, params={}):
         """
         cancels an open order
-        :see: https://bybit-exchange.github.io/docs/v5/order/cancel-order
+
+        https://bybit-exchange.github.io/docs/v5/order/cancel-order
+
         :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
@@ -3946,7 +3989,9 @@ class bybit(Exchange, ImplicitAPI):
     def cancel_orders(self, ids, symbol: Str = None, params={}):
         """
         cancel multiple orders
-        :see: https://bybit-exchange.github.io/docs/v5/order/batch-cancel
+
+        https://bybit-exchange.github.io/docs/v5/order/batch-cancel
+
         :param str[] ids: order ids
         :param str symbol: unified symbol of the market the order was made in
         :param dict [params]: extra parameters specific to the exchange API endpoint
@@ -4025,7 +4070,9 @@ class bybit(Exchange, ImplicitAPI):
     def cancel_all_orders_after(self, timeout: Int, params={}):
         """
         dead man's switch, cancel all orders after the given timeout
-        :see: https://bybit-exchange.github.io/docs/v5/order/dcp
+
+        https://bybit-exchange.github.io/docs/v5/order/dcp
+
         :param number timeout: time in milliseconds
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :param str [params.product]: OPTIONS, DERIVATIVES, SPOT, default is 'DERIVATIVES'
@@ -4056,7 +4103,9 @@ class bybit(Exchange, ImplicitAPI):
     def cancel_orders_for_symbols(self, orders: List[CancellationRequest], params={}):
         """
         cancel multiple orders for multiple symbols
-        :see: https://bybit-exchange.github.io/docs/v5/order/batch-cancel
+
+        https://bybit-exchange.github.io/docs/v5/order/batch-cancel
+
         :param CancellationRequest[] orders: list of order ids with symbol, example [{"id": "a", "symbol": "BTC/USDT"}, {"id": "b", "symbol": "ETH/USDT"}]
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: an list of `order structures <https://docs.ccxt.com/#/?id=order-structure>`
@@ -4136,7 +4185,9 @@ class bybit(Exchange, ImplicitAPI):
     def cancel_all_orders(self, symbol: Str = None, params={}):
         """
         cancel all open orders
-        :see: https://bybit-exchange.github.io/docs/v5/order/cancel-all
+
+        https://bybit-exchange.github.io/docs/v5/order/cancel-all
+
         :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 boolean [params.trigger]: True if trigger order
@@ -4207,7 +4258,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_order_classic(self, id: str, symbol: Str = None, params={}):
         """
         fetches information on an order made by the user *classic accounts only*
-        :see: https://bybit-exchange.github.io/docs/v5/order/order-list
+
+        https://bybit-exchange.github.io/docs/v5/order/order-list
+
         :param str id: the 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
@@ -4234,8 +4287,10 @@ class bybit(Exchange, ImplicitAPI):
 
     def fetch_order(self, id: str, symbol: Str = None, params={}) -> Order:
         """
-         *classic accounts only/ spot not supported*  fetches information on an order made by the user *classic accounts only*
-        :see: https://bybit-exchange.github.io/docs/v5/order/order-list
+classic accounts only/ spot not supported*  fetches information on an order made by the user *classic accounts only*
+
+        https://bybit-exchange.github.io/docs/v5/order/order-list
+
         :param str id: the 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
@@ -4325,7 +4380,7 @@ class bybit(Exchange, ImplicitAPI):
         res = self.is_unified_enabled()
         """
         *classic accounts only/ spot not supported* fetches information on multiple orders made by the user *classic accounts only/ spot not supported*
-        :see: https://bybit-exchange.github.io/docs/v5/order/order-list
+        https://bybit-exchange.github.io/docs/v5/order/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
@@ -4347,7 +4402,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_orders_classic(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}) -> List[Order]:
         """
         fetches information on multiple orders made by the user *classic accounts only*
-        :see: https://bybit-exchange.github.io/docs/v5/order/order-list
+
+        https://bybit-exchange.github.io/docs/v5/order/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
@@ -4446,7 +4503,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_closed_order(self, id: str, symbol: Str = None, params={}):
         """
         fetches information on a closed order made by the user
-        :see: https://bybit-exchange.github.io/docs/v5/order/order-list
+
+        https://bybit-exchange.github.io/docs/v5/order/order-list
+
         :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
@@ -4474,7 +4533,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_open_order(self, id: str, symbol: Str = None, params={}):
         """
         fetches information on an open order made by the user
-        :see: https://bybit-exchange.github.io/docs/v5/order/open-order
+
+        https://bybit-exchange.github.io/docs/v5/order/open-order
+
         :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
@@ -4504,7 +4565,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_canceled_and_closed_orders(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}) -> List[Order]:
         """
         fetches information on multiple canceled and closed orders made by the user
-        :see: https://bybit-exchange.github.io/docs/v5/order/order-list
+
+        https://bybit-exchange.github.io/docs/v5/order/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
@@ -4601,7 +4664,9 @@ class bybit(Exchange, ImplicitAPI):
     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://bybit-exchange.github.io/docs/v5/order/order-list
+
+        https://bybit-exchange.github.io/docs/v5/order/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
@@ -4624,7 +4689,9 @@ class bybit(Exchange, ImplicitAPI):
     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://bybit-exchange.github.io/docs/v5/order/order-list
+
+        https://bybit-exchange.github.io/docs/v5/order/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
@@ -4647,7 +4714,9 @@ class bybit(Exchange, ImplicitAPI):
     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://bybit-exchange.github.io/docs/v5/order/open-order
+
+        https://bybit-exchange.github.io/docs/v5/order/open-order
+
         :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
@@ -4743,7 +4812,9 @@ class bybit(Exchange, ImplicitAPI):
     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://bybit-exchange.github.io/docs/v5/position/execution
+
+        https://bybit-exchange.github.io/docs/v5/position/execution
+
         :param str id: order id
         :param str symbol: unified market symbol
         :param int [since]: the earliest time in ms to fetch trades for
@@ -4763,7 +4834,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_my_trades(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}):
         """
         fetch all trades made by the user
-        :see: https://bybit-exchange.github.io/docs/api-explorer/v5/position/execution
+
+        https://bybit-exchange.github.io/docs/api-explorer/v5/position/execution
+
         :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
@@ -4862,7 +4935,9 @@ class bybit(Exchange, ImplicitAPI):
     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://bybit-exchange.github.io/docs/v5/asset/master-deposit-addr
+
+        https://bybit-exchange.github.io/docs/v5/asset/master-deposit-addr
+
         :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
@@ -4904,7 +4979,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_deposit_address(self, code: str, params={}) -> DepositAddress:
         """
         fetch the deposit address for a currency associated with self account
-        :see: https://bybit-exchange.github.io/docs/v5/asset/master-deposit-addr
+
+        https://bybit-exchange.github.io/docs/v5/asset/master-deposit-addr
+
         :param str code: unified currency code
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: an `address structure <https://docs.ccxt.com/#/?id=address-structure>`
@@ -4948,13 +5025,15 @@ class bybit(Exchange, ImplicitAPI):
     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://bybit-exchange.github.io/docs/v5/asset/deposit-record
+
+        https://bybit-exchange.github.io/docs/v5/asset/deposit-record
+
         :param str code: unified currency code
         :param int [since]: the earliest time in ms to fetch deposits for, default = 30 days before the current time
         :param int [limit]: the maximum number of deposits structures to retrieve, default = 50, max = 50
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :param int [params.until]: the latest time in ms to fetch deposits for, default = 30 days after since
-         * EXCHANGE SPECIFIC PARAMETERS
+ EXCHANGE SPECIFIC PARAMETERS
         :param boolean [params.paginate]: default False, when True will automatically paginate by calling self endpoint multiple times. See in the docs all the [availble parameters](https://github.com/ccxt/ccxt/wiki/Manual#pagination-params)
         :param str [params.cursor]: used for pagination
         :returns dict[]: a list of `transaction structures <https://docs.ccxt.com/#/?id=transaction-structure>`
@@ -5012,7 +5091,9 @@ class bybit(Exchange, ImplicitAPI):
     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://bybit-exchange.github.io/docs/v5/asset/withdraw-record
+
+        https://bybit-exchange.github.io/docs/v5/asset/withdraw-record
+
         :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
@@ -5185,14 +5266,16 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_ledger(self, code: Str = None, since: Int = None, limit: Int = None, params={}) -> List[LedgerEntry]:
         """
         fetch the history of changes, actions done by the user or operations that altered the balance of the user
-        :see: https://bybit-exchange.github.io/docs/v5/account/transaction-log
-        :see: https://bybit-exchange.github.io/docs/v5/account/contract-transaction-log
+
+        https://bybit-exchange.github.io/docs/v5/account/transaction-log
+        https://bybit-exchange.github.io/docs/v5/account/contract-transaction-log
+
         :param str [code]: unified currency code, default is None
         :param int [since]: timestamp in ms of the earliest ledger entry, default is None
         :param int [limit]: max number of ledger entries to return, default is None
+        :param dict [params]: extra parameters specific to the exchange API endpoint
         :param boolean [params.paginate]: default False, when True will automatically paginate by calling self endpoint multiple times. See in the docs all the [available parameters](https://github.com/ccxt/ccxt/wiki/Manual#pagination-params)
         :param str [params.subType]: if inverse will use v5/account/contract-transaction-log
-        :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: a `ledger structure <https://docs.ccxt.com/#/?id=ledger-structure>`
         """
         self.load_markets()
@@ -5453,7 +5536,9 @@ class bybit(Exchange, ImplicitAPI):
     def withdraw(self, code: str, amount: float, address: str, tag=None, params={}) -> Transaction:
         """
         make a withdrawal
-        :see: https://bybit-exchange.github.io/docs/v5/asset/withdraw
+
+        https://bybit-exchange.github.io/docs/v5/asset/withdraw
+
         :param str code: unified currency code
         :param float amount: the amount to withdraw
         :param str address: the address to withdraw to
@@ -5498,7 +5583,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_position(self, symbol: str, params={}):
         """
         fetch data on a single open contract trade position
-        :see: https://bybit-exchange.github.io/docs/v5/position
+
+        https://bybit-exchange.github.io/docs/v5/position
+
         :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>`
@@ -5567,7 +5654,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_positions(self, symbols: Strings = None, params={}):
         """
         fetch all open positions
-        :see: https://bybit-exchange.github.io/docs/v5/position
+
+        https://bybit-exchange.github.io/docs/v5/position
+
         :param str[] symbols: list of unified market symbols
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :param str [params.type]: market type, ['swap', 'option', 'spot']
@@ -5888,7 +5977,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_leverage(self, symbol: str, params={}) -> Leverage:
         """
         fetch the set leverage for a market
-        :see: https://bybit-exchange.github.io/docs/v5/position
+
+        https://bybit-exchange.github.io/docs/v5/position
+
         :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>`
@@ -5912,8 +6003,10 @@ class bybit(Exchange, ImplicitAPI):
     def set_margin_mode(self, marginMode: str, symbol: Str = None, params={}):
         """
         set margin mode(account) or trade mode(symbol)
-        :see: https://bybit-exchange.github.io/docs/v5/account/set-margin-mode
-        :see: https://bybit-exchange.github.io/docs/v5/position/cross-isolate
+
+        https://bybit-exchange.github.io/docs/v5/account/set-margin-mode
+        https://bybit-exchange.github.io/docs/v5/position/cross-isolate
+
         :param str marginMode: account mode must be either [isolated, cross, portfolio], trade mode must be either [isolated, cross]
         :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
@@ -5994,7 +6087,9 @@ class bybit(Exchange, ImplicitAPI):
     def set_leverage(self, leverage: Int, symbol: Str = None, params={}):
         """
         set the level of leverage for a market
-        :see: https://bybit-exchange.github.io/docs/v5/position/leverage
+
+        https://bybit-exchange.github.io/docs/v5/position/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
@@ -6030,7 +6125,9 @@ class bybit(Exchange, ImplicitAPI):
     def set_position_mode(self, hedged: bool, symbol: Str = None, params={}):
         """
         set hedged to True or False for a market
-        :see: https://bybit-exchange.github.io/docs/v5/position/position-mode
+
+        https://bybit-exchange.github.io/docs/v5/position/position-mode
+
         :param bool hedged:
         :param str symbol: used for unified account with inverse market
         :param dict [params]: extra parameters specific to the exchange API endpoint
@@ -6126,7 +6223,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_open_interest(self, symbol: str, params={}):
         """
         Retrieves the open interest of a derivative trading pair
-        :see: https://bybit-exchange.github.io/docs/v5/market/open-interest
+
+        https://bybit-exchange.github.io/docs/v5/market/open-interest
+
         :param str symbol: Unified CCXT market symbol
         :param dict [params]: exchange specific parameters
         :param str [params.interval]: 5m, 15m, 30m, 1h, 4h, 1d
@@ -6182,7 +6281,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_open_interest_history(self, symbol: str, timeframe='1h', since: Int = None, limit: Int = None, params={}):
         """
         Gets the total amount of unsettled contracts. In other words, the total number of contracts held in open positions
-        :see: https://bybit-exchange.github.io/docs/v5/market/open-interest
+
+        https://bybit-exchange.github.io/docs/v5/market/open-interest
+
         :param str symbol: Unified market symbol
         :param str timeframe: "5m", 15m, 30m, 1h, 4h, 1d
         :param int [since]: Not used by Bybit
@@ -6230,7 +6331,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_cross_borrow_rate(self, code: str, params={}) -> CrossBorrowRate:
         """
         fetch the rate of interest to borrow a currency for margin trading
-        :see: https://bybit-exchange.github.io/docs/zh-TW/v5/spot-margin-normal/interest-quota
+
+        https://bybit-exchange.github.io/docs/zh-TW/v5/spot-margin-normal/interest-quota
+
         :param str code: unified currency code
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: a `borrow rate structure <https://docs.ccxt.com/#/?id=borrow-rate-structure>`
@@ -6294,7 +6397,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_borrow_interest(self, code: Str = None, symbol: Str = None, since: Int = None, limit: Int = None, params={}) -> List[BorrowInterest]:
         """
         fetch the interest owed by the user for borrowing currency for margin trading
-        :see: https://bybit-exchange.github.io/docs/zh-TW/v5/spot-margin-normal/account-info
+
+        https://bybit-exchange.github.io/docs/zh-TW/v5/spot-margin-normal/account-info
+
         :param str code: unified currency code
         :param str symbol: unified market symbol when fetch interest in isolated markets
         :param number [since]: the earliest time in ms to fetch borrrow interest for
@@ -6338,7 +6443,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_borrow_rate_history(self, code: str, since: Int = None, limit: Int = None, params={}):
         """
         retrieves a history of a currencies borrow interest rate at specific time slots
-        :see: https://bybit-exchange.github.io/docs/v5/spot-margin-uta/historical-interest
+
+        https://bybit-exchange.github.io/docs/v5/spot-margin-uta/historical-interest
+
         :param str code: unified currency code
         :param int [since]: timestamp for the earliest borrow rate
         :param int [limit]: the maximum number of `borrow rate structures <https://docs.ccxt.com/#/?id=borrow-rate-structure>` to retrieve
@@ -6408,7 +6515,9 @@ class bybit(Exchange, ImplicitAPI):
     def transfer(self, code: str, amount: float, fromAccount: str, toAccount: str, params={}) -> TransferEntry:
         """
         transfer currency internally between wallets on the same account
-        :see: https://bybit-exchange.github.io/docs/v5/asset/create-inter-transfer
+
+        https://bybit-exchange.github.io/docs/v5/asset/create-inter-transfer
+
         :param str code: unified currency code
         :param float amount: amount to transfer
         :param str fromAccount: account to transfer from
@@ -6459,7 +6568,9 @@ class bybit(Exchange, ImplicitAPI):
     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://bybit-exchange.github.io/docs/v5/asset/inter-transfer-list
+
+        https://bybit-exchange.github.io/docs/v5/asset/inter-transfer-list
+
         :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 transfer structures to retrieve
@@ -6512,7 +6623,9 @@ class bybit(Exchange, ImplicitAPI):
     def borrow_cross_margin(self, code: str, amount: float, params={}):
         """
         create a loan to borrow margin
-        :see: https://bybit-exchange.github.io/docs/v5/spot-margin-normal/borrow
+
+        https://bybit-exchange.github.io/docs/v5/spot-margin-normal/borrow
+
         :param str code: unified currency code of the currency to borrow
         :param float amount: the amount to borrow
         :param dict [params]: extra parameters specific to the exchange API endpoint
@@ -6546,7 +6659,9 @@ class bybit(Exchange, ImplicitAPI):
     def repay_cross_margin(self, code: str, amount, params={}):
         """
         repay borrowed margin and interest
-        :see: https://bybit-exchange.github.io/docs/v5/spot-margin-normal/repay
+
+        https://bybit-exchange.github.io/docs/v5/spot-margin-normal/repay
+
         :param str code: unified currency code of the currency to repay
         :param float amount: the amount to repay
         :param dict [params]: extra parameters specific to the exchange API endpoint
@@ -6648,7 +6763,7 @@ class bybit(Exchange, ImplicitAPI):
             'status': self.parse_transfer_status(self.safe_string(transfer, 'status')),
         }
 
-    def fetch_derivatives_market_leverage_tiers(self, symbol: str, params={}):
+    def fetch_derivatives_market_leverage_tiers(self, symbol: str, params={}) -> List[LeverageTier]:
         self.load_markets()
         market = self.market(symbol)
         request: dict = {
@@ -6689,7 +6804,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_market_leverage_tiers(self, symbol: str, params={}) -> List[LeverageTier]:
         """
         retrieve information on the maximum leverage, and maintenance margin for trades of varying trade sizes for a single market
-        :see: https://bybit-exchange.github.io/docs/v5/market/risk-limit
+
+        https://bybit-exchange.github.io/docs/v5/market/risk-limit
+
         :param str symbol: unified market symbol
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: a `leverage tiers structure <https://docs.ccxt.com/#/?id=leverage-tiers-structure>`
@@ -6726,7 +6843,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_trading_fee(self, symbol: str, params={}) -> TradingFeeInterface:
         """
         fetch the trading fees for a market
-        :see: https://bybit-exchange.github.io/docs/v5/account/fee-rate
+
+        https://bybit-exchange.github.io/docs/v5/account/fee-rate
+
         :param str symbol: unified market symbol
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: a `fee structure <https://docs.ccxt.com/#/?id=fee-structure>`
@@ -6772,7 +6891,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_trading_fees(self, params={}) -> TradingFees:
         """
         fetch the trading fees for multiple markets
-        :see: https://bybit-exchange.github.io/docs/v5/account/fee-rate
+
+        https://bybit-exchange.github.io/docs/v5/account/fee-rate
+
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :param str [params.type]: market type, ['swap', 'option', 'spot']
         :returns dict: a dictionary of `fee structures <https://docs.ccxt.com/#/?id=fee-structure>` indexed by market symbols
@@ -6862,7 +6983,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_deposit_withdraw_fees(self, codes: Strings = None, params={}):
         """
         fetch deposit and withdraw fees
-        :see: https://bybit-exchange.github.io/docs/v5/asset/coin-info
+
+        https://bybit-exchange.github.io/docs/v5/asset/coin-info
+
         :param str[] codes: list of unified currency codes
         :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>`
@@ -6907,7 +7030,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_settlement_history(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}):
         """
         fetches historical settlement records
-        :see: https://bybit-exchange.github.io/docs/v5/market/delivery-price
+
+        https://bybit-exchange.github.io/docs/v5/market/delivery-price
+
         :param str symbol: unified market symbol of the settlement history
         :param int [since]: timestamp in ms
         :param int [limit]: number of records
@@ -6958,7 +7083,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_my_settlement_history(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}):
         """
         fetches historical settlement records of the user
-        :see: https://bybit-exchange.github.io/docs/v5/asset/delivery
+
+        https://bybit-exchange.github.io/docs/v5/asset/delivery
+
         :param str symbol: unified market symbol of the settlement history
         :param int [since]: timestamp in ms
         :param int [limit]: number of records
@@ -7079,7 +7206,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_volatility_history(self, code: str, params={}):
         """
         fetch the historical volatility of an option market based on an underlying asset
-        :see: https://bybit-exchange.github.io/docs/v5/market/iv
+
+        https://bybit-exchange.github.io/docs/v5/market/iv
+
         :param str code: unified currency code
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :param int [params.period]: the period in days to fetch the volatility for: 7,14,21,30,60,90,180,270
@@ -7132,7 +7261,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_greeks(self, symbol: str, params={}) -> Greeks:
         """
         fetches an option contracts greeks, financial metrics used to measure the factors that affect the price of an options contract
-        :see: https://bybit-exchange.github.io/docs/api-explorer/v5/market/tickers
+
+        https://bybit-exchange.github.io/docs/api-explorer/v5/market/tickers
+
         :param str symbol: unified symbol of the market to fetch greeks for
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: a `greeks structure <https://docs.ccxt.com/#/?id=greeks-structure>`
@@ -7250,7 +7381,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_my_liquidations(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}):
         """
         retrieves the users liquidated positions
-        :see: https://bybit-exchange.github.io/docs/api-explorer/v5/position/execution
+
+        https://bybit-exchange.github.io/docs/api-explorer/v5/position/execution
+
         :param str [symbol]: unified CCXT market symbol
         :param int [since]: the earliest time in ms to fetch liquidations for
         :param int [limit]: the maximum number of liquidation structures to retrieve
@@ -7401,8 +7534,10 @@ class bybit(Exchange, ImplicitAPI):
 
     def fetch_leverage_tiers(self, symbols: Strings = None, params={}) -> LeverageTiers:
         """
-        :see: https://bybit-exchange.github.io/docs/v5/market/risk-limit
         retrieve information on the maximum leverage, for different trade sizes
+
+        https://bybit-exchange.github.io/docs/v5/market/risk-limit
+
         :param str[] [symbols]: a list of unified market symbols
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :param str [params.subType]: market subType, ['linear', 'inverse'], default is 'linear'
@@ -7421,7 +7556,7 @@ class bybit(Exchange, ImplicitAPI):
         symbols = self.market_symbols(symbols)
         return self.parse_leverage_tiers(data, symbols, 'symbol')
 
-    def parse_leverage_tiers(self, response, symbols: Strings = None, marketIdKey=None):
+    def parse_leverage_tiers(self, response, symbols: Strings = None, marketIdKey=None) -> LeverageTiers:
         #
         #  [
         #      {
@@ -7475,6 +7610,7 @@ class bybit(Exchange, ImplicitAPI):
                 minNotional = self.safe_number(info[i - 1], 'riskLimitValue')
             tiers.append({
                 'tier': self.safe_integer(tier, 'id'),
+                'symbol': self.safe_symbol(marketId, market),
                 'currency': market['settle'],
                 'minNotional': minNotional,
                 'maxNotional': self.safe_number(tier, 'riskLimitValue'),
@@ -7487,7 +7623,9 @@ class bybit(Exchange, ImplicitAPI):
     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://bybit-exchange.github.io/docs/api-explorer/v5/position/execution
+
+        https://bybit-exchange.github.io/docs/api-explorer/v5/position/execution
+
         :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
@@ -7578,7 +7716,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_option(self, symbol: str, params={}) -> Option:
         """
         fetches option data that is commonly found in an option chain
-        :see: https://bybit-exchange.github.io/docs/v5/market/tickers
+
+        https://bybit-exchange.github.io/docs/v5/market/tickers
+
         :param str symbol: unified market symbol
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: an `option chain structure <https://docs.ccxt.com/#/?id=option-chain-structure>`
@@ -7638,8 +7778,10 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_option_chain(self, code: str, params={}) -> OptionChain:
         """
         fetches data for an underlying asset that is commonly found in an option chain
-        :see: https://bybit-exchange.github.io/docs/v5/market/tickers
-        :param str currency: base currency to fetch an option chain for
+
+        https://bybit-exchange.github.io/docs/v5/market/tickers
+
+        :param str code: base currency to fetch an option chain for
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :returns dict: a list of `option chain structures <https://docs.ccxt.com/#/?id=option-chain-structure>`
         """
@@ -7749,8 +7891,10 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_positions_history(self, symbols: Strings = None, since: Int = None, limit: Int = None, params={}) -> List[Position]:
         """
         fetches historical positions
-        :see: https://bybit-exchange.github.io/docs/v5/position/close-pnl
-        :param str [symbol]: unified market symbols, symbols must have the same subType(must all be linear or all be inverse)
+
+        https://bybit-exchange.github.io/docs/v5/position/close-pnl
+
+        :param str[] symbols: a list of unified market symbols
         :param int [since]: timestamp in ms of the earliest position to fetch, params["until"] - since <= 7 days
         :param int [limit]: the maximum amount of records to fetch, default=50, max=100
         :param dict params: extra parameters specific to the exchange api endpoint
@@ -7822,7 +7966,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_convert_currencies(self, params={}) -> Currencies:
         """
         fetches all available currencies that can be converted
-        :see: https://bybit-exchange.github.io/docs/v5/asset/convert/convert-coin-list
+
+        https://bybit-exchange.github.io/docs/v5/asset/convert/convert-coin-list
+
         :param dict [params]: extra parameters specific to the exchange API endpoint
         :param str [params.accountType]: eb_convert_uta, eb_convert_spot, eb_convert_funding, eb_convert_inverse, or eb_convert_contract
         :returns dict: an associative dictionary of currencies
@@ -7913,7 +8059,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_convert_quote(self, fromCode: str, toCode: str, amount: Num = None, params={}) -> Conversion:
         """
         fetch a quote for converting from one currency to another
-        :see: https://bybit-exchange.github.io/docs/v5/asset/convert/apply-quote
+
+        https://bybit-exchange.github.io/docs/v5/asset/convert/apply-quote
+
         :param str fromCode: the currency that you want to sell and convert from
         :param str toCode: the currency that you want to buy and convert into
         :param float [amount]: how much you want to trade in units of the from currency
@@ -7965,7 +8113,9 @@ class bybit(Exchange, ImplicitAPI):
     def create_convert_trade(self, id: str, fromCode: str, toCode: str, amount: Num = None, params={}) -> Conversion:
         """
         convert from one currency to another
-        :see: https://bybit-exchange.github.io/docs/v5/asset/convert/confirm-quote
+
+        https://bybit-exchange.github.io/docs/v5/asset/convert/confirm-quote
+
         :param str id: the id of the trade that you want to make
         :param str fromCode: the currency that you want to sell and convert from
         :param str toCode: the currency that you want to buy and convert into
@@ -7996,7 +8146,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_convert_trade(self, id: str, code: Str = None, params={}) -> Conversion:
         """
         fetch the data for a conversion trade
-        :see: https://bybit-exchange.github.io/docs/v5/asset/convert/get-convert-result
+
+        https://bybit-exchange.github.io/docs/v5/asset/convert/get-convert-result
+
         :param str id: the id of the trade that you want to fetch
         :param str [code]: the unified currency code of the conversion trade
         :param dict [params]: extra parameters specific to the exchange API endpoint
@@ -8054,7 +8206,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_convert_trade_history(self, code: Str = None, since: Int = None, limit: Int = None, params={}) -> List[Conversion]:
         """
         fetch the users history of conversion trades
-        :see: https://bybit-exchange.github.io/docs/v5/asset/convert/get-convert-history
+
+        https://bybit-exchange.github.io/docs/v5/asset/convert/get-convert-history
+
         :param str [code]: the unified currency code
         :param int [since]: the earliest time in ms to fetch conversions for
         :param int [limit]: the maximum number of conversion structures to retrieve
@@ -8161,7 +8315,9 @@ class bybit(Exchange, ImplicitAPI):
     def fetch_long_short_ratio_history(self, symbol: Str = None, timeframe: Str = None, since: Int = None, limit: Int = None, params={}) -> List[LongShortRatio]:
         """
         fetches the long short ratio history for a unified market symbol
-        :see: https://bybit-exchange.github.io/docs/v5/market/long-short-ratio
+
+        https://bybit-exchange.github.io/docs/v5/market/long-short-ratio
+
         :param str symbol: unified symbol of the market to fetch the long short ratio for
         :param str [timeframe]: the period for the ratio, default is 24 hours
         :param int [since]: the earliest time in ms to fetch ratios for