ccxt 4.0.108__py2.py3-none-any.whl → 4.0.109__py2.py3-none-any.whl

ccxt/__init__.py

@@ -22,7 +22,7 @@
 
 # ----------------------------------------------------------------------------
 
-__version__ = '4.0.108'
+__version__ = '4.0.109'
 
 # ----------------------------------------------------------------------------
 

ccxt/async_support/__init__.py

@@ -4,7 +4,7 @@
 
 # -----------------------------------------------------------------------------
 
-__version__ = '4.0.108'
+__version__ = '4.0.109'
 
 # -----------------------------------------------------------------------------
 

ccxt/async_support/base/exchange.py

@@ -2,7 +2,7 @@
 
 # -----------------------------------------------------------------------------
 
-__version__ = '4.0.108'
+__version__ = '4.0.109'
 
 # -----------------------------------------------------------------------------
 

ccxt/async_support/bitfinex2.py

@@ -2469,8 +2469,6 @@ class bitfinex2(Exchange, ImplicitAPI):
             return None
         elif type.find('fee') >= 0 or type.find('charged') >= 0:
             return 'fee'
-        elif type.find('exchange') >= 0 or type.find('position') >= 0:
-            return 'trade'
         elif type.find('rebate') >= 0:
             return 'rebate'
         elif type.find('deposit') >= 0 or type.find('withdrawal') >= 0:
@@ -2479,6 +2477,8 @@ class bitfinex2(Exchange, ImplicitAPI):
             return 'transfer'
         elif type.find('payment') >= 0:
             return 'payout'
+        elif type.find('exchange') >= 0 or type.find('position') >= 0:
+            return 'trade'
         else:
             return type
 

ccxt/async_support/bitflyer.py

@@ -151,6 +151,7 @@ class bitflyer(Exchange, ImplicitAPI):
     async def fetch_markets(self, params={}):
         """
         retrieves data on all markets for bitflyer
+        see https://lightning.bitflyer.com/docs?lang=en#market-list
         :param dict [params]: extra parameters specific to the exchange api endpoint
         :returns dict[]: an array of objects representing market data
         """
@@ -307,6 +308,7 @@ class bitflyer(Exchange, ImplicitAPI):
     async def fetch_balance(self, params={}):
         """
         query for balance and get the amount of funds available for trading or funds locked in orders
+        see https://lightning.bitflyer.com/docs?lang=en#get-account-asset-balance
         :param dict [params]: extra parameters specific to the bitflyer api endpoint
         :returns dict: a `balance structure <https://github.com/ccxt/ccxt/wiki/Manual#balance-structure>`
         """
@@ -336,6 +338,7 @@ class bitflyer(Exchange, ImplicitAPI):
     async def fetch_order_book(self, symbol: str, limit: Optional[int] = None, params={}):
         """
         fetches information on open orders with bid(buy) and ask(sell) prices, volumes and other data
+        see https://lightning.bitflyer.com/docs?lang=en#order-book
         :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 bitflyer api endpoint
@@ -379,6 +382,7 @@ class bitflyer(Exchange, ImplicitAPI):
     async def fetch_ticker(self, symbol: str, params={}):
         """
         fetches a price ticker, a statistical calculation with the information calculated over the past 24 hours for a specific market
+        see https://lightning.bitflyer.com/docs?lang=en#ticker
         :param str symbol: unified symbol of the market to fetch the ticker for
         :param dict [params]: extra parameters specific to the bitflyer api endpoint
         :returns dict: a `ticker structure <https://github.com/ccxt/ccxt/wiki/Manual#ticker-structure>`
@@ -453,6 +457,7 @@ class bitflyer(Exchange, ImplicitAPI):
     async def fetch_trades(self, symbol: str, since: Optional[int] = None, limit: Optional[int] = None, params={}):
         """
         get the list of most recent trades for a particular symbol
+        see https://lightning.bitflyer.com/docs?lang=en#list-executions
         :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
@@ -485,6 +490,7 @@ class bitflyer(Exchange, ImplicitAPI):
     async def fetch_trading_fee(self, symbol: str, params={}):
         """
         fetch the trading fees for a market
+        see https://lightning.bitflyer.com/docs?lang=en#get-trading-commission
         :param str symbol: unified market symbol
         :param dict [params]: extra parameters specific to the bitflyer api endpoint
         :returns dict: a `fee structure <https://github.com/ccxt/ccxt/wiki/Manual#fee-structure>`
@@ -511,6 +517,7 @@ class bitflyer(Exchange, ImplicitAPI):
     async def create_order(self, symbol: str, type: OrderType, side: OrderSide, amount, price=None, params={}):
         """
         create a trade order
+        see https://lightning.bitflyer.com/docs?lang=en#send-a-new-order
         :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'
@@ -538,6 +545,7 @@ class bitflyer(Exchange, ImplicitAPI):
     async def cancel_order(self, id: str, symbol: Optional[str] = None, params={}):
         """
         cancels an open order
+        see https://lightning.bitflyer.com/docs?lang=en#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 bitflyer api endpoint
@@ -610,6 +618,7 @@ class bitflyer(Exchange, ImplicitAPI):
     async def fetch_orders(self, symbol: Optional[str] = None, since: Optional[int] = None, limit=100, params={}):
         """
         fetches information on multiple orders made by the user
+        see https://lightning.bitflyer.com/docs?lang=en#list-orders
         :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  orde structures to retrieve
@@ -633,6 +642,7 @@ class bitflyer(Exchange, ImplicitAPI):
     async def fetch_open_orders(self, symbol: Optional[str] = None, since: Optional[int] = None, limit=100, params={}):
         """
         fetch all unfilled currently open orders
+        see https://lightning.bitflyer.com/docs?lang=en#list-orders
         :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
@@ -647,6 +657,7 @@ class bitflyer(Exchange, ImplicitAPI):
     async def fetch_closed_orders(self, symbol: Optional[str] = None, since: Optional[int] = None, limit=100, params={}):
         """
         fetches information on multiple closed orders made by the user
+        see https://lightning.bitflyer.com/docs?lang=en#list-orders
         :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  orde structures to retrieve
@@ -661,6 +672,7 @@ class bitflyer(Exchange, ImplicitAPI):
     async def fetch_order(self, id: str, symbol: Optional[str] = None, params={}):
         """
         fetches information on an order made by the user
+        see https://lightning.bitflyer.com/docs?lang=en#list-orders
         :param str symbol: unified symbol of the market the order was made in
         :param dict [params]: extra parameters specific to the bitflyer api endpoint
         :returns dict: An `order structure <https://github.com/ccxt/ccxt/wiki/Manual#order-structure>`
@@ -676,6 +688,7 @@ class bitflyer(Exchange, ImplicitAPI):
     async def fetch_my_trades(self, symbol: Optional[str] = None, since: Optional[int] = None, limit: Optional[int] = None, params={}):
         """
         fetch all trades made by the user
+        see https://lightning.bitflyer.com/docs?lang=en#list-executions
         :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
@@ -711,6 +724,7 @@ class bitflyer(Exchange, ImplicitAPI):
     async def fetch_positions(self, symbols: Optional[List[str]] = None, params={}):
         """
         fetch all open positions
+        see https://lightning.bitflyer.com/docs?lang=en#get-open-interest-summary
         :param str[] symbols: list of unified market symbols
         :param dict [params]: extra parameters specific to the bitflyer api endpoint
         :returns dict[]: a list of `position structure <https://github.com/ccxt/ccxt/wiki/Manual#position-structure>`
@@ -745,6 +759,7 @@ class bitflyer(Exchange, ImplicitAPI):
     async def withdraw(self, code: str, amount, address, tag=None, params={}):
         """
         make a withdrawal
+        see https://lightning.bitflyer.com/docs?lang=en#withdrawing-funds
         :param str code: unified currency code
         :param float amount: the amount to withdraw
         :param str address: the address to withdraw to
@@ -773,6 +788,7 @@ class bitflyer(Exchange, ImplicitAPI):
     async def fetch_deposits(self, code: Optional[str] = None, since: Optional[int] = None, limit: Optional[int] = None, params={}):
         """
         fetch all deposits made to an account
+        see https://lightning.bitflyer.com/docs?lang=en#get-crypto-assets-deposit-history
         :param str code: unified currency code
         :param int [since]: the earliest time in ms to fetch deposits for
         :param int [limit]: the maximum number of deposits structures to retrieve
