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

ccxt/async_support/bybit.py

@@ -1092,7 +1092,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:
@@ -1123,9 +1123,13 @@ class bybit(Exchange, ImplicitAPI):
 
     async 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"
@@ -1208,8 +1212,12 @@ class bybit(Exchange, ImplicitAPI):
 
     async 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 await self.privatePostV5AccountUpgradeToUta(params)
 
@@ -1331,7 +1339,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
         """
@@ -1353,7 +1363,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
         """
@@ -1478,7 +1490,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
         """
@@ -2069,7 +2083,9 @@ class bybit(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://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>`
@@ -2139,7 +2155,9 @@ class bybit(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://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'
@@ -2256,10 +2274,12 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -2418,7 +2438,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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>`
@@ -2488,7 +2510,9 @@ class bybit(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://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
@@ -2740,7 +2764,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -2795,7 +2821,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -3008,9 +3036,11 @@ class bybit(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://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>`
@@ -3408,8 +3438,10 @@ class bybit(Exchange, ImplicitAPI):
 
     async 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
@@ -3423,8 +3455,10 @@ class bybit(Exchange, ImplicitAPI):
 
     async 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
@@ -3443,8 +3477,10 @@ class bybit(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://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'
@@ -3695,8 +3731,11 @@ class bybit(Exchange, ImplicitAPI):
     async 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>`
         """
         await self.load_markets()
@@ -3840,9 +3879,11 @@ class bybit(Exchange, ImplicitAPI):
     async 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'
@@ -3914,7 +3955,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -3947,7 +3990,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -4026,7 +4071,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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'
@@ -4057,7 +4104,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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>`
@@ -4137,7 +4186,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -4208,7 +4259,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -4235,8 +4288,10 @@ class bybit(Exchange, ImplicitAPI):
 
     async 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
@@ -4326,7 +4381,7 @@ class bybit(Exchange, ImplicitAPI):
         res = await 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
@@ -4348,7 +4403,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -4447,7 +4504,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -4475,7 +4534,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -4505,7 +4566,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -4602,7 +4665,9 @@ class bybit(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://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
@@ -4625,7 +4690,9 @@ class bybit(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://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
@@ -4648,7 +4715,9 @@ class bybit(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://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
@@ -4744,7 +4813,9 @@ class bybit(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://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
@@ -4764,7 +4835,9 @@ class bybit(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://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
@@ -4863,7 +4936,9 @@ class bybit(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://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
@@ -4905,7 +4980,9 @@ class bybit(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://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>`
@@ -4949,13 +5026,15 @@ class bybit(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://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>`
@@ -5013,7 +5092,9 @@ class bybit(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://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
@@ -5186,14 +5267,16 @@ class bybit(Exchange, ImplicitAPI):
     async 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>`
         """
         await self.load_markets()
@@ -5454,7 +5537,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -5499,7 +5584,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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>`
@@ -5568,7 +5655,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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']
@@ -5889,7 +5978,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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>`
@@ -5913,8 +6004,10 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -5995,7 +6088,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -6031,7 +6126,9 @@ class bybit(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://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
@@ -6127,7 +6224,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -6183,7 +6282,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -6231,7 +6332,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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>`
@@ -6295,7 +6398,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -6339,7 +6444,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -6409,7 +6516,9 @@ class bybit(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://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
@@ -6460,7 +6569,9 @@ class bybit(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://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
@@ -6513,7 +6624,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -6547,7 +6660,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -6649,7 +6764,7 @@ class bybit(Exchange, ImplicitAPI):
             'status': self.parse_transfer_status(self.safe_string(transfer, 'status')),
         }
 
-    async def fetch_derivatives_market_leverage_tiers(self, symbol: str, params={}):
+    async def fetch_derivatives_market_leverage_tiers(self, symbol: str, params={}) -> List[LeverageTier]:
         await self.load_markets()
         market = self.market(symbol)
         request: dict = {
@@ -6690,7 +6805,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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>`
@@ -6727,7 +6844,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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>`
@@ -6773,7 +6892,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -6863,7 +6984,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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>`
@@ -6908,7 +7031,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -6959,7 +7084,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -7080,7 +7207,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -7133,7 +7262,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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>`
@@ -7251,7 +7382,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -7402,8 +7535,10 @@ class bybit(Exchange, ImplicitAPI):
 
     async 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'
@@ -7422,7 +7557,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:
         #
         #  [
         #      {
@@ -7476,6 +7611,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'),
@@ -7488,7 +7624,9 @@ class bybit(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://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
@@ -7579,7 +7717,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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>`
@@ -7639,8 +7779,10 @@ class bybit(Exchange, ImplicitAPI):
     async 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>`
         """
@@ -7750,8 +7892,10 @@ class bybit(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://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
@@ -7823,7 +7967,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -7914,7 +8060,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -7966,7 +8114,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -7997,7 +8147,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -8055,7 +8207,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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
@@ -8162,7 +8316,9 @@ class bybit(Exchange, ImplicitAPI):
     async 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