@@ -806,6 +822,7 @@ class bitflyer(Exchange, ImplicitAPI):
     async def fetch_withdrawals(self, code: Optional[str] = None, since: Optional[int] = None, limit: Optional[int] = None, params={}):
         """
         fetch all withdrawals made from an account
+        see https://lightning.bitflyer.com/docs?lang=en#get-crypto-assets-transaction-history
         :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

ccxt/async_support/bitget.py

@@ -1085,6 +1085,7 @@ class bitget(Exchange, ImplicitAPI):
     async def fetch_time(self, params={}):
         """
         fetches the current integer timestamp in milliseconds from the exchange server
+        see https://bitgetlimited.github.io/apidoc/en/spot/#get-server-time
         :param dict [params]: extra parameters specific to the bitget api endpoint
         :returns int: the current integer timestamp in milliseconds from the exchange server
         """
@@ -1102,6 +1103,8 @@ class bitget(Exchange, ImplicitAPI):
     async def fetch_markets(self, params={}):
         """
         retrieves data on all markets for bitget
+        see https://bitgetlimited.github.io/apidoc/en/spot/#get-symbols
+        see https://bitgetlimited.github.io/apidoc/en/mix/#get-all-symbols
         :param dict [params]: extra parameters specific to the exchange api endpoint
         :returns dict[]: an array of objects representing market data
         """
@@ -1358,6 +1361,7 @@ class bitget(Exchange, ImplicitAPI):
     async def fetch_currencies(self, params={}):
         """
         fetches all available currencies on an exchange
+        see https://bitgetlimited.github.io/apidoc/en/spot/#get-coin-list
         :param dict [params]: extra parameters specific to the bitget api endpoint
         :returns dict: an associative dictionary of currencies
         """
@@ -1771,6 +1775,7 @@ class bitget(Exchange, ImplicitAPI):
     async def fetch_deposit_address(self, code: str, params={}):
         """
         fetch the deposit address for a currency associated with self account
+        see https://bitgetlimited.github.io/apidoc/en/spot/#get-coin-address
         :param str code: unified currency code
         :param dict [params]: extra parameters specific to the bitget api endpoint
         :returns dict: an `address structure <https://github.com/ccxt/ccxt/wiki/Manual#address-structure>`
@@ -1825,6 +1830,8 @@ class bitget(Exchange, ImplicitAPI):
     async def fetch_order_book(self, symbol: str, limit: Optional[int] = None, params={}):
         """
         fetches information on open orders with bid(buy) and ask(sell) prices, volumes and other data
+        see https://bitgetlimited.github.io/apidoc/en/spot/#get-depth
+        see https://bitgetlimited.github.io/apidoc/en/mix/#get-depth
         :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 bitget api endpoint
@@ -1977,6 +1984,8 @@ class bitget(Exchange, ImplicitAPI):
     async def fetch_ticker(self, symbol: str, params={}):
         """
         fetches a price ticker, a statistical calculation with the information calculated over the past 24 hours for a specific market
+        see https://bitgetlimited.github.io/apidoc/en/spot/#get-single-ticker
+        see https://bitgetlimited.github.io/apidoc/en/mix/#get-single-symbol-ticker
         :param str symbol: unified symbol of the market to fetch the ticker for
         :param dict [params]: extra parameters specific to the bitget api endpoint
         :returns dict: a `ticker structure <https://github.com/ccxt/ccxt/wiki/Manual#ticker-structure>`
@@ -2284,6 +2293,7 @@ class bitget(Exchange, ImplicitAPI):
     async def fetch_trading_fee(self, symbol: str, params={}):
         """
         fetch the trading fees for a market
+        see https://bitgetlimited.github.io/apidoc/en/spot/#get-single-symbol
         :param str symbol: unified market symbol
         :param dict [params]: extra parameters specific to the bitget api endpoint
         :returns dict: a `fee structure <https://github.com/ccxt/ccxt/wiki/Manual#fee-structure>`
@@ -2320,6 +2330,7 @@ class bitget(Exchange, ImplicitAPI):
     async def fetch_trading_fees(self, params={}):
         """
         fetch the trading fees for multiple markets
+        see https://bitgetlimited.github.io/apidoc/en/spot/#get-symbols
         :param dict [params]: extra parameters specific to the bitget api endpoint
         :returns dict: a dictionary of `fee structures <https://github.com/ccxt/ccxt/wiki/Manual#fee-structure>` indexed by market symbols
         """
@@ -2492,9 +2503,9 @@ class bitget(Exchange, ImplicitAPI):
 
     async def fetch_balance(self, params={}):
         """
+        query for balance and get the amount of funds available for trading or funds locked in orders
         see https://bitgetlimited.github.io/apidoc/en/spot/#get-account-assets
         see https://bitgetlimited.github.io/apidoc/en/mix/#get-account-list
-        query for balance and get the amount of funds available for trading or funds locked in orders
         :param dict [params]: extra parameters specific to the bitget api endpoint
         :returns dict: a `balance structure <https://github.com/ccxt/ccxt/wiki/Manual#balance-structure>`
         """
@@ -2743,13 +2754,13 @@ class bitget(Exchange, ImplicitAPI):
 
     async def create_order(self, symbol: str, type: OrderType, side: OrderSide, amount, price=None, params={}):
         """
+        create a trade order
         see https://bitgetlimited.github.io/apidoc/en/spot/#place-order
         see https://bitgetlimited.github.io/apidoc/en/spot/#place-plan-order
         see https://bitgetlimited.github.io/apidoc/en/mix/#place-order
         see https://bitgetlimited.github.io/apidoc/en/mix/#place-stop-order
         see https://bitgetlimited.github.io/apidoc/en/mix/#place-position-tpsl
         see https://bitgetlimited.github.io/apidoc/en/mix/#place-plan-order
-        create a trade order
         :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' or 'open_long' or 'open_short' or 'close_long' or 'close_short'
@@ -2905,6 +2916,10 @@ class bitget(Exchange, ImplicitAPI):
     async def edit_order(self, id: str, symbol, type, side, amount=None, price=None, params={}):
         """
         edit a trade order
+        see https://bitgetlimited.github.io/apidoc/en/spot/#modify-plan-order
+        see https://bitgetlimited.github.io/apidoc/en/mix/#modify-plan-order
+        see https://bitgetlimited.github.io/apidoc/en/mix/#modify-plan-order-tpsl
+        see https://bitgetlimited.github.io/apidoc/en/mix/#modify-stop-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'
@@ -2992,6 +3007,10 @@ class bitget(Exchange, ImplicitAPI):
     async def cancel_order(self, id: str, symbol: Optional[str] = None, params={}):
         """
         cancels an open order
+        see https://bitgetlimited.github.io/apidoc/en/spot/#cancel-order
+        see https://bitgetlimited.github.io/apidoc/en/spot/#cancel-plan-order
+        see https://bitgetlimited.github.io/apidoc/en/mix/#cancel-order
+        see https://bitgetlimited.github.io/apidoc/en/mix/#cancel-plan-order-tpsl
         :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 bitget api endpoint
@@ -3029,6 +3048,8 @@ class bitget(Exchange, ImplicitAPI):
     async def cancel_orders(self, ids, symbol: Optional[str] = None, params={}):
         """
         cancel multiple orders
+        see https://bitgetlimited.github.io/apidoc/en/spot/#cancel-order-in-batch-v2-single-instruments
+        see https://bitgetlimited.github.io/apidoc/en/mix/#batch-cancel-order
         :param str[] ids: order ids
         :param str symbol: unified market symbol, default is None
         :param dict [params]: extra parameters specific to the bitget api endpoint
@@ -3154,6 +3175,8 @@ class bitget(Exchange, ImplicitAPI):
     async def fetch_order(self, id: str, symbol: Optional[str] = None, params={}):
         """
         fetches information on an order made by the user
+        see https://bitgetlimited.github.io/apidoc/en/spot/#get-order-details
+        see https://bitgetlimited.github.io/apidoc/en/mix/#get-order-details
         :param str symbol: unified symbol of the market the order was made in
         :param dict [params]: extra parameters specific to the bitget api endpoint
         :returns dict: An `order structure <https://github.com/ccxt/ccxt/wiki/Manual#order-structure>`
@@ -3232,11 +3255,11 @@ class bitget(Exchange, ImplicitAPI):
 
     async def fetch_open_orders(self, symbol: Optional[str] = None, since: Optional[int] = None, limit: Optional[int] = None, params={}):
         """
+        fetch all unfilled currently open orders
         see https://bitgetlimited.github.io/apidoc/en/spot/#get-order-list
         see https://bitgetlimited.github.io/apidoc/en/mix/#get-all-open-order
         see https://bitgetlimited.github.io/apidoc/en/mix/#get-plan-order-tpsl-list
         see https://bitgetlimited.github.io/apidoc/en/mix/#get-open-order
-        fetch all unfilled currently open orders
         :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 order structures to retrieve
@@ -3588,6 +3611,7 @@ class bitget(Exchange, ImplicitAPI):
     async def fetch_ledger(self, code: Optional[str] = None, since: Optional[int] = None, limit: Optional[int] = None, params={}):
         """
         fetch the history of changes, actions done by the user or operations that altered balance of the user
+        see https://bitgetlimited.github.io/apidoc/en/spot/#get-bills
         :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 entrys to return, default is None
@@ -3722,6 +3746,8 @@ class bitget(Exchange, ImplicitAPI):
     async def fetch_order_trades(self, id: str, symbol: Optional[str] = None, since: Optional[int] = None, limit: Optional[int] = None, params={}):
         """
         fetch all the trades made from a single order
+        see https://bitgetlimited.github.io/apidoc/en/spot/#get-transaction-details
+        see https://bitgetlimited.github.io/apidoc/en/mix/#get-order-fill-detail
         :param str id: order id
         :param str symbol: unified market symbol
         :param int [since]: the earliest time in ms to fetch trades for
@@ -3772,6 +3798,7 @@ class bitget(Exchange, ImplicitAPI):
     async def fetch_position(self, symbol: str, params={}):
         """
         fetch data on a single open contract trade position
+        see https://bitgetlimited.github.io/apidoc/en/mix/#get-symbol-position-v2
         :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 bitget api endpoint
         :returns dict: a `position structure <https://github.com/ccxt/ccxt/wiki/Manual#position-structure>`
@@ -3819,6 +3846,8 @@ class bitget(Exchange, ImplicitAPI):
     async def fetch_positions(self, symbols: Optional[List[str]] = None, params={}):
         """
         fetch all open positions
+        see https://bitgetlimited.github.io/apidoc/en/mix/#get-all-position-v2
+        see https://bitgetlimited.github.io/apidoc/en/mix/#get-history-position
         :param str[]|None symbols: list of unified market symbols
         :param dict [params]: extra parameters specific to the bitget api endpoint
         :returns dict[]: a list of `position structure <https://github.com/ccxt/ccxt/wiki/Manual#position-structure>`
@@ -4056,6 +4085,7 @@ class bitget(Exchange, ImplicitAPI):
     async def fetch_funding_rate_history(self, symbol: Optional[str] = None, since: Optional[int] = None, limit: Optional[int] = None, params={}):
         """
         fetches historical funding rate prices
+        see https://bitgetlimited.github.io/apidoc/en/mix/#get-history-funding-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://github.com/ccxt/ccxt/wiki/Manual#funding-rate-history-structure>` to fetch
@@ -4108,6 +4138,7 @@ class bitget(Exchange, ImplicitAPI):
     async def fetch_funding_rate(self, symbol: str, params={}):
         """
         fetch the current funding rate
+        see https://bitgetlimited.github.io/apidoc/en/mix/#get-current-funding-rate
         :param str symbol: unified market symbol
         :param dict [params]: extra parameters specific to the bitget api endpoint
         :returns dict: a `funding rate structure <https://github.com/ccxt/ccxt/wiki/Manual#funding-rate-structure>`
@@ -4301,6 +4332,7 @@ class bitget(Exchange, ImplicitAPI):
     async def reduce_margin(self, symbol: str, amount, params={}):
         """
         remove margin from a position
+        see https://bitgetlimited.github.io/apidoc/en/mix/#change-margin
         :param str symbol: unified market symbol
         :param float amount: the amount of margin to remove
         :param dict [params]: extra parameters specific to the bitget api endpoint
@@ -4316,6 +4348,7 @@ class bitget(Exchange, ImplicitAPI):
     async def add_margin(self, symbol: str, amount, params={}):
         """
         add margin
+        see https://bitgetlimited.github.io/apidoc/en/mix/#change-margin
         :param str symbol: unified market symbol
         :param float amount: amount of margin to add
         :param dict [params]: extra parameters specific to the bitget api endpoint
@@ -4329,6 +4362,7 @@ class bitget(Exchange, ImplicitAPI):
     async def fetch_leverage(self, symbol: str, params={}):
         """
         fetch the set leverage for a market
+        see https://bitgetlimited.github.io/apidoc/en/mix/#get-single-account
         :param str symbol: unified market symbol
         :param dict [params]: extra parameters specific to the bitget api endpoint
         :returns dict: a `leverage structure <https://github.com/ccxt/ccxt/wiki/Manual#leverage-structure>`
@@ -4371,6 +4405,7 @@ class bitget(Exchange, ImplicitAPI):
     async def set_leverage(self, leverage, symbol: Optional[str] = None, params={}):
         """
         set the level of leverage for a market
+        see https://bitgetlimited.github.io/apidoc/en/mix/#change-leverage
         :param float leverage: the rate of leverage
         :param str symbol: unified market symbol
         :param dict [params]: extra parameters specific to the bitget api endpoint
@@ -4390,6 +4425,7 @@ class bitget(Exchange, ImplicitAPI):
     async def set_margin_mode(self, marginMode, symbol: Optional[str] = None, params={}):
         """
         set margin mode to 'cross' or 'isolated'
+        see https://bitgetlimited.github.io/apidoc/en/mix/#change-margin-mode
         :param str marginMode: 'cross' or 'isolated'
         :param str symbol: unified market symbol
         :param dict [params]: extra parameters specific to the bitget api endpoint
@@ -4415,6 +4451,7 @@ class bitget(Exchange, ImplicitAPI):
     async def set_position_mode(self, hedged, symbol: Optional[str] = None, params={}):
         """
         set hedged to True or False for a market
+        see https://bitgetlimited.github.io/apidoc/en/mix/#change-hold-mode
         :param bool hedged: set to True to use dualSidePosition
         :param str symbol: not used by bitget setPositionMode()
         :param dict [params]: extra parameters specific to the bitget api endpoint

ccxt/async_support/bitmart.py

@@ -1887,7 +1887,7 @@ class bitmart(Exchange, ImplicitAPI):
         #        "updateTime" : 1681701559408
         #    }
         #
-        # swap: fetchOpenOrders
+        # swap: fetchOrder, fetchOpenOrders
         #
         #     {
         #         "order_id": "230935812485489",
@@ -2369,26 +2369,89 @@ class bitmart(Exchange, ImplicitAPI):
 
     async def fetch_order(self, id: str, symbol: Optional[str] = None, params={}):
         """
+        fetches information on an order made by the user
         see https://developer-pro.bitmart.com/en/spot/#query-order-by-id-v4-signed
         see https://developer-pro.bitmart.com/en/spot/#query-order-by-clientorderid-v4-signed
-        fetches information on an order made by the user
+        see https://developer-pro.bitmart.com/en/futures/#get-order-detail-keyed
+        :param str id: the id of the order
         :param str symbol: unified symbol of the market the order was made in
         :param dict [params]: extra parameters specific to the bitmart api endpoint
-        :param str [params.clientOrderId]: fetch the order by client order id instead of order id
+        :param str [params.clientOrderId]: *spot* fetch the order by client order id instead of order id
         :returns dict: An `order structure <https://github.com/ccxt/ccxt/wiki/Manual#order-structure>`
         """
         await self.load_markets()
         request = {}
-        clientOrderId = self.safe_string(params, 'clientOrderId')
-        if not clientOrderId:
-            request['orderId'] = id
+        type = None
+        market = None
         response = None
-        if clientOrderId is not None:
-            response = await self.privatePostSpotV4QueryClientOrder(self.extend(request, params))
-        else:
-            response = await self.privatePostSpotV4QueryOrder(self.extend(request, params))
+        if symbol is not None:
+            market = self.market(symbol)
+        type, params = self.handle_market_type_and_params('fetchOrder', market, params)
+        if type == 'spot':
+            clientOrderId = self.safe_string(params, 'clientOrderId')
+            if not clientOrderId:
+                request['orderId'] = id
+            if clientOrderId is not None:
+                response = await self.privatePostSpotV4QueryClientOrder(self.extend(request, params))
+            else:
+                response = await self.privatePostSpotV4QueryOrder(self.extend(request, params))
+        elif type == 'swap':
+            self.check_required_symbol('fetchOrder', symbol)
+            request['symbol'] = market['id']
+            request['order_id'] = id
+            response = await self.privateGetContractPrivateOrder(self.extend(request, params))
+        #
+        # spot
+        #
+        #     {
+        #         "code": 1000,
+        #         "message": "success",
+        #         "data": {
+        #             "orderId": "183347420821295423",
+        #             "clientOrderId": "183347420821295423",
+        #             "symbol": "BTC_USDT",
+        #             "side": "buy",
+        #             "orderMode": "spot",
+        #             "type": "limit",
+        #             "state": "new",
+        #             "price": "24000.00",
+        #             "priceAvg": "0.00",
+        #             "size": "0.00022",
+        #             "filledSize": "0.00000",
+        #             "notional": "5.28000000",
+        #             "filledNotional": "0.00000000",
+        #             "createTime": 1695783014734,
+        #             "updateTime": 1695783014762
+        #         },
+        #         "trace": "ce3e6422c8b44d5fag855348a68693ed.63.14957831547451715"
+        #     }
+        #
+        # swap
+        #
+        #     {
+        #         "code": 1000,
+        #         "message": "Ok",
+        #         "data": {
+        #             "order_id": "230927283405028",
+        #             "client_order_id": "",
+        #             "price": "23000",
+        #             "size": "1",
+        #             "symbol": "BTCUSDT",
+        #             "state": 2,
+        #             "side": 1,
+        #             "type": "limit",
+        #             "leverage": "10",
+        #             "open_type": "isolated",
+        #             "deal_avg_price": "0",
+        #             "deal_size": "0",
+        #             "create_time": 1695783433600,
+        #             "update_time": 1695783433613
+        #         },
+        #         "trace": "4cad855075664097af6ba5257c47605d.63.14957831547451715"
+        #     }
+        #
         data = self.safe_value(response, 'data', {})
-        return self.parse_order(data, None)
+        return self.parse_order(data, market)
 
     async def fetch_deposit_address(self, code: str, params={}):
         """

ccxt/base/exchange.py

@@ -4,7 +4,7 @@
 
 # -----------------------------------------------------------------------------
 
-__version__ = '4.0.108'
+__version__ = '4.0.109'
 
 # -----------------------------------------------------------------------------
 

ccxt/bitfinex2.py

@@ -2469,8 +2469,6 @@ class bitfinex2(Exchange, ImplicitAPI):
             return None
         elif type.find('fee') >= 0 or type.find('charged') >= 0:
             return 'fee'
-        elif type.find('exchange') >= 0 or type.find('position') >= 0:
-            return 'trade'
         elif type.find('rebate') >= 0:
             return 'rebate'
         elif type.find('deposit') >= 0 or type.find('withdrawal') >= 0:
@@ -2479,6 +2477,8 @@ class bitfinex2(Exchange, ImplicitAPI):
             return 'transfer'
         elif type.find('payment') >= 0:
             return 'payout'
+        elif type.find('exchange') >= 0 or type.find('position') >= 0:
+            return 'trade'
         else:
             return type
 

ccxt/bitflyer.py

@@ -151,6 +151,7 @@ class bitflyer(Exchange, ImplicitAPI):
     def fetch_markets(self, params={}):
         """
         retrieves data on all markets for bitflyer
+        see https://lightning.bitflyer.com/docs?lang=en#market-list
         :param dict [params]: extra parameters specific to the exchange api endpoint
         :returns dict[]: an array of objects representing market data
         """
@@ -307,6 +308,7 @@ class bitflyer(Exchange, ImplicitAPI):
     def fetch_balance(self, params={}):
         """
         query for balance and get the amount of funds available for trading or funds locked in orders
+        see https://lightning.bitflyer.com/docs?lang=en#get-account-asset-balance
         :param dict [params]: extra parameters specific to the bitflyer api endpoint
         :returns dict: a `balance structure <https://github.com/ccxt/ccxt/wiki/Manual#balance-structure>`
         """
@@ -336,6 +338,7 @@ class bitflyer(Exchange, ImplicitAPI):
     def fetch_order_book(self, symbol: str, limit: Optional[int] = None, params={}):
         """
         fetches information on open orders with bid(buy) and ask(sell) prices, volumes and other data
+        see https://lightning.bitflyer.com/docs?lang=en#order-book
         :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 bitflyer api endpoint
@@ -379,6 +382,7 @@ class bitflyer(Exchange, ImplicitAPI):
     def fetch_ticker(self, symbol: str, params={}):
         """
         fetches a price ticker, a statistical calculation with the information calculated over the past 24 hours for a specific market
+        see https://lightning.bitflyer.com/docs?lang=en#ticker
         :param str symbol: unified symbol of the market to fetch the ticker for
         :param dict [params]: extra parameters specific to the bitflyer api endpoint
         :returns dict: a `ticker structure <https://github.com/ccxt/ccxt/wiki/Manual#ticker-structure>`
@@ -453,6 +457,7 @@ class bitflyer(Exchange, ImplicitAPI):
     def fetch_trades(self, symbol: str, since: Optional[int] = None, limit: Optional[int] = None, params={}):
         """
         get the list of most recent trades for a particular symbol
+        see https://lightning.bitflyer.com/docs?lang=en#list-executions
         :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
@@ -485,6 +490,7 @@ class bitflyer(Exchange, ImplicitAPI):
     def fetch_trading_fee(self, symbol: str, params={}):
         """
         fetch the trading fees for a market
+        see https://lightning.bitflyer.com/docs?lang=en#get-trading-commission
         :param str symbol: unified market symbol
         :param dict [params]: extra parameters specific to the bitflyer api endpoint
         :returns dict: a `fee structure <https://github.com/ccxt/ccxt/wiki/Manual#fee-structure>`
@@ -511,6 +517,7 @@ class bitflyer(Exchange, ImplicitAPI):
     def create_order(self, symbol: str, type: OrderType, side: OrderSide, amount, price=None, params={}):
         """
         create a trade order
+        see https://lightning.bitflyer.com/docs?lang=en#send-a-new-order
         :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'
@@ -538,6 +545,7 @@ class bitflyer(Exchange, ImplicitAPI):
     def cancel_order(self, id: str, symbol: Optional[str] = None, params={}):
         """
         cancels an open order
+        see https://lightning.bitflyer.com/docs?lang=en#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 bitflyer api endpoint
@@ -610,6 +618,7 @@ class bitflyer(Exchange, ImplicitAPI):
     def fetch_orders(self, symbol: Optional[str] = None, since: Optional[int] = None, limit=100, params={}):
         """
         fetches information on multiple orders made by the user
+        see https://lightning.bitflyer.com/docs?lang=en#list-orders
         :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  orde structures to retrieve
@@ -633,6 +642,7 @@ class bitflyer(Exchange, ImplicitAPI):
     def fetch_open_orders(self, symbol: Optional[str] = None, since: Optional[int] = None, limit=100, params={}):
         """
         fetch all unfilled currently open orders
+        see https://lightning.bitflyer.com/docs?lang=en#list-orders
         :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
@@ -647,6 +657,7 @@ class bitflyer(Exchange, ImplicitAPI):
     def fetch_closed_orders(self, symbol: Optional[str] = None, since: Optional[int] = None, limit=100, params={}):
         """
         fetches information on multiple closed orders made by the user
+        see https://lightning.bitflyer.com/docs?lang=en#list-orders
         :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  orde structures to retrieve
@@ -661,6 +672,7 @@ class bitflyer(Exchange, ImplicitAPI):
     def fetch_order(self, id: str, symbol: Optional[str] = None, params={}):
         """
         fetches information on an order made by the user
+        see https://lightning.bitflyer.com/docs?lang=en#list-orders
         :param str symbol: unified symbol of the market the order was made in
         :param dict [params]: extra parameters specific to the bitflyer api endpoint
         :returns dict: An `order structure <https://github.com/ccxt/ccxt/wiki/Manual#order-structure>`
@@ -676,6 +688,7 @@ class bitflyer(Exchange, ImplicitAPI):
     def fetch_my_trades(self, symbol: Optional[str] = None, since: Optional[int] = None, limit: Optional[int] = None, params={}):
         """
         fetch all trades made by the user
+        see https://lightning.bitflyer.com/docs?lang=en#list-executions
         :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
@@ -711,6 +724,7 @@ class bitflyer(Exchange, ImplicitAPI):
     def fetch_positions(self, symbols: Optional[List[str]] = None, params={}):
         """
         fetch all open positions
+        see https://lightning.bitflyer.com/docs?lang=en#get-open-interest-summary
         :param str[] symbols: list of unified market symbols
         :param dict [params]: extra parameters specific to the bitflyer api endpoint
         :returns dict[]: a list of `position structure <https://github.com/ccxt/ccxt/wiki/Manual#position-structure>`
@@ -745,6 +759,7 @@ class bitflyer(Exchange, ImplicitAPI):
     def withdraw(self, code: str, amount, address, tag=None, params={}):
         """
         make a withdrawal
+        see https://lightning.bitflyer.com/docs?lang=en#withdrawing-funds
         :param str code: unified currency code
         :param float amount: the amount to withdraw
         :param str address: the address to withdraw to
@@ -773,6 +788,7 @@ class bitflyer(Exchange, ImplicitAPI):
     def fetch_deposits(self, code: Optional[str] = None, since: Optional[int] = None, limit: Optional[int] = None, params={}):
         """
         fetch all deposits made to an account
+        see https://lightning.bitflyer.com/docs?lang=en#get-crypto-assets-deposit-history
         :param str code: unified currency code
         :param int [since]: the earliest time in ms to fetch deposits for
         :param int [limit]: the maximum number of deposits structures to retrieve
@@ -806,6 +822,7 @@ class bitflyer(Exchange, ImplicitAPI):
     def fetch_withdrawals(self, code: Optional[str] = None, since: Optional[int] = None, limit: Optional[int] = None, params={}):
         """
         fetch all withdrawals made from an account
+        see https://lightning.bitflyer.com/docs?lang=en#get-crypto-assets-transaction-history
         :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

ccxt/bitget.py

@@ -1084,6 +1084,7 @@ class bitget(Exchange, ImplicitAPI):
     def fetch_time(self, params={}):
         """
         fetches the current integer timestamp in milliseconds from the exchange server
+        see https://bitgetlimited.github.io/apidoc/en/spot/#get-server-time
         :param dict [params]: extra parameters specific to the bitget api endpoint
         :returns int: the current integer timestamp in milliseconds from the exchange server
         """
@@ -1101,6 +1102,8 @@ class bitget(Exchange, ImplicitAPI):
     def fetch_markets(self, params={}):
         """
         retrieves data on all markets for bitget
+        see https://bitgetlimited.github.io/apidoc/en/spot/#get-symbols
+        see https://bitgetlimited.github.io/apidoc/en/mix/#get-all-symbols
         :param dict [params]: extra parameters specific to the exchange api endpoint
         :returns dict[]: an array of objects representing market data
         """
@@ -1357,6 +1360,7 @@ class bitget(Exchange, ImplicitAPI):
     def fetch_currencies(self, params={}):
         """
         fetches all available currencies on an exchange
+        see https://bitgetlimited.github.io/apidoc/en/spot/#get-coin-list
         :param dict [params]: extra parameters specific to the bitget api endpoint
         :returns dict: an associative dictionary of currencies
         """
@@ -1770,6 +1774,7 @@ class bitget(Exchange, ImplicitAPI):
     def fetch_deposit_address(self, code: str, params={}):
         """
         fetch the deposit address for a currency associated with self account
+        see https://bitgetlimited.github.io/apidoc/en/spot/#get-coin-address
         :param str code: unified currency code
         :param dict [params]: extra parameters specific to the bitget api endpoint
         :returns dict: an `address structure <https://github.com/ccxt/ccxt/wiki/Manual#address-structure>`
@@ -1824,6 +1829,8 @@ class bitget(Exchange, ImplicitAPI):
     def fetch_order_book(self, symbol: str, limit: Optional[int] = None, params={}):
         """
         fetches information on open orders with bid(buy) and ask(sell) prices, volumes and other data
+        see https://bitgetlimited.github.io/apidoc/en/spot/#get-depth
+        see https://bitgetlimited.github.io/apidoc/en/mix/#get-depth
         :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 bitget api endpoint
@@ -1976,6 +1983,8 @@ class bitget(Exchange, ImplicitAPI):
     def fetch_ticker(self, symbol: str, params={}):
         """
         fetches a price ticker, a statistical calculation with the information calculated over the past 24 hours for a specific market
+        see https://bitgetlimited.github.io/apidoc/en/spot/#get-single-ticker
+        see https://bitgetlimited.github.io/apidoc/en/mix/#get-single-symbol-ticker
         :param str symbol: unified symbol of the market to fetch the ticker for
         :param dict [params]: extra parameters specific to the bitget api endpoint
         :returns dict: a `ticker structure <https://github.com/ccxt/ccxt/wiki/Manual#ticker-structure>`
@@ -2283,6 +2292,7 @@ class bitget(Exchange, ImplicitAPI):
     def fetch_trading_fee(self, symbol: str, params={}):
         """
         fetch the trading fees for a market
+        see https://bitgetlimited.github.io/apidoc/en/spot/#get-single-symbol
         :param str symbol: unified market symbol
         :param dict [params]: extra parameters specific to the bitget api endpoint
         :returns dict: a `fee structure <https://github.com/ccxt/ccxt/wiki/Manual#fee-structure>`
@@ -2319,6 +2329,7 @@ class bitget(Exchange, ImplicitAPI):
     def fetch_trading_fees(self, params={}):
         """
         fetch the trading fees for multiple markets
+        see https://bitgetlimited.github.io/apidoc/en/spot/#get-symbols
         :param dict [params]: extra parameters specific to the bitget api endpoint
         :returns dict: a dictionary of `fee structures <https://github.com/ccxt/ccxt/wiki/Manual#fee-structure>` indexed by market symbols
         """
@@ -2491,9 +2502,9 @@ class bitget(Exchange, ImplicitAPI):
 
     def fetch_balance(self, params={}):
         """
+        query for balance and get the amount of funds available for trading or funds locked in orders
         see https://bitgetlimited.github.io/apidoc/en/spot/#get-account-assets
         see https://bitgetlimited.github.io/apidoc/en/mix/#get-account-list
-        query for balance and get the amount of funds available for trading or funds locked in orders
         :param dict [params]: extra parameters specific to the bitget api endpoint
         :returns dict: a `balance structure <https://github.com/ccxt/ccxt/wiki/Manual#balance-structure>`
         """
@@ -2742,13 +2753,13 @@ class bitget(Exchange, ImplicitAPI):
 
     def create_order(self, symbol: str, type: OrderType, side: OrderSide, amount, price=None, params={}):
         """
+        create a trade order
         see https://bitgetlimited.github.io/apidoc/en/spot/#place-order
         see https://bitgetlimited.github.io/apidoc/en/spot/#place-plan-order
         see https://bitgetlimited.github.io/apidoc/en/mix/#place-order
         see https://bitgetlimited.github.io/apidoc/en/mix/#place-stop-order
         see https://bitgetlimited.github.io/apidoc/en/mix/#place-position-tpsl
         see https://bitgetlimited.github.io/apidoc/en/mix/#place-plan-order
-        create a trade order
         :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' or 'open_long' or 'open_short' or 'close_long' or 'close_short'
@@ -2904,6 +2915,10 @@ class bitget(Exchange, ImplicitAPI):
     def edit_order(self, id: str, symbol, type, side, amount=None, price=None, params={}):
         """
         edit a trade order
+        see https://bitgetlimited.github.io/apidoc/en/spot/#modify-plan-order
+        see https://bitgetlimited.github.io/apidoc/en/mix/#modify-plan-order
+        see https://bitgetlimited.github.io/apidoc/en/mix/#modify-plan-order-tpsl
+        see https://bitgetlimited.github.io/apidoc/en/mix/#modify-stop-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'
@@ -2991,6 +3006,10 @@ class bitget(Exchange, ImplicitAPI):
     def cancel_order(self, id: str, symbol: Optional[str] = None, params={}):
         """
         cancels an open order
+        see https://bitgetlimited.github.io/apidoc/en/spot/#cancel-order
+        see https://bitgetlimited.github.io/apidoc/en/spot/#cancel-plan-order
+        see https://bitgetlimited.github.io/apidoc/en/mix/#cancel-order
+        see https://bitgetlimited.github.io/apidoc/en/mix/#cancel-plan-order-tpsl
         :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 bitget api endpoint
@@ -3028,6 +3047,8 @@ class bitget(Exchange, ImplicitAPI):
     def cancel_orders(self, ids, symbol: Optional[str] = None, params={}):
         """
         cancel multiple orders
+        see https://bitgetlimited.github.io/apidoc/en/spot/#cancel-order-in-batch-v2-single-instruments
+        see https://bitgetlimited.github.io/apidoc/en/mix/#batch-cancel-order
         :param str[] ids: order ids
         :param str symbol: unified market symbol, default is None
         :param dict [params]: extra parameters specific to the bitget api endpoint
@@ -3153,6 +3174,8 @@ class bitget(Exchange, ImplicitAPI):
     def fetch_order(self, id: str, symbol: Optional[str] = None, params={}):
         """
         fetches information on an order made by the user
+        see https://bitgetlimited.github.io/apidoc/en/spot/#get-order-details
+        see https://bitgetlimited.github.io/apidoc/en/mix/#get-order-details
         :param str symbol: unified symbol of the market the order was made in
         :param dict [params]: extra parameters specific to the bitget api endpoint
         :returns dict: An `order structure <https://github.com/ccxt/ccxt/wiki/Manual#order-structure>`
@@ -3231,11 +3254,11 @@ class bitget(Exchange, ImplicitAPI):
 
     def fetch_open_orders(self, symbol: Optional[str] = None, since: Optional[int] = None, limit: Optional[int] = None, params={}):
         """
+        fetch all unfilled currently open orders
         see https://bitgetlimited.github.io/apidoc/en/spot/#get-order-list
         see https://bitgetlimited.github.io/apidoc/en/mix/#get-all-open-order
         see https://bitgetlimited.github.io/apidoc/en/mix/#get-plan-order-tpsl-list
         see https://bitgetlimited.github.io/apidoc/en/mix/#get-open-order
-        fetch all unfilled currently open orders
         :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 order structures to retrieve
@@ -3587,6 +3610,7 @@ class bitget(Exchange, ImplicitAPI):
     def fetch_ledger(self, code: Optional[str] = None, since: Optional[int] = None, limit: Optional[int] = None, params={}):
         """
         fetch the history of changes, actions done by the user or operations that altered balance of the user
+        see https://bitgetlimited.github.io/apidoc/en/spot/#get-bills
         :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 entrys to return, default is None
@@ -3721,6 +3745,8 @@ class bitget(Exchange, ImplicitAPI):
     def fetch_order_trades(self, id: str, symbol: Optional[str] = None, since: Optional[int] = None, limit: Optional[int] = None, params={}):
         """
         fetch all the trades made from a single order
+        see https://bitgetlimited.github.io/apidoc/en/spot/#get-transaction-details
+        see https://bitgetlimited.github.io/apidoc/en/mix/#get-order-fill-detail
         :param str id: order id
         :param str symbol: unified market symbol
         :param int [since]: the earliest time in ms to fetch trades for
@@ -3771,6 +3797,7 @@ class bitget(Exchange, ImplicitAPI):
     def fetch_position(self, symbol: str, params={}):
         """
         fetch data on a single open contract trade position
+        see https://bitgetlimited.github.io/apidoc/en/mix/#get-symbol-position-v2
         :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 bitget api endpoint
         :returns dict: a `position structure <https://github.com/ccxt/ccxt/wiki/Manual#position-structure>`
@@ -3818,6 +3845,8 @@ class bitget(Exchange, ImplicitAPI):
     def fetch_positions(self, symbols: Optional[List[str]] = None, params={}):
         """
         fetch all open positions
+        see https://bitgetlimited.github.io/apidoc/en/mix/#get-all-position-v2
+        see https://bitgetlimited.github.io/apidoc/en/mix/#get-history-position
         :param str[]|None symbols: list of unified market symbols
         :param dict [params]: extra parameters specific to the bitget api endpoint
         :returns dict[]: a list of `position structure <https://github.com/ccxt/ccxt/wiki/Manual#position-structure>`
@@ -4055,6 +4084,7 @@ class bitget(Exchange, ImplicitAPI):
     def fetch_funding_rate_history(self, symbol: Optional[str] = None, since: Optional[int] = None, limit: Optional[int] = None, params={}):
         """
         fetches historical funding rate prices
+        see https://bitgetlimited.github.io/apidoc/en/mix/#get-history-funding-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://github.com/ccxt/ccxt/wiki/Manual#funding-rate-history-structure>` to fetch
@@ -4107,6 +4137,7 @@ class bitget(Exchange, ImplicitAPI):
     def fetch_funding_rate(self, symbol: str, params={}):
         """
         fetch the current funding rate
+        see https://bitgetlimited.github.io/apidoc/en/mix/#get-current-funding-rate
         :param str symbol: unified market symbol
         :param dict [params]: extra parameters specific to the bitget api endpoint
         :returns dict: a `funding rate structure <https://github.com/ccxt/ccxt/wiki/Manual#funding-rate-structure>`
@@ -4300,6 +4331,7 @@ class bitget(Exchange, ImplicitAPI):
     def reduce_margin(self, symbol: str, amount, params={}):
         """
         remove margin from a position
+        see https://bitgetlimited.github.io/apidoc/en/mix/#change-margin
         :param str symbol: unified market symbol
         :param float amount: the amount of margin to remove
         :param dict [params]: extra parameters specific to the bitget api endpoint
@@ -4315,6 +4347,7 @@ class bitget(Exchange, ImplicitAPI):
     def add_margin(self, symbol: str, amount, params={}):
         """
         add margin
+        see https://bitgetlimited.github.io/apidoc/en/mix/#change-margin
         :param str symbol: unified market symbol
         :param float amount: amount of margin to add
         :param dict [params]: extra parameters specific to the bitget api endpoint
@@ -4328,6 +4361,7 @@ class bitget(Exchange, ImplicitAPI):
     def fetch_leverage(self, symbol: str, params={}):
         """
         fetch the set leverage for a market
+        see https://bitgetlimited.github.io/apidoc/en/mix/#get-single-account
         :param str symbol: unified market symbol
         :param dict [params]: extra parameters specific to the bitget api endpoint
         :returns dict: a `leverage structure <https://github.com/ccxt/ccxt/wiki/Manual#leverage-structure>`
@@ -4370,6 +4404,7 @@ class bitget(Exchange, ImplicitAPI):
     def set_leverage(self, leverage, symbol: Optional[str] = None, params={}):
         """
         set the level of leverage for a market
+        see https://bitgetlimited.github.io/apidoc/en/mix/#change-leverage
         :param float leverage: the rate of leverage
         :param str symbol: unified market symbol
         :param dict [params]: extra parameters specific to the bitget api endpoint
@@ -4389,6 +4424,7 @@ class bitget(Exchange, ImplicitAPI):
     def set_margin_mode(self, marginMode, symbol: Optional[str] = None, params={}):
         """
         set margin mode to 'cross' or 'isolated'
+        see https://bitgetlimited.github.io/apidoc/en/mix/#change-margin-mode
         :param str marginMode: 'cross' or 'isolated'
         :param str symbol: unified market symbol
         :param dict [params]: extra parameters specific to the bitget api endpoint
@@ -4414,6 +4450,7 @@ class bitget(Exchange, ImplicitAPI):
     def set_position_mode(self, hedged, symbol: Optional[str] = None, params={}):
         """
         set hedged to True or False for a market
+        see https://bitgetlimited.github.io/apidoc/en/mix/#change-hold-mode
         :param bool hedged: set to True to use dualSidePosition
         :param str symbol: not used by bitget setPositionMode()
         :param dict [params]: extra parameters specific to the bitget api endpoint

ccxt/bitmart.py

@@ -1887,7 +1887,7 @@ class bitmart(Exchange, ImplicitAPI):
         #        "updateTime" : 1681701559408
         #    }
         #
-        # swap: fetchOpenOrders
+        # swap: fetchOrder, fetchOpenOrders
         #
         #     {
         #         "order_id": "230935812485489",
@@ -2369,26 +2369,89 @@ class bitmart(Exchange, ImplicitAPI):
 
     def fetch_order(self, id: str, symbol: Optional[str] = None, params={}):
         """
+        fetches information on an order made by the user
         see https://developer-pro.bitmart.com/en/spot/#query-order-by-id-v4-signed
         see https://developer-pro.bitmart.com/en/spot/#query-order-by-clientorderid-v4-signed
-        fetches information on an order made by the user
+        see https://developer-pro.bitmart.com/en/futures/#get-order-detail-keyed
+        :param str id: the id of the order
         :param str symbol: unified symbol of the market the order was made in
         :param dict [params]: extra parameters specific to the bitmart api endpoint
-        :param str [params.clientOrderId]: fetch the order by client order id instead of order id
+        :param str [params.clientOrderId]: *spot* fetch the order by client order id instead of order id
         :returns dict: An `order structure <https://github.com/ccxt/ccxt/wiki/Manual#order-structure>`
         """
         self.load_markets()
         request = {}
-        clientOrderId = self.safe_string(params, 'clientOrderId')
-        if not clientOrderId:
-            request['orderId'] = id
+        type = None
+        market = None
         response = None
-        if clientOrderId is not None:
-            response = self.privatePostSpotV4QueryClientOrder(self.extend(request, params))
-        else:
-            response = self.privatePostSpotV4QueryOrder(self.extend(request, params))
+        if symbol is not None:
+            market = self.market(symbol)
+        type, params = self.handle_market_type_and_params('fetchOrder', market, params)
+        if type == 'spot':
+            clientOrderId = self.safe_string(params, 'clientOrderId')
+            if not clientOrderId:
+                request['orderId'] = id
+            if clientOrderId is not None:
+                response = self.privatePostSpotV4QueryClientOrder(self.extend(request, params))
+            else:
+                response = self.privatePostSpotV4QueryOrder(self.extend(request, params))
+        elif type == 'swap':
+            self.check_required_symbol('fetchOrder', symbol)
+            request['symbol'] = market['id']
+            request['order_id'] = id
+            response = self.privateGetContractPrivateOrder(self.extend(request, params))
+        #
+        # spot
+        #
+        #     {
+        #         "code": 1000,
+        #         "message": "success",
+        #         "data": {
+        #             "orderId": "183347420821295423",
+        #             "clientOrderId": "183347420821295423",
+        #             "symbol": "BTC_USDT",
+        #             "side": "buy",
+        #             "orderMode": "spot",
+        #             "type": "limit",
+        #             "state": "new",
+        #             "price": "24000.00",
+        #             "priceAvg": "0.00",
+        #             "size": "0.00022",
+        #             "filledSize": "0.00000",
+        #             "notional": "5.28000000",
+        #             "filledNotional": "0.00000000",
+        #             "createTime": 1695783014734,
+        #             "updateTime": 1695783014762
+        #         },
+        #         "trace": "ce3e6422c8b44d5fag855348a68693ed.63.14957831547451715"
+        #     }
+        #
+        # swap
+        #
+        #     {
+        #         "code": 1000,
+        #         "message": "Ok",
+        #         "data": {
+        #             "order_id": "230927283405028",
+        #             "client_order_id": "",
+        #             "price": "23000",
+        #             "size": "1",
+        #             "symbol": "BTCUSDT",
+        #             "state": 2,
+        #             "side": 1,
+        #             "type": "limit",
+        #             "leverage": "10",
+        #             "open_type": "isolated",
+        #             "deal_avg_price": "0",
+        #             "deal_size": "0",
+        #             "create_time": 1695783433600,
+        #             "update_time": 1695783433613
+        #         },
+        #         "trace": "4cad855075664097af6ba5257c47605d.63.14957831547451715"
+        #     }
+        #
         data = self.safe_value(response, 'data', {})
-        return self.parse_order(data, None)
+        return self.parse_order(data, market)
 
     def fetch_deposit_address(self, code: str, params={}):
         """

ccxt/pro/__init__.py

@@ -4,7 +4,7 @@
 
 # ----------------------------------------------------------------------------
 
-__version__ = '4.0.108'
+__version__ = '4.0.109'
 
 # ----------------------------------------------------------------------------
 

{ccxt-4.0.108.dist-info → ccxt-4.0.109.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ccxt
-Version: 4.0.108
+Version: 4.0.109
 Summary: A JavaScript / TypeScript / Python / C# / PHP cryptocurrency trading library with support for 130+ exchanges
 Home-page: https://ccxt.com
 Author: Igor Kroitor
@@ -258,13 +258,13 @@ console.log(version, Object.keys(exchanges));
 
 All-in-one browser bundle (dependencies included), served from a CDN of your choice:
 
-* jsDelivr: https://cdn.jsdelivr.net/npm/ccxt@4.0.108/dist/ccxt.browser.js
-* unpkg: https://unpkg.com/ccxt@4.0.108/dist/ccxt.browser.js
+* jsDelivr: https://cdn.jsdelivr.net/npm/ccxt@4.0.109/dist/ccxt.browser.js
+* unpkg: https://unpkg.com/ccxt@4.0.109/dist/ccxt.browser.js
 
 CDNs are not updated in real-time and may have delays. Defaulting to the most recent version without specifying the version number is not recommended. Please, keep in mind that we are not responsible for the correct operation of those CDN servers.
 
 ```HTML
-<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/ccxt@4.0.108/dist/ccxt.browser.js"></script>
+<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/ccxt@4.0.109/dist/ccxt.browser.js"></script>
 ```
 
 Creates a global `ccxt` object:

{ccxt-4.0.108.dist-info → ccxt-4.0.109.dist-info}/RECORD

@@ -1,4 +1,4 @@
-ccxt/__init__.py,sha256=JDkjiG_IS1eGKI5MbgyYk2wqZdPHXmWJv1tTA0xvY30,15510
+ccxt/__init__.py,sha256=o7TaK9wfnn1aN6qnGC0unjnlmCIbA0ifJEgx08uAncI,15510
 ccxt/ace.py,sha256=Xisv0lJgU05Ir1H00uwBDsBC7H6-1Qdv7x2qKgVv64Y,41499
 ccxt/alpaca.py,sha256=H7GYF2I-ci7WgtFHG3G74vGL8qbfIYkFI5EJrnrGWdA,33648
 ccxt/ascendex.py,sha256=01s6du4Jb3KA_iJi-_RDzYnUzApyB60Z7FnstNQLbV0,132963
@@ -15,12 +15,12 @@ ccxt/bitbay.py,sha256=xAIjzGRDVGwoy-Gygd99H0YN4wiaz_0lR0Z14oxaaxc,478
 ccxt/bitbns.py,sha256=TPKOIFsUT-J2yCsY852h6UjIrypjGQO1RU-V8h6J-i4,46126
 ccxt/bitcoincom.py,sha256=PyWIl4nC4jp5Uba2lI1At0N_hhNyWD0DoZC_MSyL_s4,502
 ccxt/bitfinex.py,sha256=3cXEYE2fIrrxwzr4WIXkt2PaeieXJ7aJoz__J-gm660,69726
-ccxt/bitfinex2.py,sha256=jf-QpXi6lZCQ0SXy21oAgG1yOywFF5BKec3zoOB4baY,125551
-ccxt/bitflyer.py,sha256=FSekIxCgCv2LkMR7qD5dhxIl3yhfEBR7CoVBuatHylg,38908
+ccxt/bitfinex2.py,sha256=M2XyzQAaxGQubdiZJiB05ghMRiLIDHlgIwoVrn9hfFQ,125551
+ccxt/bitflyer.py,sha256=_9Sx4v_I_2BsP3lCDWXYen-ElWfcFQdVn0qkz_9m3DU,40165
 ccxt/bitforex.py,sha256=UP5UluKnDzFoEaAMse9mz8vKHQBndgbW99CT1r1qUCI,32527
-ccxt/bitget.py,sha256=HED1hKPyW1sCT_DbCrN0Lpgf3uH0vdKerMzUtkvkqEs,241391
+ccxt/bitget.py,sha256=HpTflSiim_tuexkc4mj__b2xstBUYT9J-Hl3GTk6brY,244269
 ccxt/bithumb.py,sha256=dyl82al-skvUyV9FYcvqQ9-7rwhl1W8WPh6VE7sNwss,43074
-ccxt/bitmart.py,sha256=vRBP8qRTGbH62N--kiHf5-0NEEi4YFWnQ_qY08tnlMc,158543
+ccxt/bitmart.py,sha256=GgtAO8oH11H08yPL1sddvJLGC_A1INmXp5CcjblZutQ,161043
 ccxt/bitmex.py,sha256=dkFQqdfd_oqN0U7sPIp0v0l8aiOH2i6PEnd8JFY2qR8,112072
 ccxt/bitopro.py,sha256=R7OkzgezCpqGNOjjbY11XoG5TxMhdy5igS6COMeBOfM,65937
 ccxt/bitpanda.py,sha256=OIFHYnE0bl7ri0qvhdBBBRB8nXcdYI4jyCrP7Mai39U,88146
@@ -212,7 +212,7 @@ ccxt/abstract/woo.py,sha256=Z3ua45hKE0Tf9rtfSEYYgGEztaTO1Ri3mKl_hIo3OHs,8768
 ccxt/abstract/yobit.py,sha256=8ycfCO8ORFly9hc0Aa47sZyX4_ZKPXS9h9yJzI-uQ7Q,1339
 ccxt/abstract/zaif.py,sha256=m15WHdl3gYy0GOXNZ8NEH8eE7sVh8c0T_ITNuU8vXeU,3935
 ccxt/abstract/zonda.py,sha256=VoxuPkSq8vAvKnDvOqnByhwsIf09m7yIrs8HejFrDk4,5482
-ccxt/async_support/__init__.py,sha256=c0KzJGf_7KH9oSUcZbj4whGD6nAKh2VJKdaroRgWZlI,15283
+ccxt/async_support/__init__.py,sha256=Fiju1w9seUdgdqXJuQw3Jp0A0b-Z7r_ry2bHwLjTzZc,15283
 ccxt/async_support/ace.py,sha256=GfB1wI9oK_nmj2IH-J1KYXkg8qjzWlWK7SaMuZCWRdk,41723
 ccxt/async_support/alpaca.py,sha256=frGPbeZHd2nEN9Q45phgnNOmU4Brh9e_FgDEEFnRyVM,33794
 ccxt/async_support/ascendex.py,sha256=Cv4Okc5hRD23CVReRIT9vrI_4hWtvTyOWts5XXohW_c,133595
@@ -229,12 +229,12 @@ ccxt/async_support/bitbay.py,sha256=jcaEXi2IhYTva8ezO_SfJhwxEZk7HST4J3NaxD16BQA,
 ccxt/async_support/bitbns.py,sha256=eMxtO2nPEwnQRSGJbBPIvA6_45yb3ZR_NjqpxIcVVI8,46380
 ccxt/async_support/bitcoincom.py,sha256=RiqwhK3RfxQ_PXTa860fphDCvwA8dalL-_rXlK85-8A,516
 ccxt/async_support/bitfinex.py,sha256=7I0krKkjVQm3yRGLR8GqzfTuMS094bs7q1pT0Kzc1vk,70166
-ccxt/async_support/bitfinex2.py,sha256=FjVRA5e37Wh3GvG1RVLDOA4Zs0l1nfqQexbd-3oKVT4,126081
-ccxt/async_support/bitflyer.py,sha256=YN7qyrXFv7y90NnCfDK7hEK7PrdeZdYSmAn_wJPLdbo,39216
+ccxt/async_support/bitfinex2.py,sha256=NNT89B72sese2w_So5ar_YzQ3D5S1i9YSpFU4idp-4Y,126081
+ccxt/async_support/bitflyer.py,sha256=t11TghcCU9YjEGyhnnpKLmrBBw2oykMwVjAtrUkWFGk,40473
 ccxt/async_support/bitforex.py,sha256=ge_qf_eQuR1dPOUbJO0jS6X9trIzsiEJXBmARDyCtew,32751
-ccxt/async_support/bitget.py,sha256=dzZIIcU_IVQX9gprPCwTN_TIJQRwnOvJGiSXVs0nBA8,242331
+ccxt/async_support/bitget.py,sha256=pv86dxxqN2D25GY3h7UMjqMbmfRXUwvRNZGZ-2AobzM,245209
 ccxt/async_support/bithumb.py,sha256=BJH9BmwgZS4ackInyblR7OFGcGO1PPM_vo_EfiF1S6I,43292
-ccxt/async_support/bitmart.py,sha256=VM0eZDIyRpbx__S3Y-EQlFNVdD0EWAsIZGIY3PyVULk,159301
+ccxt/async_support/bitmart.py,sha256=IwxyXORCFHJvWakBtZglXVEYTwJLi2R9j8W41kWQnSQ,161807
 ccxt/async_support/bitmex.py,sha256=njhJTJpA33Y3Y0V7iqMoKPR8hVUEzxQDTRT01jQvtQg,112566
 ccxt/async_support/bitopro.py,sha256=QDDPn43DHNFet4EKuBvWeecKzH5_VW0aPfzxjkOoHvs,66323
 ccxt/async_support/bitpanda.py,sha256=c1AyFnzoPAK6gsCAWYKHpCHuu-Grj6pBGWIQHCG2EUM,88598
@@ -321,7 +321,7 @@ ccxt/async_support/yobit.py,sha256=DzNq6XftuoDjBNDZBJOrsGVv3M8wcXz_pRDEA23x4Dc,5
 ccxt/async_support/zaif.py,sha256=3iz6oNEYONAjhCLVKK13T1d2eQ0pklzgxCkkdqn5zyM,29070
 ccxt/async_support/zonda.py,sha256=BGNx6UYa19tDo_UBLPC6sJKirzTQsuQpdpzsXiVR0JE,79973
 ccxt/async_support/base/__init__.py,sha256=aVYSsFi--b4InRs9zDN_wtCpj8odosAB726JdUHavrk,67
-ccxt/async_support/base/exchange.py,sha256=fUPJjdBFtDvZkvfClsOrfwb3luqWgHDL1hSmHSbWzLY,148587
+ccxt/async_support/base/exchange.py,sha256=uvyUSfyugMNEPCbU3ldf3aUIqR-LijhegHcxg1bdaP4,148587
 ccxt/async_support/base/throttler.py,sha256=tvDVcdRUVYi8fZRlEcnqtgzcgB_KMUMRs5Pu8tuU-tU,1847
 ccxt/async_support/base/ws/__init__.py,sha256=uockzpLuwntKGZbs5EOWFe-Zg-k6Cj7GhNJLc_RX0so,1791
 ccxt/async_support/base/ws/aiohttp_client.py,sha256=3YtsI6nV2ViYIZB7sGaowpoiF9Xaf93gHXH98253mJQ,5011
@@ -335,10 +335,10 @@ ccxt/async_support/base/ws/order_book_side.py,sha256=GH-475Ni0mLOx7mUDnz4jjzaGkh
 ccxt/base/__init__.py,sha256=eTx1OE3HJjspFUQjGm6LBhaQiMKJnXjkdP-JUXknyQ0,1320
 ccxt/base/decimal_to_precision.py,sha256=fgWRBzRTtsf3r2INyS4f7WHlzgjB5YM1ekiwqD21aac,6634
 ccxt/base/errors.py,sha256=7osw6WIoqf-dmzvQI5Lnau4AvnCahiM2-mlyNm4GRxY,3610
-ccxt/base/exchange.py,sha256=DR0IevGXrp-2p-zccXNSZtkyetG3RzSqsR-DbxeDc7Q,188637
+ccxt/base/exchange.py,sha256=TKClBkEt-O2npMmV-3fklEMR7uYf6_n18QNkIkg-HP8,188637
 ccxt/base/precise.py,sha256=_xfu54sV0vWNnOfGTKRFykeuWP8mn4K1m9lk1tcllX4,8565
 ccxt/base/types.py,sha256=lqXdU_c6oZ2fP7kOYgwRAuujoqXdJc2YzrI6UzBz4KY,2108
-ccxt/pro/__init__.py,sha256=Xd4eDkc0Nbdk-zSitjCTdR2UxBhXo3UUBU0XkMhMfIk,6481
+ccxt/pro/__init__.py,sha256=NRkPj3KIRgM-NskewbW-sga-ehkLI_DP3HatPAILPwQ,6481
 ccxt/pro/alpaca.py,sha256=OO5fBSjG89OmlSY_6gy20BCs3hJMF8kWkeHtxM-JaTY,26762
 ccxt/pro/ascendex.py,sha256=oCyCw_SXW9DTfbpRYMPI5QpXvb55Ru7RvHTUx2fO8Yk,34577
 ccxt/pro/bequant.py,sha256=3IeQ0vPg-eVqPiGMfX7yqH9qtXKm1ZqocQDeLwpA8EE,1093
@@ -449,7 +449,7 @@ ccxt/test/base/test_ticker.py,sha256=h9AV_O6s-Ax3vB3sFoN0Mz22rMOi65i9BDv0SNejH98
 ccxt/test/base/test_trade.py,sha256=rOEbyHLvsB-rh7X7WOcfeOV_3MOGq_0s4ovg2SRk-2I,2284
 ccxt/test/base/test_trading_fee.py,sha256=2_WCp3qJ2UpraQQoGFlGJYwHD-T0Bm5W7KIw4zpFvSM,1068
 ccxt/test/base/test_transaction.py,sha256=BTbB4UHHXkrvYgwbrhh867nVRlevmIkIrz1W_odlQJI,1434
-ccxt-4.0.108.dist-info/METADATA,sha256=RV456lCxwtyoGs0W9ig2sl8Ht8c73-o-0WOdQHhVrc0,109965
-ccxt-4.0.108.dist-info/WHEEL,sha256=a-zpFRIJzOq5QfuhBzbhiA1eHTzNCJn8OdRvhdNX0Rk,110
-ccxt-4.0.108.dist-info/top_level.txt,sha256=CkQDuCTDKNcImPV60t36G6MdYfxsAPNiSaEwifVoVMo,5
-ccxt-4.0.108.dist-info/RECORD,,
+ccxt-4.0.109.dist-info/METADATA,sha256=9N1BH1enNSbAZboj7lqHl_ygnlcyer_68kiR-PNvbuc,109965
+ccxt-4.0.109.dist-info/WHEEL,sha256=a-zpFRIJzOq5QfuhBzbhiA1eHTzNCJn8OdRvhdNX0Rk,110
+ccxt-4.0.109.dist-info/top_level.txt,sha256=CkQDuCTDKNcImPV60t36G6MdYfxsAPNiSaEwifVoVMo,5
+ccxt-4.0.109.dist-info/RECORD,,