# -*- coding: utf-8 -*- # PLEASE DO NOT EDIT THIS FILE, IT IS GENERATED AND WILL BE OVERWRITTEN: # https://github.com/ccxt/ccxt/blob/master/CONTRIBUTING.md#how-to-contribute-code from ccxt.async_support.base.exchange import Exchange from ccxt.abstract.deepcoin import ImplicitAPI import asyncio import hashlib from ccxt.base.types import Any, Balances, Currency, DepositAddress, Int, LedgerEntry, Market, Num, Order, OrderBook, OrderSide, OrderType, Position, Str, Strings, Ticker, Tickers, FundingRate, FundingRates, Trade, Transaction, TransferEntry from typing import List from ccxt.base.errors import ExchangeError from ccxt.base.errors import ArgumentsRequired from ccxt.base.errors import BadRequest from ccxt.base.errors import InsufficientFunds from ccxt.base.errors import InvalidOrder from ccxt.base.errors import OrderNotFound from ccxt.base.errors import NotSupported from ccxt.base.errors import NullResponse from ccxt.base.decimal_to_precision import TICK_SIZE from ccxt.base.precise import Precise class deepcoin(Exchange, ImplicitAPI): def describe(self) -> Any: return self.deep_extend(super(deepcoin, self).describe(), { 'id': 'deepcoin', 'name': 'DeepCoin', 'countries': ['SG'], # Singapore 'rateLimit': 200, # 5 times per second 'version': 'v1', 'certified': False, 'pro': True, 'has': { 'CORS': None, 'spot': True, 'margin': True, 'swap': True, 'future': False, 'option': False, 'addMargin': False, 'cancelAllOrders': True, 'cancelAllOrdersAfter': False, 'cancelOrder': True, 'cancelOrders': True, 'cancelWithdraw': False, 'closePosition': True, 'createConvertTrade': False, 'createDepositAddress': False, 'createLimitBuyOrder': True, 'createLimitOrder': True, 'createLimitSellOrder': True, 'createMarketBuyOrder': True, 'createMarketBuyOrderWithCost': True, 'createMarketOrder': True, 'createMarketOrderWithCost': True, 'createMarketSellOrder': True, 'createMarketSellOrderWithCost': True, 'createOrder': True, 'createOrders': False, 'createOrderWithTakeProfitAndStopLoss': True, 'createPostOnlyOrder': True, 'createReduceOnlyOrder': True, 'createStopLossOrder': False, 'createTakeProfitOrder': False, 'createTrailingAmountOrder': False, 'createTrailingPercentOrder': False, 'createTriggerOrder': True, 'editOrder': True, 'fetchAccounts': False, 'fetchBalance': True, 'fetchCanceledAndClosedOrders': True, 'fetchCanceledOrders': True, 'fetchClosedOrder': True, 'fetchClosedOrders': True, 'fetchConvertCurrencies': False, 'fetchConvertQuote': False, 'fetchConvertTrade': False, 'fetchConvertTradeHistory': False, 'fetchCurrencies': False, 'fetchDepositAddress': True, 'fetchDepositAddresses': True, 'fetchDeposits': True, 'fetchDepositsWithdrawals': False, 'fetchDepositWithdrawFees': False, 'fetchFundingHistory': False, 'fetchFundingRate': True, 'fetchFundingRateHistory': True, 'fetchFundingRates': True, 'fetchIndexOHLCV': True, 'fetchLedger': True, 'fetchLeverage': False, 'fetchLeverageTiers': False, 'fetchMarginAdjustmentHistory': False, 'fetchMarginMode': False, 'fetchMarkets': True, 'fetchMarkOHLCV': True, 'fetchMyTrades': True, 'fetchOHLCV': True, 'fetchOpenInterest': False, 'fetchOpenInterestHistory': False, 'fetchOpenOrder': True, 'fetchOpenOrders': True, 'fetchOrder': False, 'fetchOrderBook': True, 'fetchOrders': False, 'fetchOrderTrades': True, 'fetchPosition': True, 'fetchPositionHistory': False, 'fetchPositionMode': False, 'fetchPositions': True, 'fetchPositionsForSymbol': True, 'fetchPositionsHistory': True, 'fetchPremiumIndexOHLCV': False, 'fetchStatus': False, 'fetchTicker': False, 'fetchTickers': True, 'fetchTime': False, 'fetchTrades': True, 'fetchTradingFee': False, 'fetchTradingFees': False, 'fetchTransactions': False, 'fetchTransfers': False, 'fetchWithdrawals': True, 'reduceMargin': False, 'sandbox': False, 'setLeverage': True, 'setMargin': False, 'setMarginMode': False, 'setPositionMode': False, 'transfer': True, 'withdraw': False, }, 'timeframes': { '1m': '1m', '5m': '5m', '15m': '15m', '30m': '30m', '1h': '1H', '4h': '4H', '12h': '12H', '1d': '1D', '1w': '1W', '1M': '1M', '1y': '1Y', }, 'urls': { 'logo': 'https://github.com/user-attachments/assets/671bd35c-770e-4935-9070-f8fb114f79c4', 'api': { 'public': 'https://api.deepcoin.com', 'private': 'https://api.deepcoin.com', }, 'www': 'https://www.deepcoin.com/', 'doc': 'https://www.deepcoin.com/docs', 'referral': { 'url': 'https://s.deepcoin.com/UzkyODgy', 'discount': 0.1, }, }, 'api': { 'public': { 'get': { 'deepcoin/market/books': 1, 'deepcoin/market/candles': 1, 'deepcoin/market/instruments': 1, 'deepcoin/market/tickers': 1, 'deepcoin/market/index-candles': 1, 'deepcoin/market/trades': 1, 'deepcoin/market/mark-price-candles': 1, 'deepcoin/market/step-margin': 5, }, }, 'private': { 'get': { 'deepcoin/account/balances': 5, 'deepcoin/account/bills': 5, 'deepcoin/account/positions': 5, 'deepcoin/trade/fills': 5, 'deepcoin/trade/orderByID': 5, 'deepcoin/trade/finishOrderByID': 5, 'deepcoin/trade/orders-history': 5, 'deepcoin/trade/v2/orders-pending': 5, 'deepcoin/trade/funding-rate': 5, 'deepcoin/trade/fund-rate/current-funding-rate': 5, 'deepcoin/trade/fund-rate/history': 5, 'deepcoin/trade/trigger-orders-pending': 5, 'deepcoin/trade/trigger-orders-history': 5, 'deepcoin/copytrading/support-contracts': 5, 'deepcoin/copytrading/leader-position': 5, 'deepcoin/copytrading/estimate-profit': 5, 'deepcoin/copytrading/history-profit': 5, 'deepcoin/copytrading/follower-rank': 5, 'deepcoin/internal-transfer/support': 5, 'deepcoin/internal-transfer/history-order': 5, 'deepcoin/rebate/config': 5, 'deepcoin/agents/users': 5, 'deepcoin/agents/users/rebate-list': 5, 'deepcoin/agents/users/rebates': 5, 'deepcoin/asset/deposit-list': 5, 'deepcoin/asset/withdraw-list': 5, 'deepcoin/asset/recharge-chain-list': 5, 'deepcoin/listenkey/acquire': 5, 'deepcoin/listenkey/extend': 5, }, 'post': { 'deepcoin/account/set-leverage': 5, 'deepcoin/trade/order': 5, 'deepcoin/trade/replace-order': 5, 'deepcoin/trade/cancel-order': 5, 'deepcoin/trade/batch-cancel-order': 5, 'deepcoin/trade/cancel-trigger-order': 1 / 6, 'deepcoin/trade/swap/cancel-all': 5, 'deepcoin/trade/trigger-order': 5, 'deepcoin/trade/batch-close-position': 5, 'deepcoin/trade/replace-order-sltp': 5, 'deepcoin/trade/close-position-by-ids': 5, 'deepcoin/copytrading/leader-settings': 5, 'deepcoin/copytrading/set-contracts': 5, 'deepcoin/internal-transfer': 5, 'deepcoin/rebate/config': 5, 'deepcoin/asset/transfer': 5, }, }, }, 'fees': { 'trading': { 'taker': self.parse_number('0.0015'), 'maker': self.parse_number('0.0010'), }, }, 'features': { 'spot': { 'sandbox': False, 'createOrder': { 'marginMode': True, 'triggerPrice': True, 'triggerPriceType': { 'last': True, 'mark': False, 'index': False, }, 'triggerDirection': False, 'stopLossPrice': True, 'takeProfitPrice': True, 'attachedStopLossTakeProfit': { 'triggerPriceType': { 'last': False, 'mark': False, 'index': False, }, 'price': True, }, 'timeInForce': { 'IOC': True, 'FOK': True, 'PO': True, 'GTD': False, }, 'hedged': True, 'trailing': False, 'marketBuyRequiresPrice': False, }, 'createOrders': None, 'fetchMyTrades': { 'marginMode': False, 'limit': 100, 'daysBack': 60, 'untilDays': None, 'symbolRequired': True, }, 'fetchOrder': None, 'fetchOpenOrders': { 'marginMode': False, 'limit': 100, 'trigger': True, 'trailing': False, 'symbolRequired': True, }, 'fetchOrders': None, 'fetchClosedOrders': { 'marginMode': False, 'limit': 100, 'daysBack': None, 'daysBackCanceled': None, 'untilDays': None, 'trigger': True, 'trailing': False, 'symbolRequired': True, }, 'fetchOHLCV': { 'limit': 300, }, }, 'swap': { 'linear': { 'extends': 'spot', }, 'inverse': { 'extends': 'spot', }, }, }, 'requiredCredentials': { 'apiKey': True, 'secret': True, 'password': True, }, 'precisionMode': TICK_SIZE, 'options': { 'recvWindow': 5000, 'defaultNetworks': { 'ETH': 'ERC20', 'USDT': 'TRC20', 'USDC': 'ERC20', }, 'networks': { 'ERC20': 'ERC20', 'TRC20': 'TRC20', 'ARB': 'ARBITRUM', 'BSC': 'BSC(BEP20)', 'SOL': 'SOL', 'BTC': 'Bitcoin', 'ADA': 'Cardano', }, 'networksById': { }, 'fetchMarkets': { 'types': ['spot', 'swap'], # spot, swap, }, 'timeInForce': { 'GTC': 'GTC', # Good Till Cancel 'IOC': 'IOC', # Immediate Or Cancel 'PO': 'PO', # Post Only }, 'exchangeType': { 'spot': 'SPOT', 'swap': 'SWAP', 'SPOT': 'SPOT', 'SWAP': 'SWAP', }, 'accountsByType': { 'spot': 1, 'fund': 2, 'rebate': 3, 'inverse': 5, 'linear': 7, 'demo': 10, }, }, 'commonCurrencies': {}, 'exceptions': { 'exact': { '24': OrderNotFound, # {"code":"0","msg":"","data":{"ordId":"","clOrdId":"","sCode":"24","sMsg":"OrderNotFound:1"}} '31': InsufficientFunds, # {"code":"0","msg":"","data":{"ordId":"","clOrdId":"","tag":"","sCode":"31","sMsg":"NotEnoughPositionToClose:Position=0"}} '36': InsufficientFunds, # {"code":"0","msg":"","data":{"ordId":"","clOrdId":"","tag":"","sCode":"36","sMsg":"InsufficientMoney:-0.000004"}} '44': BadRequest, # {"code":"0","msg":"","data":{"ordId":"","clOrdId":"","tag":"","sCode":"44","sMsg":"VolumeNotOnTick"}} '49': InvalidOrder, # {"code":"0","msg":"","data":{"ordId":"","clOrdId":"","tag":"","sCode":"49","sMsg":"PriceOutOfUpperLimit:Price\u003eUpperLimitPrice[0.28422]"}} '194': InvalidOrder, # {"code":"0","msg":"","data":{"ordId":"","clOrdId":"","tag":"","sCode":"194","sMsg":"LessThanMinVolume"}} '195': InvalidOrder, # {"code":"0","msg":"","data":{"ordId":"","clOrdId":"","tag":"","sCode":"195","sMsg":"PositionLessThanMinVolume"}} '199': BadRequest, # {"code":"0","msg":"","data":{"instId":"","lever":"","mgnMode":"","mrgPosition":"","sCode":"199","sMsg":"LeverageTooHigh:Amount[10000.0]\u003eLeverage[75.1880]"}} '100010': InsufficientFunds, # {"code":"0","msg":"","data":{"retCode":100010,"retMsg":"Balance is insufficient, please deposit first.","retData":{}}} 'unsupportedAction': BadRequest, 'localIDNotExist': BadRequest, }, 'broad': { 'no available': NotSupported, # orderbook does not exist: ETHUSD_0.1, no available orderbook data 'field is required': ArgumentsRequired, # {"code":"51","msg":"The productGroup field is required","data":null} 'not in acceptable range': BadRequest, # {"code":"51","msg":"The instType value `spot` is not in acceptable range: SPOT,SWAP","data":null} 'subscription cluster does not "exist"': BadRequest, 'must be equal or lesser than': BadRequest, # {"code":"51","msg":"The Size value `100` must be equal or lesser than 50","data":null} }, }, }) def handle_market_type_and_params(self, methodName: str, market: Market = None, params={}, defaultValue=None) -> Any: instType = self.safe_string(params, 'instType') params = self.omit(params, 'instType') type = self.safe_string(params, 'type') if (type is None) and (instType is not None): params = self.extend(params, {'type': instType}) return super(deepcoin, self).handle_market_type_and_params(methodName, market, params, defaultValue) def convert_to_instrument_type(self, type): exchangeTypes = self.safe_dict(self.options, 'exchangeType', {}) return self.safe_string(exchangeTypes, type, type) async def fetch_markets(self, params={}) -> List[Market]: """ https://www.deepcoin.com/docs/DeepCoinMarket/getBaseInfo retrieves data on all markets for okcoin :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict[]: an array of objects representing market data """ types = ['spot', 'swap'] fetchMarketsOption = self.safe_dict(self.options, 'fetchMarkets') if fetchMarketsOption is not None: types = self.safe_list(fetchMarketsOption, 'types', types) else: types = self.safe_list(self.options, 'fetchMarkets', types) # backward-support promises = [] result = [] for i in range(0, len(types)): promises.append(self.fetch_markets_by_type(types[i], params)) promises = await asyncio.gather(*promises) for i in range(0, len(promises)): result = self.array_concat(result, promises[i]) return result async def fetch_markets_by_type(self, type, params={}): request: dict = { 'instType': self.convert_to_instrument_type(type), } response = await self.publicGetDeepcoinMarketInstruments(self.extend(request, params)) # # spot # # { # "code": "0", # "msg": "", # "data": [ # { # "instType": "SPOT", # "instId": "A-USDT", # "uly": "", # "baseCcy": "A", # "quoteCcy": "USDT", # "ctVal": "1", # "ctValCcy": "", # "listTime": "0", # "lever": "1", # "tickSz": "0.0001", # "lotSz": "0.001", # "minSz": "0.5", # "ctType": "", # "alias": "", # "state": "live", # "maxLmtSz": "7692307", # "maxMktSz": "7692307" # } # ] # } # dataResponse = self.safe_list(response, 'data', []) return self.parse_markets(dataResponse) def parse_market(self, market: dict) -> Market: # # spot markets # # { # "instType": "SPOT", # "instId": "A-USDT", # "uly": "", # "baseCcy": "A", # "quoteCcy": "USDT", # "ctVal": "1", # "ctValCcy": "", # "listTime": "0", # "lever": "1", # "tickSz": "0.0001", # "lotSz": "0.001", # "minSz": "0.5", # "ctType": "", # "alias": "", # "state": "live", # "maxLmtSz": "7692307", # "maxMktSz": "7692307" # } # # swap markets # # { # "instType": "SWAP", # "instId": "ZORA-USDT-SWAP", # "uly": "", # "baseCcy": "ZORA", # "quoteCcy": "USDT", # "ctVal": "1", # "ctValCcy": "", # "listTime": "0", # "lever": "20", # "tickSz": "0.00001", # "lotSz": "1", # "minSz": "1685", # "ctType": "", # "alias": "", # "state": "live", # "maxLmtSz": "10000000", # "maxMktSz": "10000000" # } # id = self.safe_string(market, 'instId') type = self.safe_string_lower(market, 'instType') spot = (type == 'spot') swap = (type == 'swap') baseId = self.safe_string(market, 'baseCcy') quoteId = self.safe_string(market, 'quoteCcy', '') settleId = None settle = None base = self.safe_currency_code(baseId) quote = self.safe_currency_code(quoteId) symbol = base + '/' + quote isLinear = None if swap: isLinear = (quoteId != 'USD') settleId = quoteId if isLinear else baseId settle = self.safe_currency_code(settleId) symbol = symbol + ':' + settle fees = self.safe_dict_2(self.fees, type, 'trading', {}) maxLeverage = self.safe_string(market, 'lever', '1') maxLeverage = Precise.string_max(maxLeverage, '1') maxMarketSize = self.safe_string(market, 'maxMktSz') maxLimitSize = self.safe_string(market, 'maxLmtSz') maxAmount = self.parse_number(Precise.string_max(maxMarketSize, maxLimitSize)) state = self.safe_string(market, 'state') return self.extend(fees, { 'id': id, 'symbol': symbol, 'base': base, 'quote': quote, 'settle': settle, 'baseId': baseId, 'quoteId': quoteId, 'settleId': settleId, 'type': type, 'spot': spot, 'margin': spot and (Precise.string_gt(maxLeverage, '1')), 'swap': swap, 'future': False, 'option': False, 'active': state == 'live', 'contract': swap, 'linear': isLinear, 'inverse': (not isLinear) if swap else None, 'contractSize': self.safe_number(market, 'ctVal') if swap else None, 'expiry': None, 'expiryDatetime': None, 'strike': None, 'optionType': None, 'created': None, 'precision': { 'amount': self.safe_number(market, 'lotSz'), 'price': self.safe_number(market, 'tickSz'), }, 'limits': { 'leverage': { 'min': self.parse_number('1'), 'max': self.parse_number(maxLeverage), }, 'amount': { 'min': self.safe_number(market, 'minSz'), 'max': maxAmount, }, 'price': { 'min': None, 'max': None, }, 'cost': { 'min': None, 'max': None, }, }, 'info': market, }) def set_markets(self, markets, currencies=None): markets = super(deepcoin, self).set_markets(markets, currencies) symbols = list(markets.keys()) for i in range(0, len(symbols)): symbol = symbols[i] market = markets[symbol] if market['swap']: additionalId = market['baseId'] + market['quoteId'] self.markets_by_id[additionalId] = [market] # some endpoints return swap market id+quote return self.markets 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 https://www.deepcoin.com/docs/DeepCoinMarket/marketBooks :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 :returns dict: A dictionary of `order book structures ` indexed by market symbols """ await self.load_markets() market = self.market(symbol) if limit is None: limit = 400 request: dict = { 'instId': market['id'], 'sz': limit, } response = await self.publicGetDeepcoinMarketBooks(self.extend(request, params)) # # { # "code": "0", # "msg": "", # "data": { # "bids": [ # ["3732.21", "99.6"], # ["3732.2", "54.7"] # ], # "asks": [ # ["3732.22", "85.1"], # ["3732.23", "49.4"] # ] # } # } # data = self.safe_dict(response, 'data', {}) return self.parse_order_book(data, symbol, None, 'bids', 'asks', 0, 1) 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 https://www.deepcoin.com/docs/DeepCoinMarket/getKlineData https://www.deepcoin.com/docs/DeepCoinMarket/getIndexKlineData https://www.deepcoin.com/docs/DeepCoinMarket/getMarkKlineData :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 :param int [limit]: the maximum amount of candles to fetch :param dict [params]: extra parameters specific to the exchange API endpoint :param int [params.until]: timestamp in ms of the latest candle to fetch :param str [params.price]: "mark" or "index" for mark price and index price candles :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) :returns int[][]: A list of candles ordered, open, high, low, close, volume """ await self.load_markets() maxLimit = 300 paginate = False paginate, params = self.handle_option_and_params(params, 'fetchOHLCV', 'paginate', False) if paginate: params = self.extend(params, {'calculateUntil': True}) return await self.fetch_paginated_call_deterministic('fetchOHLCV', symbol, since, limit, timeframe, params, maxLimit) market = self.market(symbol) price = self.safe_string(params, 'price') params = self.omit(params, 'price') bar = self.safe_string(self.timeframes, timeframe, timeframe) request: dict = { 'instId': market['id'], 'bar': bar, } if limit is not None: request['limit'] = limit until = self.safe_integer(params, 'until') if until is not None: request['after'] = until params = self.omit(params, 'until') calculateUntil = self.safe_bool(params, 'calculateUntil', False) if calculateUntil: params = self.omit(params, 'calculateUntil') if since is not None: # the exchange do not have a since param for self endpoint # we canlculate until(after) for correct pagination duration = self.parse_timeframe(timeframe) numberOfCandles = maxLimit if (limit is None) else limit endTime = since + (duration * numberOfCandles) * 1000 if until is not None: endTime = min(endTime, until) now = self.milliseconds() request['after'] = min(endTime, now) response = None if price == 'mark': response = await self.publicGetDeepcoinMarketMarkPriceCandles(self.extend(request, params)) elif price == 'index': response = await self.publicGetDeepcoinMarketIndexCandles(self.extend(request, params)) else: response = await self.publicGetDeepcoinMarketCandles(self.extend(request, params)) # # { # "code": "0", # "msg": "", # "data":[ # [ # "1760221800000", # "3739.08", # "3741.95", # "3737.75", # "3740.1", # "2849", # "1065583.744" # ], # [ # "1760221740000", # "3742.36", # "3743.01", # "3736.83", # "3739.08", # "2723", # "1018290.723" # ] # ] # } # data = self.safe_list(response, 'data', []) return self.parse_ohlcvs(data, market, timeframe, since, limit) 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 https://www.deepcoin.com/docs/DeepCoinMarket/getMarketTickers :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 :returns dict: a dictionary of `ticker structures ` """ await self.load_markets() symbols = self.market_symbols(symbols) market = self.get_market_from_symbols(symbols) marketType = None marketType, params = self.handle_market_type_and_params('fetchTickers', market, params) request: dict = { 'instType': self.convert_to_instrument_type(marketType), } response = await self.publicGetDeepcoinMarketTickers(self.extend(request, params)) tickers = self.safe_list(response, 'data', []) return self.parse_tickers(tickers, symbols) def parse_ticker(self, ticker: dict, market: Market = None) -> Ticker: # # { # "instType": "SWAP", # "instId": "BTC-USD-SWAP", # "last": "114113.3", # "lastSz": "", # "askPx": "114113.5", # "askSz": "56280", # "bidPx": "114113.2", # "bidSz": "63220", # "open24h": "113214.7", # "high24h": "116039.2", # "low24h": "113214.7", # "volCcy24h": "73.31475724", # "vol24h": "8406739", # "sodUtc0": "", # "sodUtc8": "", # "ts": "1760367816000" # } # timestamp = self.safe_integer(ticker, 'ts') marketId = self.safe_string(ticker, 'instId') market = self.safe_market(marketId, market, '-') symbol = market['symbol'] last = self.safe_string(ticker, 'last') open = self.safe_string(ticker, 'open24h') quoteVolume = self.safe_string(ticker, 'volCcy24h') baseVolume = self.safe_string(ticker, 'vol24h') if market['swap'] and market['inverse']: temp = baseVolume baseVolume = quoteVolume quoteVolume = temp high = self.safe_string(ticker, 'high24h') low = self.safe_string(ticker, 'low24h') return self.safe_ticker({ 'symbol': symbol, 'timestamp': timestamp, 'datetime': self.iso8601(timestamp), 'high': high, 'low': low, 'bid': self.safe_string(ticker, 'bidPx'), 'bidVolume': self.safe_string(ticker, 'bidSz'), 'ask': self.safe_string(ticker, 'askPx'), 'askVolume': self.safe_string(ticker, 'askSz'), 'vwap': None, 'open': open, 'close': last, 'last': last, 'previousClose': None, 'change': None, 'percentage': None, 'average': None, 'baseVolume': baseVolume, 'quoteVolume': quoteVolume, 'markPrice': None, 'indexPrice': None, 'info': ticker, }, market) 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 https://www.deepcoin.com/docs/DeepCoinMarket/getTrades :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(default 100, max 500) :param dict [params]: extra parameters specific to the exchange API endpoint :returns Trade[]: a list of `trade structures ` """ await self.load_markets() market = self.market(symbol) request: dict = { 'instId': market['id'], } if limit is not None: request['limit'] = limit # default 100, max 500 productGroup = self.get_product_group_from_market(market) request['productGroup'] = productGroup response = await self.publicGetDeepcoinMarketTrades(self.extend(request, params)) data = self.safe_list(response, 'data', []) return self.parse_trades(data, market, since, limit) def get_product_group_from_market(self, market: Market) -> str: productGroup = 'Spot' if market['swap']: if market['linear']: productGroup = 'SwapU' else: productGroup = 'Swap' return productGroup def parse_trade(self, trade: dict, market: Market = None) -> Trade: # # public fetchTrades # # { # "instId": "ETH-USDT", # "tradeId": "1001056388761321", # "px": "4095.66", # "sz": "0.01311251", # "side": "sell", # "ts": "1760367870000" # } # # private fetchMyTrades # { # "instType": "SPOT", # "instId": "ETH-USDT", # "tradeId": "1001056429613610", # "ordId": "1001435238208686", # "clOrdId": "", # "billId": "10010564296136101", # "tag": "", # "fillPx": "3791.15", # "fillSz": "0.004", # "side": "sell", # "posSide": "", # "execType": "", # "feeCcy": "USDT", # "fee": "0.0151646", # "ts": "1760704540000" # } # marketId = self.safe_string(trade, 'instId') market = self.safe_market(marketId, market) timestamp = self.safe_integer(trade, 'ts') side = self.safe_string(trade, 'side') execType = self.safe_string(trade, 'execType') fee = None feeCost = self.safe_string(trade, 'fee') if feeCost is not None: feeCurrencyId = self.safe_string(trade, 'feeCcy') feeCurrencyCode = self.safe_currency_code(feeCurrencyId) fee = { 'cost': feeCost, 'currency': feeCurrencyCode, } return self.safe_trade({ 'info': trade, 'timestamp': timestamp, 'datetime': self.iso8601(timestamp), 'symbol': market['symbol'], 'id': self.safe_string(trade, 'tradeId'), 'order': self.safe_string(trade, 'ordId'), 'type': None, 'takerOrMaker': self.parse_taker_or_maker(execType), 'side': side, 'price': self.safe_string_2(trade, 'fillPx', 'px'), 'amount': self.safe_string_2(trade, 'fillSz', 'sz'), 'cost': None, 'fee': fee, }, market) def parse_taker_or_maker(self, execType: Str): types = { 'T': 'taker', 'M': 'maker', } return self.safe_string(types, execType, execType) async def fetch_balance(self, params={}) -> Balances: """ query for balance and get the amount of funds available for trading or funds locked in orders https://www.deepcoin.com/docs/DeepCoinAccount/getAccountBalance :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.type]: "spot" or "swap", the market type for the balance :returns dict: a `balance structure ` """ await self.load_markets() marketType = 'spot' marketType, params = self.handle_market_type_and_params('fetchBalance', None, params, marketType) request: dict = { 'instType': self.convert_to_instrument_type(marketType), } response = await self.privateGetDeepcoinAccountBalances(self.extend(request, params)) return self.parse_balance(response) def parse_balance(self, response) -> Balances: # # { # "code": "0", # "msg": "", # "data": [ # { # "ccy": "USDT", # "bal": "74", # "frozenBal": "0", # "availBal": "74" # } # ] # } # result: dict = { 'info': response, 'timestamp': None, 'datetime': None, } balances = self.safe_list(response, 'data', []) for i in range(0, len(balances)): balance = balances[i] symbol = self.safe_string(balance, 'ccy') code = self.safe_currency_code(symbol) account = self.account() account['total'] = self.safe_string(balance, 'bal') account['used'] = self.safe_string(balance, 'frozenBal') account['free'] = self.safe_string(balance, 'availBal') result[code] = account return self.safe_balance(result) async def fetch_deposits(self, code: Str = None, since: Int = None, limit: Int = None, params={}) -> List[Transaction]: """ fetch all deposits made to an account https://www.deepcoin.com/docs/assets/deposit :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 :param dict [params]: extra parameters specific to the exchange API endpoint :param int [params.until]: the latest time in ms to fetch entries for :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) :returns dict[]: a list of `transaction structures ` """ await self.load_markets() paginate = False paginate, params = self.handle_option_and_params(params, 'fetchDeposits', 'paginate', False) if paginate: return await self.fetch_paginated_call_cursor('fetchDeposits', code, since, limit, params, 'code', None, 1, 50) request: dict = {} currency = None if code is not None: currency = self.currency(code) request['coin'] = currency['id'] if since is not None: request['startTime'] = since if limit is not None: request['size'] = limit until = self.safe_integer(params, 'until') if until is not None: request['endTime'] = until params = self.omit(params, 'until') response = await self.privateGetDeepcoinAssetDepositList(self.extend(request, params)) data = self.safe_dict(response, 'data', {}) items = self.safe_list(data, 'data', []) transactionParams: dict = { 'type': 'deposit', } return self.parse_transactions(items, currency, since, limit, transactionParams) async def fetch_withdrawals(self, code: Str = None, since: Int = None, limit: Int = None, params={}) -> List[Transaction]: """ fetch all withdrawals made from an account https://www.deepcoin.com/docs/assets/withdraw :param str code: unified currency code of the currency transferred :param int [since]: the earliest time in ms to fetch transfers for(default 24 hours ago) :param int [limit]: the maximum number of transfer structures to retrieve(default 50, max 200) :param dict [params]: extra parameters specific to the exchange API endpoint :param int [params.until]: the latest time in ms to fetch transfers for(default time now) :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) :returns dict[]: a list of `transaction structures ` """ await self.load_markets() paginate = False paginate, params = self.handle_option_and_params(params, 'fetchDeposits', 'paginate', False) if paginate: return await self.fetch_paginated_call_cursor('fetchDeposits', code, since, limit, params, 'code', None, 1, 50) request: dict = {} currency = None if code is not None: currency = self.currency(code) request['coin'] = currency['id'] if since is not None: request['startTime'] = since if limit is not None: request['size'] = limit until = self.safe_integer(params, 'until') if until is not None: request['endTime'] = until params = self.omit(params, 'until') response = await self.privateGetDeepcoinAssetWithdrawList(self.extend(request, params)) data = self.safe_dict(response, 'data', {}) items = self.safe_list(data, 'data', []) transactionParams: dict = { 'type': 'withdrawal', } return self.parse_transactions(items, currency, since, limit, transactionParams) def parse_transaction(self, transaction: dict, currency: Currency = None) -> Transaction: # # fetchDeposits # { # "createTime": 1760368656, # "txHash": "03fe3244d89e794586222413c61779380da9e9fe5baaa253c38d01a4199a3499", # "chainName": "TRC20", # "amount": "149", # "coin": "USDT", # "status": "succeed" # } # txid = self.safe_string(transaction, 'txHash') currencyId = self.safe_string(transaction, 'coin') code = self.safe_currency_code(currencyId, currency) amount = self.safe_number(transaction, 'amount') timestamp = self.safe_timestamp(transaction, 'createTime') networkId = self.safe_string(transaction, 'chainName') network = self.network_id_to_code(networkId) status = self.parse_transaction_status(self.safe_string(transaction, 'status')) return { 'info': transaction, 'id': None, 'currency': code, 'amount': amount, 'network': network, 'addressFrom': None, 'addressTo': None, 'address': self.safe_string(transaction, 'address'), 'tagFrom': None, 'tagTo': None, 'tag': None, 'status': status, 'type': None, 'updated': None, 'txid': txid, 'timestamp': timestamp, 'datetime': self.iso8601(timestamp), 'internal': None, 'comment': None, 'fee': { 'currency': None, 'cost': None, }, } def parse_transaction_status(self, status: Str) -> Str: statuses: dict = { 'confirming': 'pending', 'succeed': 'ok', } return self.safe_string(statuses, status, status) async def fetch_deposit_addresses(self, codes: Strings = None, params={}) -> List[DepositAddress]: """ fetch deposit addresses for multiple currencies and chain types https://www.deepcoin.com/docs/assets/chainlist :param str[]|None codes: list of unified currency codes, default is None :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a list of `address structures ` """ await self.load_markets() if codes is None: raise ArgumentsRequired(self.id + ' fetchDepositAddresses requires a list with one currency code') length = len(codes) if length != 1: raise NotSupported(self.id + ' fetchDepositAddresses requires a list with one currency code') code = codes[0] currency = self.currency(code) request: dict = { 'currency_id': currency['id'], 'lang': 'en', } response = await self.privateGetDeepcoinAssetRechargeChainList(self.extend(request, params)) # # { # "code": "0", # "msg": "", # "data": { # "list": [ # { # "chain": "TRC20", # "state": 1, # "remind": "Only support deposits and withdrawals via TRC20 network. If you send it via other address by mistake, it will not be credited and will result in the permanent loss of your deposit.", # "inNotice": "", # "actLogo": "", # "address": "TNJYDW9Bk87VwfA6s7FtxURLEMHesQbYgF", # "hasMemo": False, # "memo": "", # "estimatedTime": 1, # "fastConfig": { # "fastLimitNum": 0, # "fastBlock": 10, # "realBlock": 1 # } # } # ] # } # } # data = self.safe_dict(response, 'data', {}) list = self.safe_list(data, 'list', []) additionalParams: dict = { 'currency': code, } return self.parse_deposit_addresses(list, codes, False, additionalParams) async def fetch_deposit_address(self, code: str, params={}) -> DepositAddress: """ fetch the deposit address for a currency associated with self account https://www.deepcoin.com/docs/assets/chainlist :param str code: unified currency code :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.network]: unified network code for deposit chain :returns dict: an `address structure ` """ await self.load_markets() network = self.safe_string(params, 'network') defaultNetworks = self.safe_dict(self.options, 'defaultNetworks', {}) defaultNetwork = self.safe_string(defaultNetworks, code) network = network if network else defaultNetwork if network is not None: params = self.omit(params, 'network') addressess = await self.fetch_deposit_addresses([code], params) length = len(addressess) address = self.safe_dict(addressess, 0, {}) if (network is not None) and (length > 1): for i in range(0, length): entry = addressess[i] if entry['network'] == network: address = entry return address def parse_deposit_address(self, response, currency: Currency = None) -> DepositAddress: # # { # "chain": "TRC20", # "state": 1, # "remind": "Only support deposits and withdrawals via TRC20 network. If you send it via other address by mistake, it will not be credited and will result in the permanent loss of your deposit.", # "inNotice": "", # "actLogo": "", # "address": "TNJYDW9Bk87VwfA6s7FtxURLEMHesQbYgF", # "hasMemo": False, # "memo": "", # "estimatedTime": 1, # "fastConfig": { # "fastLimitNum": 0, # "fastBlock": 10, # "realBlock": 1 # } # } # chain = self.safe_string(response, 'chain') address = self.safe_string(response, 'address') self.check_address(address) return { 'info': response, 'currency': None, 'network': self.network_id_to_code(chain), 'address': address, 'tag': self.safe_string(response, 'memo'), } 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 https://www.deepcoin.com/docs/DeepCoinAccount/getAccountBills :param str [code]: unified currency code :param int [since]: timestamp in ms of the earliest ledger entry :param int [limit]: max number of ledger entries to return :param dict [params]: extra parameters specific to the exchange API endpoint :param int [params.until]: timestamp in ms of the latest ledger entry :param str [params.type]: 'spot' or 'swap', the market type for the ledger(default 'spot') :returns dict[]: a list of `ledger structures ` """ await self.load_markets() marketType = 'spot' marketType, params = self.handle_market_type_and_params('fetchLedger', None, params, marketType) request: dict = { 'instType': self.convert_to_instrument_type(marketType), } currency = None if code is not None: currency = self.currency(code) request['ccy'] = currency['id'] if since is not None: request['after'] = since if limit is not None: request['limit'] = limit until = self.safe_integer(params, 'until') if until is not None: request['before'] = until params = self.omit(params, 'until') response = await self.privateGetDeepcoinAccountBills(self.extend(request, params)) # # { # "code": "0", # "msg": "", # "data": [ # { # "billId": "1001044652247714", # "ccy": "USDT", # "clientId": "", # "balChg": "-0.03543537", # "bal": "72.41881427", # "type": "5", # "ts": "1761047448000" # }, # { # "billId": "1001044652258368", # "ccy": "DOGE", # "clientId": "", # "balChg": "76", # "bal": "76", # "type": "2", # "ts": "1761051006000" # } # ] # } # data = self.safe_list(response, 'data', []) return self.parse_ledger(data, currency, since, limit) def parse_ledger_entry(self, item: dict, currency: Currency = None) -> LedgerEntry: # # { # "billId": "1001044652247714", # "ccy": "USDT", # "clientId": "", # "balChg": "-0.03543537", # "bal": "72.41881427", # "type": "5", # "ts": "1761047448000" # } # timestamp = self.safe_integer(item, 'ts') change = self.safe_string(item, 'balChg') amount = Precise.string_abs(change) direction = 'out' if Precise.string_lt(change, '0') else 'in' currencyId = self.safe_string(item, 'ccy') currency = self.safe_currency(currencyId, currency) type = self.safe_string(item, 'type') return self.safe_ledger_entry({ 'info': item, 'id': self.safe_string(item, 'billId'), 'direction': direction, 'account': None, 'referenceAccount': None, 'referenceId': None, 'type': self.parse_ledger_entry_type(type), 'currency': currency['code'], 'amount': amount, 'timestamp': timestamp, 'datetime': self.iso8601(timestamp), 'before': None, 'after': self.safe_string(item, 'bal'), 'status': None, 'fee': None, }, currency) def parse_ledger_entry_type(self, type): ledgerType: dict = { '1': 'trade', '2': 'trade', '3': 'transfer', '4': 'transfer', '5': 'fee', } return self.safe_string(ledgerType, type, type) async def transfer(self, code: str, amount: float, fromAccount: str, toAccount: str, params={}) -> TransferEntry: """ transfer currency internally between wallets on the same account https://www.deepcoin.com/docs/assets/transfer :param str code: unified currency code :param float amount: amount to transfer :param str fromAccount: account to transfer from('spot', 'inverse', 'linear', 'fund', 'rebate' or 'demo') :param str toAccount: account to transfer to('spot', 'inverse', 'linear', 'fund', 'rebate' or 'demo') :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.userId]: user id :returns dict: a `transfer structure ` """ userId = None userId, params = self.handle_option_and_params(params, 'transfer', 'userId') userId = userId if userId else self.safe_string(params, 'uid') if userId is None: raise ArgumentsRequired(self.id + ' transfer() requires a userId parameter') await self.load_markets() currency = self.currency(code) accountsByType = self.safe_dict(self.options, 'accountsByType', {}) fromId = self.safe_string(accountsByType, fromAccount, fromAccount) toId = self.safe_string(accountsByType, toAccount, toAccount) request: dict = { 'currency_id': currency['id'], 'amount': self.currency_to_precision(code, amount), 'from_id': fromId, 'to_id': toId, 'uid': userId, } response = await self.privatePostDeepcoinAssetTransfer(self.extend(request, params)) # # { # "code": "0", # "msg": "", # "data": { # "retCode": 0, # "retMsg": "", # "retData": {} # } # } # data = self.safe_dict(response, 'data', {}) transfer = self.parse_transfer(data, currency) transferOptions = self.safe_dict(self.options, 'transfer', {}) fillResponseFromRequest = self.safe_bool(transferOptions, 'fillResponseFromRequest', True) if fillResponseFromRequest: transfer['fromAccount'] = fromAccount transfer['toAccount'] = toAccount transfer['amount'] = amount return transfer def parse_transfer(self, transfer: dict, currency: Currency = None) -> TransferEntry: # # { # "retCode": 0, # "retMsg": "", # "retData": {} # } # status = self.safe_string(transfer, 'retCode') currencyCode = self.safe_currency_code(None, currency) return { 'info': transfer, 'id': None, 'timestamp': None, 'datetime': None, 'currency': currencyCode, 'amount': None, 'fromAccount': None, 'toAccount': None, 'status': self.parse_transfer_status(status), } def parse_transfer_status(self, status: Str) -> Str: if status == '0': return 'ok' return 'failed' async def create_order(self, symbol: str, type: OrderType, side: OrderSide, amount: float, price: Num = None, params={}): """ create a trade order https://www.deepcoin.com/docs/DeepCoinTrade/order https://www.deepcoin.com/docs/DeepCoinTrade/triggerOrder :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' :param float amount: how much of currency you want to trade in units of base currency :param float [price]: the price at which the order is to be fulfilled, in units of the quote currency, ignored in market orders :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.clientOrderId]: a unique id for the order :param str [params.timeInForce]: *non trigger orders only* 'GTC'(Good Till Cancel), 'IOC'(Immediate Or Cancel) or 'PO'(Post Only) :param bool [params.postOnly]: *non trigger orders only* True to place a post only order :param bool [params.reduceOnly]: *non trigger orders only* a mark to reduce the position size for margin, swap and future orders :param float [params.triggerPrice]: the price a trigger order is triggered at :param float [params.stopLoss.triggerPrice]: the price that a stop loss order is triggered at :param float [params.takeProfit.triggerPrice]: the price that a take profit order is triggered at :param str [params.positionSide]: if position mode is one-way: set to 'net', if position mode is hedge-mode: set to 'long' or 'short' :param bool [params.hedged]: *swap only* True for hedged mode, False for one way mode :param str [params.marginMode]: *swap only*'cross' or 'isolated', the default is 'cash' for spot and 'cross' for swap :returns dict: an `order structure ` """ await self.load_markets() market = self.market(symbol) triggerPrice = self.safe_string(params, 'triggerPrice') request = self.create_order_request(symbol, type, side, amount, price, params) response = None if triggerPrice is not None: # trigger orders response = await self.privatePostDeepcoinTradeTriggerOrder(request) else: # regular orders # # { # "code": "0", # "msg": "", # "data": { # "ordId": "1001434570213727", # "clOrdId": "", # "tag": "", # "sCode": "0", # "sMsg": "" # } # } # response = await self.privatePostDeepcoinTradeOrder(request) data = self.safe_dict(response, 'data', {}) return self.parse_order(data, market) def create_order_request(self, symbol: str, type: OrderType, side: OrderSide, amount: float, price: Num = None, params={}): """ @ignore helper function to build request """ market = self.market(symbol) triggerPrice = self.safe_string(params, 'triggerPrice') # isTriggerOrder = (triggerPrice is not None) or self.safe_string_2(params, 'stopLossPrice', 'takeProfitPrice') is not None isTriggerOrder = (triggerPrice is not None) cost = self.safe_string(params, 'cost') if cost is not None: if not market['spot'] or (triggerPrice is not None): raise BadRequest(self.id + ' createOrder() accepts a cost parameter for spot non-trigger market orders only') if isTriggerOrder: return self.create_trigger_order_request(symbol, type, side, amount, price, params) else: return self.create_regular_order_request(symbol, type, side, amount, price, params) def create_regular_order_request(self, symbol: str, type: OrderType, side: OrderSide, amount: float, price: Num = None, params={}): """ @ignore helper function to build request :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' :param float amount: how much you want to trade in units of the base currency :param float [price]: the price at which the order is to be fulfilled, in units of the quote currency, ignored in market orders :param dict [params]: extra parameters specific to the exchange API endpoint :param float [params.cost]: *spot only* the cost of the order in units of the quote currency, for market orders only :param str [params.clientOrderId]: a unique id for the order :param str [params.timeInForce]: 'GTC'(Good Till Cancel), 'IOC'(Immediate Or Cancel) or 'PO'(Post Only) :param bool [params.postOnly]: True to place a post only order :param bool [params.reduceOnly]: a mark to reduce the position size for margin and swap orders :param float [params.stopLossPrice]: the price that a stop loss order is triggered at :param float [params.takeProfitPrice]: the price that a take profit order is triggered at :param str [params.marginMode]: *swap only* 'cross' or 'isolated', the default is 'cash' for spot and 'cross' for swap :param str [params.mrgPosition]: *swap only* 'merge' or 'split', the default is 'merge' """ market = self.market(symbol) orderType = type orderType, params = self.handle_type_post_only_and_time_in_force(type, params) request: dict = { 'instId': market['id'], # 'tdMode': 'cash', # 'cash' for spot, 'cross' or 'isolated' for swap # 'ccy': currency['id'], # only applicable to cross MARGIN orders in single-currency margin # 'clOrdId': clientOrderId, 'side': side, 'ordType': orderType, # 'sz': amount or cost # 'px': price, # limit orders only # 'reduceOnly': False, # a mark to reduce the position size for margin and swap orders # 'tgtCcy': 'base_ccy', # spot only 'base_ccy' or 'quote_ccy', the default is 'base_ccy' for spot orders # 'tpTriggerPx': takeProfitPrice, # take profit trigger price # 'slTriggerPx': stopLossPrice, # stop loss trigger price # 'posSide': 'long', # swap only 'long' or 'short' # 'mrgPosition': 'merge', # swap only 'merge' or 'split' # 'closePosId': 'id', # swap only position ID to close, required in split mode } clientOrderId = self.safe_string(params, 'clientOrderId') if clientOrderId is not None: request['clOrdId'] = clientOrderId params = self.omit(params, 'clientOrderId') stopLoss = self.safe_dict(params, 'stopLoss', {}) stopLossPrice = self.safe_string(stopLoss, 'triggerPrice') if stopLossPrice is not None: params = self.omit(params, ['stopLoss']) request['slTriggerPx'] = self.price_to_precision(symbol, stopLossPrice) takeProfit = self.safe_dict(params, 'takeProfit', {}) takeProfitPrice = self.safe_string(takeProfit, 'triggerPrice') if takeProfitPrice is not None: params = self.omit(params, ['takeProfit']) request['tpTriggerPx'] = self.price_to_precision(symbol, takeProfitPrice) isMarketOrder = (type == 'market') if price is not None: if isMarketOrder: raise BadRequest(self.id + ' createOrder() does not require a price argument for market orders') request['px'] = self.price_to_precision(symbol, price) elif not isMarketOrder: raise BadRequest(self.id + ' createOrder() requires a price argument for limit orders') if market['spot']: cost = self.safe_string(params, 'cost') if cost is not None: if not isMarketOrder: raise BadRequest(self.id + ' createOrder() accepts a cost parameter for spot market orders only') params = self.omit(params, 'cost') request['sz'] = self.cost_to_precision(symbol, cost) request['tgtCcy'] = 'quote_ccy' else: request['sz'] = self.amount_to_precision(symbol, amount) request['tgtCcy'] = 'base_ccy' request['side'] = side request['tdMode'] = 'cash' else: request['sz'] = self.amount_to_precision(symbol, amount) marginMode = 'cross' marginMode, params = self.handle_margin_mode_and_params('createOrder', params, marginMode) request['tdMode'] = marginMode mrgPosition = 'merge' mrgPosition, params = self.handle_option_and_params(params, 'createOrder', 'mrgPosition', mrgPosition) request['mrgPosition'] = mrgPosition posSide: Str = None reduceOnly = self.safe_bool(params, 'reduceOnly', False) if reduceOnly: if side == 'buy': posSide = 'short' elif side == 'sell': posSide = 'long' else: if side == 'buy': posSide = 'long' elif side == 'sell': posSide = 'short' request['posSide'] = posSide return self.extend(request, params) def create_trigger_order_request(self, symbol: str, type: OrderType, side: OrderSide, amount: float, price: Num = None, params={}): """ @ignore helper function to build request :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' :param float amount: how much you want to trade in units of the base currency :param float [price]: the price at which the order is to be fulfilled, in units of the quote currency, ignored in market orders :param dict [params]: extra parameters specific to the exchange API endpoint :param bool [params.reduceOnly]: a mark to reduce the position size for margin orders :param str [params.marginMode]: *swap only* 'cross' or 'isolated', the default is 'cash' for spot and 'cross' for swap """ market = self.market(symbol) request: dict = { 'instId': market['id'], 'productGroup': self.capitalize(market['type']), 'sz': self.amount_to_precision(symbol, amount), 'side': side, # 'posSide': 'long', # 'long' or 'short' - required when product type is SWAP # 'price': price, # 'isCrossMargin': 1, # 1 for cross margin, 0 for isolated margin 'orderType': type, # 'triggerPrice': triggerPrice, # 'mrgPosition': 'merge', # 'merge' or 'split', the default is 'merge' - required when product type is SWAP # 'tdMode': 'cash', # 'cash' for spot, 'cross' or 'isolated' for swap } triggerPrice = self.safe_string(params, 'triggerPrice') # takeProfitPrice = self.safe_string(params, 'takeProfitPrice') # stopLossPrice = self.safe_string(params, 'stopLossPrice') # isTpOrSlOrder = (takeProfitPrice is not None) or (stopLossPrice is not None) # if isTpOrSlOrder: # if takeProfitPrice is not None: # request['triggerPrice'] = self.price_to_precision(symbol, takeProfitPrice) # else: # request['triggerPrice'] = self.price_to_precision(symbol, stopLossPrice) # } # else: request['triggerPrice'] = self.price_to_precision(symbol, triggerPrice) # } if price is not None: request['price'] = self.price_to_precision(symbol, price) elif type == 'limit': raise ArgumentsRequired(self.id + ' createOrder() requires a price argument for limit trigger orders') marginMode = 'cross' marginMode, params = self.handle_margin_mode_and_params('createOrder', params, marginMode) isCrossMargin = 1 if marginMode == 'isolated': isCrossMargin = 0 reduceOnly = self.safe_bool(params, 'reduceOnly', False) params = self.omit(params, 'reduceOnly') request['isCrossMargin'] = isCrossMargin request['tdMode'] = marginMode if market['swap']: if reduceOnly: if side == 'buy': request['posSide'] = 'short' elif side == 'sell': request['posSide'] = 'long' else: if side == 'buy': request['posSide'] = 'long' elif side == 'sell': request['posSide'] = 'short' mrgPosition = 'merge' mrgPosition, params = self.handle_option_and_params(params, 'createOrder', 'mrgPosition', mrgPosition) request['mrgPosition'] = mrgPosition return self.extend(request, params) def handle_type_post_only_and_time_in_force(self, type: OrderType, params): postOnly = False postOnly, params = self.handle_post_only(type == 'market', type == 'post_only', params) if postOnly: type = 'post_only' timeInForce = self.handle_time_in_force(params) params = self.omit(params, 'timeInForce') if (timeInForce is not None) and (timeInForce == 'IOC'): type = 'ioc' return [type, params] async def create_market_order_with_cost(self, symbol: str, side: OrderSide, cost: float, params={}): """ create a market order by providing the symbol, side and cost :param str symbol: unified symbol of the market to create an order in :param str side: 'buy' or 'sell' :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 :returns dict: an `order structure ` """ params = self.extend(params, {'cost': cost}) return await self.create_order(symbol, 'market', side, 0, None, params) async def create_market_buy_order_with_cost(self, symbol: str, cost: float, params={}) -> Order: """ create a market buy order by providing the symbol and cost :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 :returns dict: an `order structure ` """ params = self.extend(params, {'cost': cost}) return await self.create_order(symbol, 'market', 'buy', 0, None, params) async def create_market_sell_order_with_cost(self, symbol: str, cost: float, params={}) -> Order: """ create a market sell order by providing the symbol and cost :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 :returns dict: an `order structure ` """ params = self.extend(params, {'cost': cost}) return await self.create_order(symbol, 'market', 'sell', 0, None, params) async def fetch_closed_order(self, id: str, symbol: Str = None, params={}) -> Order: """ fetches information on a closed order made by the user https://www.deepcoin.com/docs/DeepCoinTrade/finishOrderByID :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 :returns dict: an `order structure ` """ await self.load_markets() if symbol is None: raise ArgumentsRequired(self.id + ' fetchClosedOrder() requires a symbol argument') market = self.market(symbol) request: dict = { 'instId': market['id'], 'ordId': id, } response = await self.privateGetDeepcoinTradeFinishOrderByID(self.extend(request, params)) # # { # "code": "0", # "msg": "", # "data": [ # { # "instType": "SPOT", # "instId": "ETH-USDT", # "tgtCcy": "", # "ccy": "", # "ordId": "1001434573319675", # "clOrdId": "", # "tag": "", # "px": "4056.620000000000", # "sz": "0.004000", # "pnl": "0.000000", # "ordType": "market", # "side": "buy", # "posSide": "", # "tdMode": "cash", # "accFillSz": "0.004000", # "fillPx": "", # "tradeId": "", # "fillSz": "0.004000", # "fillTime": "1760619119000", # "avgPx": "", # "state": "filled", # "lever": "1.000000", # "tpTriggerPx": "", # "tpTriggerPxType": "", # "tpOrdPx": "", # "slTriggerPx": "", # "slTriggerPxType": "", # "slOrdPx": "", # "feeCcy": "USDT", # "fee": "0.000004", # "rebateCcy": "", # "source": "", # "rebate": "", # "category": "normal", # "uTime": "1760619119000", # "cTime": "1760619119000" # } # ] # } # data = self.safe_list(response, 'data', []) entry = self.safe_dict(data, 0, {}) return self.parse_order(entry, market) async def fetch_open_order(self, id: str, symbol: Str = None, params={}) -> Order: """ fetch an open order by it's id https://www.deepcoin.com/docs/DeepCoinTrade/orderByID :param str id: order id :param str symbol: unified market symbol, default is None :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: an `order structure ` """ await self.load_markets() if symbol is None: raise ArgumentsRequired(self.id + ' fetchClosedOrder() requires a symbol argument') market = self.market(symbol) request: dict = { 'instId': market['id'], 'ordId': id, } response = await self.privateGetDeepcoinTradeOrderByID(self.extend(request, params)) data = self.safe_list(response, 'data', []) length = len(data) if length == 0: return None entry = self.safe_dict(data, 0, {}) return self.parse_order(entry, market) async def fetch_canceled_and_closed_orders(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}) -> List[Order]: """ https://www.deepcoin.com/docs/DeepCoinTrade/ordersHistory https://www.deepcoin.com/docs/DeepCoinTrade/triggerOrdersHistory fetches information on multiple canceled and closed orders made by the user :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 :param dict [params]: extra parameters specific to the exchange API endpoint :param bool [params.trigger]: whether to fetch trigger/algo orders(default False) :param str [params.type]: *non trigger orders only* 'spot' or 'swap', the market type for the orders :param str [params.state]: *non trigger orders only* 'canceled' or 'filled', the order state to filter by :param str [params.OrderType]: *trigger orders only* 'limit' or 'market' :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) :returns Order[]: a list of `order structures ` """ await self.load_markets() paginate = False paginate, params = self.handle_option_and_params(params, 'fetchCanceledAndClosedOrders', 'paginate') if paginate: return await self.fetch_paginated_call_dynamic('fetchCanceledAndClosedOrders', symbol, since, limit, params) trigger = self.safe_bool(params, 'trigger', False) methodName = 'fetchCanceledAndClosedOrders' methodName, params = self.handle_param_string(params, 'methodName', methodName) market: Market = None request: dict = {} if symbol is not None: market = self.market(symbol) request['instId'] = market['id'] marketType = 'spot' marketType, params = self.handle_market_type_and_params(methodName, market, params, marketType) request['instType'] = self.convert_to_instrument_type(marketType) if limit is not None: request['limit'] = limit # default 100 response = None if trigger: if methodName != 'fetchCanceledAndClosedOrders': raise BadRequest(self.id + ' ' + methodName + '() does not support trigger orders') if market is None: raise ArgumentsRequired(self.id + ' fetchCanceledAndClosedOrders() requires a symbol argument for trigger orders') params = self.omit(params, 'trigger') # # { # "code": "0", # "msg": "", # "data": [ # { # "instType": "SWAP", # "instId": "DOGE-USDT-SWAP", # "ordId": "1001110510915416", # "px": "0", # "sz": "76", # "triggerPx": "0", # "triggerPxType": "last", # "ordType": "TPSL", # "side": "sell", # "posSide": "long", # "tdMode": "cross", # "lever": "2", # "triggerTime": "0", # "uTime": "1761059366000", # "cTime": "1761059218", # "errorCode": "0", # "errorMsg": "" # } # ] # } # response = await self.privateGetDeepcoinTradeTriggerOrdersHistory(self.extend(request, params)) else: # # { # "code": "0", # "msg": "", # "data": [ # { # "instType": "SPOT", # "instId": "ETH-USDT", # "tgtCcy": "", # "ccy": "", # "ordId": "1001434573319675", # "clOrdId": "", # "tag": "", # "px": "4056.620000000000", # "sz": "0.004000", # "pnl": "0.000000", # "ordType": "market", # "side": "buy", # "posSide": "", # "tdMode": "cash", # "accFillSz": "0.004000", # "fillPx": "", # "tradeId": "", # "fillSz": "0.004000", # "fillTime": "1760619119000", # "avgPx": "", # "state": "filled", # "lever": "1.000000", # "tpTriggerPx": "", # "tpTriggerPxType": "", # "tpOrdPx": "", # "slTriggerPx": "", # "slTriggerPxType": "", # "slOrdPx": "", # "feeCcy": "USDT", # "fee": "0.000004", # "rebateCcy": "", # "source": "", # "rebate": "", # "category": "normal", # "uTime": "1760619119000", # "cTime": "1760619119000" # } # ] # } # response = await self.privateGetDeepcoinTradeOrdersHistory(self.extend(request, params)) # todo handle with since, until and pagination data = self.safe_list(response, 'data', []) return self.parse_orders(data, market, since, limit) async def fetch_canceled_orders(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}) -> List[Order]: """ fetches information on multiple canceled orders made by the user https://www.deepcoin.com/docs/DeepCoinTrade/ordersHistory :param str symbol: unified market symbol of the market the 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 :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.type]: 'spot' or 'swap', the market type for the orders :returns dict[]: a list of `order structures ` """ methodName = 'fetchCanceledOrders' params = self.extend(params, {'methodName': methodName}) params = self.extend(params, {'state': 'canceled'}) return await self.fetch_canceled_and_closed_orders(symbol, since, limit, params) 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 https://www.deepcoin.com/docs/DeepCoinTrade/ordersHistory :param str symbol: unified market symbol of the market the 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 :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.type]: 'spot' or 'swap', the market type for the orders :returns dict[]: a list of `order structures ` """ methodName = 'fetchClosedOrders' params = self.extend(params, {'methodName': methodName}) params = self.extend(params, {'state': 'filled'}) return await self.fetch_canceled_and_closed_orders(symbol, since, limit, params) async def fetch_open_orders(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}) -> List[Order]: """ fetch all unfilled currently open orders https://www.deepcoin.com/docs/DeepCoinTrade/ordersPendingV2 https://www.deepcoin.com/docs/DeepCoinTrade/triggerOrdersPending :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 :param dict [params]: extra parameters specific to the exchange API endpoint :param bool [params.trigger]: whether to fetch trigger/algo orders(default False) :param int [params.index]: *non trigger orders only* pagination index, default is 1 :param str [params.orderType]: *trigger orders only* 'limit' or 'market' :returns Order[]: a list of `order structures ` """ await self.load_markets() if symbol is None: raise ArgumentsRequired(self.id + ' fetchOpenOrders() requires a symbol argument') market = self.market(symbol) index = self.safe_integer(params, 'index', 1) # todo add pagination handling request: dict = { 'instId': market['id'], } if limit is not None: request['limit'] = limit trigger = self.safe_bool(params, 'trigger', False) response = None if trigger: params = self.omit(params, 'trigger') request['instType'] = self.convert_to_instrument_type(market['type']) # # { # "code": "0", # "msg": "", # "data": [ # { # "instType": "SPOT", # "instId": "DOGE-USDT", # "ordId": "1001442305797142", # "triggerPx": "0.01", # "ordPx": "0.01", # "sz": "20", # "ordType": "", # "side": "buy", # "posSide": "", # "tdMode": "cash", # "triggerOrderType": "Conditional", # "triggerPxType": "last", # "lever": "", # "slPrice": "", # "slTriggerPrice": "", # "tpPrice": "", # "tpTriggerPrice": "", # "closeSLTriggerPrice": "", # "closeTPTriggerPrice": "", # "cTime": "1761814167000", # "uTime": "1761814167000" # } # ] # } # response = await self.privateGetDeepcoinTradeTriggerOrdersPending(self.extend(request, params)) else: request['index'] = index # # { # "code": "0", # "msg": "", # "data": [ # { # "instType": "SPOT", # "instId": "ETH-USDT", # "tgtCcy": "", # "ccy": "", # "ordId": "1001435158096314", # "clOrdId": "", # "tag": "", # "px": "1000.000000000000", # "sz": "0.004000", # "pnl": "0.000000", # "ordType": "limit", # "side": "buy", # "posSide": "", # "tdMode": "cash", # "accFillSz": "0.000000", # "fillPx": "", # "tradeId": "", # "fillSz": "0.000000", # "fillTime": "1760695267000", # "avgPx": "", # "state": "live", # "lever": "1", # "tpTriggerPx": "", # "tpTriggerPxType": "", # "tpOrdPx": "", # "slTriggerPx": "", # "slTriggerPxType": "", # "slOrdPx": "", # "feeCcy": "USDT", # "fee": "0.000000", # "rebateCcy": "", # "source": "", # "rebate": "", # "category": "normal", # "uTime": "1760695267000", # "cTime": "1760695267000" # } # ] # } # response = await self.privateGetDeepcoinTradeV2OrdersPending(self.extend(request, params)) data = self.safe_list(response, 'data', []) return self.parse_orders(data, market, since, limit, {'status': 'open'}) async def cancel_order(self, id: str, symbol: Str = None, params={}) -> Order: """ cancels an open order https://www.deepcoin.com/docs/DeepCoinTrade/cancelOrder :param str id: order id :param str symbol: unified symbol of the market the order was made in :param dict [params]: extra parameters specific to the exchange API endpoint :param bool [params.trigger]: whether the order is a trigger/algo order(default False) :returns dict: An `order structure ` """ await self.load_markets() if symbol is None: raise ArgumentsRequired(self.id + ' cancelOrder() requires a symbol argument') market = self.market(symbol) request: dict = { 'instId': market['id'], 'ordId': id, } response = None trigger = self.safe_bool(params, 'trigger', False) if trigger: params = self.omit(params, 'trigger') response = await self.privatePostDeepcoinTradeCancelTriggerOrder(self.extend(request, params)) else: response = await self.privatePostDeepcoinTradeCancelOrder(self.extend(request, params)) data = self.safe_dict(response, 'data', {}) return self.parse_order(data, market) async def cancel_all_orders(self, symbol: Str = None, params={}) -> List[Order]: """ cancel all open orders in a market https://www.deepcoin.com/docs/DeepCoinTrade/cancelAllOrder :param str symbol: unified market symbol of the market to cancel orders in :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.marginMode]: *swap only* 'cross' or 'isolated', the default is 'cash' for spot and 'cross' for swap :param bool [params.merged]: *swap only* True for merged positions, False for split positions(default True) :returns dict[]: a list of `order structures ` """ await self.load_markets() if symbol is None: raise ArgumentsRequired(self.id + ' cancelAllOrders() requires a symbol argument') market = self.market(symbol) if market['spot']: raise NotSupported(self.id + ' cancelAllOrders() is not supported for spot markets') productGroup = self.get_product_group_from_market(market) marginMode = self.safe_string(params, 'marginMode') encodedMarginMode = 1 if marginMode is not None: params = self.omit(params, 'marginMode') if marginMode == 'isolated': encodedMarginMode = 0 merged = True merged, params = self.handle_option_and_params(params, 'cancelAllOrders', 'merged', merged) request: dict = { 'InstrumentID': market['id'], 'ProductGroup': productGroup, 'IsCrossMargin': encodedMarginMode, 'IsMergeMode': 1 if merged else 0, } response = await self.privatePostDeepcoinTradeSwapCancelAll(self.extend(request, params)) data = self.safe_list(response, 'data', []) return self.parse_orders(data, market) async def edit_order(self, id: str, symbol: str, type: OrderType, side: OrderSide, amount: Num = None, price: Num = None, params={}): """ edit a trade order https://www.deepcoin.com/docs/DeepCoinTrade/replaceOrder https://www.deepcoin.com/docs/DeepCoinTrade/replaceTPSL :param str id: cancel order id :param str [symbol]: unified symbol of the market to create an order in(not used in deepcoin editOrder) :param str [type]: 'market' or 'limit'(not used in deepcoin editOrder) :param str [side]: 'buy' or 'sell'(not used in deepcoin editOrder) :param float [amount]: how much of currency you want to trade in units of base currency :param float [price]: the price at which the order is to be fulfilled, in units of the quote currency, ignored in market orders :param dict [params]: extra parameters specific to the exchange API endpoint :param float [params.stopLossPrice]: the price that a stop loss order is triggered at :param float [params.takeProfitPrice]: the price that a take profit order is triggered at :returns dict: an `order structure ` """ await self.load_markets() request: dict = { 'OrderSysID': id, } market: Market = None if symbol is not None: market = self.market(symbol) if market['spot']: raise NotSupported(self.id + ' editOrder() is not supported for spot markets') symbol = market['symbol'] stopLossPrice = self.safe_number(params, 'stopLossPrice') takeProfitPrice = self.safe_number(params, 'takeProfitPrice') isTPSL = (stopLossPrice is not None) or (takeProfitPrice is not None) response = None if isTPSL: if (price is not None) or (amount is not None): raise BadRequest(self.id + ' editOrder() with stopLossPrice or takeProfitPrice cannot have price or amount. Either use stopLossPrice/takeProfitPrice or price/amount to edit order.') if stopLossPrice is not None: request['slTriggerPx'] = self.price_to_precision(symbol, stopLossPrice) if symbol else self.number_to_string(stopLossPrice) if takeProfitPrice is not None: request['tpTriggerPx'] = self.price_to_precision(symbol, takeProfitPrice) if symbol else self.number_to_string(takeProfitPrice) params = self.omit(params, ['stopLossPrice', 'takeProfitPrice']) response = await self.privatePostDeepcoinTradeReplaceOrderSltp(self.extend(request, params)) else: if price is not None: if symbol is not None: request['price'] = self.price_to_precision(symbol, price) else: request['price'] = self.number_to_string(price) if amount is not None: if symbol is not None: request['volume'] = self.amount_to_precision(symbol, amount) else: request['volume'] = self.number_to_string(amount) response = await self.privatePostDeepcoinTradeReplaceOrder(self.extend(request, params)) data = self.safe_dict(response, 'data', {}) return self.parse_order(data) async def cancel_orders(self, ids: List[str], symbol: Str = None, params={}) -> List[Order]: """ cancel multiple orders :param str[] ids: order ids :param str [symbol]: unified market symbol, default is None :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: an list of `order structures ` """ await self.load_markets() market: Market = None if symbol is not None: market = self.market(symbol) if market['spot']: raise NotSupported(self.id + ' cancelOrders() is not supported for spot markets') request: dict = { 'OrderSysIDs': ids, } response = await self.privatePostDeepcoinTradeBatchCancelOrder(self.extend(request, params)) data = self.safe_list(response, 'data', []) return self.parse_orders(data, market) def parse_order(self, order: dict, market: Market = None) -> Order: # # regular order # { # "instType": "SPOT", # "instId": "ETH-USDT", # "tgtCcy": "", # "ccy": "", # "ordId": "1001434573319675", # "clOrdId": "", # "tag": "", # "px": "4056.620000000000", # "sz": "0.004000", # "pnl": "0.000000", # "ordType": "market", # "side": "buy", # "posSide": "", # "tdMode": "cash", # "accFillSz": "0.004000", # "fillPx": "", # "tradeId": "", # "fillSz": "0.004000", # "fillTime": "1760619119000", # "avgPx": "", # "state": "filled", # "lever": "1.000000", # "tpTriggerPx": "", # "tpTriggerPxType": "", # "tpOrdPx": "", # "slTriggerPx": "", # "slTriggerPxType": "", # "slOrdPx": "", # "feeCcy": "USDT", # "fee": "0.000004", # "rebateCcy": "", # "source": "", # "rebate": "", # "category": "normal", # "uTime": "1760619119000", # "cTime": "1760619119000" # } # # trigger order # { # "instType": "SPOT", # "instId": "DOGE-USDT", # "ordId": "1001442305797142", # "triggerPx": "0.01", # "ordPx": "0.01", # "sz": "20", # "ordType": "", # "side": "buy", # "posSide": "", # "tdMode": "cash", # "triggerOrderType": "Conditional", # "triggerPxType": "last", # "lever": "", # "slPrice": "", # "slTriggerPrice": "", # "tpPrice": "", # "tpTriggerPrice": "", # "closeSLTriggerPrice": "", # "closeTPTriggerPrice": "", # "cTime": "1761814167000", # "uTime": "1761814167000" # } # marketId = self.safe_string(order, 'instId') market = self.safe_market(marketId, market) timestamp = self.safe_integer(order, 'cTime') timestampString = self.safe_string(order, 'cTime', '') if len(timestampString) < 13: timestamp = self.safe_timestamp(order, 'cTime') state = self.safe_string(order, 'state') orderType = self.safe_string(order, 'ordType') average = self.safe_string(order, 'avgPx') if average == '': average = None feeCurrencyId = self.safe_string(order, 'feeCcy') fee = None if feeCurrencyId is not None: feeCost = self.safe_string(order, 'fee') fee = { 'cost': self.parse_number(feeCost), 'currency': self.safe_currency_code(feeCurrencyId), } return self.safe_order({ 'id': self.safe_string(order, 'ordId'), 'clientOrderId': self.safe_string(order, 'clOrdId'), 'datetime': self.iso8601(timestamp), 'timestamp': timestamp, 'lastTradeTimestamp': None, 'lastUpdateTimestamp': self.safe_integer(order, 'uTime'), 'status': self.parse_order_status(state), 'symbol': market['symbol'], 'type': self.parse_order_type(orderType), 'timeInForce': self.parse_order_time_in_force(orderType), 'side': self.safe_string(order, 'side'), 'price': self.safe_string_2(order, 'px', 'ordPx'), 'average': average, 'amount': self.safe_string(order, 'sz'), 'filled': self.safe_string(order, 'accFillSz'), 'remaining': None, 'triggerPrice': self.omit_zero(self.safe_string(order, 'triggerPx')), 'takeProfitPrice': self.safe_string_2(order, 'tpTriggerPx', 'tpTriggerPrice'), 'stopLossPrice': self.safe_string_2(order, 'slTriggerPx', 'slTriggerPrice'), 'cost': None, 'trades': None, 'fee': fee, 'reduceOnly': None, 'postOnly': (orderType == 'post_only') if orderType else None, 'info': order, }, market) def parse_order_status(self, status: Str) -> Str: statuses = { 'live': 'open', 'filled': 'closed', 'canceled': 'canceled', 'partially_filled': 'open', } return self.safe_string(statuses, status, status) def parse_order_type(self, type: Str) -> Str: types = { 'limit': 'limit', 'market': 'market', 'post_only': 'limit', 'ioc': 'market', 'TPSL': 'market', } return self.safe_string(types, type, type) def parse_order_time_in_force(self, type: Str) -> Str: timeInForces = { 'post_only': 'PO', 'ioc': 'IOC', 'limit': 'GTC', 'market': 'GTC', } return self.safe_string(timeInForces, type, type) async def fetch_positions_for_symbol(self, symbol: str, params={}) -> List[Position]: """ fetch open positions for a single market https://www.deepcoin.com/docs/DeepCoinAccount/accountPositions fetch all open positions for specific symbol :param str symbol: unified market symbol :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict[]: a list of `position structure ` """ await self.load_markets() market = self.market(symbol) instrumentType = self.convert_to_instrument_type(market['type']) request: dict = { 'instType': instrumentType, 'instId': market['id'], } response = await self.privateGetDeepcoinAccountPositions(self.extend(request, params)) data = self.safe_list(response, 'data', []) return self.parse_positions(data, [market['symbol']]) async def fetch_positions(self, symbols: Strings = None, params={}) -> List[Position]: """ fetch all open positions https://www.deepcoin.com/docs/DeepCoinAccount/accountPositions :param str[] [symbols]: list of unified market symbols :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict[]: a list of `position structure ` """ await self.load_markets() symbols = self.market_symbols(symbols, None, True, True) marketType = 'swap' market: Market = None if symbols is not None: firstSymbol = self.safe_string(symbols, 0) market = self.market(firstSymbol) marketType, params = self.handle_market_type_and_params('fetchPositions', market, params, marketType) instrumentType = self.convert_to_instrument_type(marketType) request: dict = { 'instType': instrumentType, } response = await self.privateGetDeepcoinAccountPositions(self.extend(request, params)) # # { # "code": "0", # "msg": "", # "data": [ # { # "instType": "SWAP", # "mgnMode": "cross", # "instId": "DOGE-USDT-SWAP", # "posId": "1001110099878275", # "posSide": "long", # "pos": "20", # "avgPx": "0.18408", # "lever": "75", # "liqPx": "0.00001", # "useMargin": "0.049088", # "mrgPosition": "merge", # "ccy": "USDT", # "uTime": "1760709419000", # "cTime": "1760709419000" # } # ] # } # data = self.safe_list(response, 'data', []) return self.parse_positions(data, symbols) def parse_position(self, position: dict, market: Market = None) -> Position: # # { # "instType": "SWAP", # "mgnMode": "cross", # "instId": "DOGE-USDT-SWAP", # "posId": "1001110099878275", # "posSide": "long", # "pos": "20", # "avgPx": "0.18408", # "lever": "75", # "liqPx": "0.00001", # "useMargin": "0.049088", # "mrgPosition": "merge", # "ccy": "USDT", # "uTime": "1760709419000", # "cTime": "1760709419000" # } # marketId = self.safe_string(position, 'instId') market = self.safe_market(marketId, market) timestamp = self.safe_integer(position, 'cTime') return self.safe_position({ 'symbol': market['symbol'], 'id': self.safe_string(position, 'posId'), 'timestamp': timestamp, 'datetime': self.iso8601(timestamp), 'contracts': self.safe_string(position, 'pos'), 'contractSize': None, 'side': self.safe_string(position, 'posSide'), 'notional': None, 'leverage': self.omit_zero(self.safe_string(position, 'lever')), 'unrealizedPnl': None, 'realizedPnl': None, 'collateral': None, 'entryPrice': self.safe_string(position, 'avgPx'), 'markPrice': None, 'liquidationPrice': self.safe_string(position, 'liqPx'), 'marginMode': self.safe_string(position, 'mgnMode'), 'hedged': True, 'maintenanceMargin': self.safe_string(position, 'useMargin'), 'maintenanceMarginPercentage': None, 'initialMargin': None, 'initialMarginPercentage': None, 'marginRatio': None, 'lastUpdateTimestamp': self.safe_integer(position, 'uTime'), 'lastPrice': None, 'stopLossPrice': None, 'takeProfitPrice': None, 'percentage': None, 'info': position, }) async def set_leverage(self, leverage: int, symbol: Str = None, params={}): """ set the level of leverage for a market https://www.deepcoin.com/docs/DeepCoinAccount/accountSetLeverage :param float leverage: the rate of leverage :param str symbol: unified market symbol :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.marginMode]: 'cross' or 'isolated'(default is cross) :param str [params.mrgPosition]: 'merge' or 'split', default is merge :returns dict: response from the exchange """ if symbol is None: raise ArgumentsRequired(self.id + ' setLeverage() requires a symbol argument') # WARNING: THIS WILL INCREASE LIQUIDATION PRICE FOR OPEN ISOLATED LONG POSITIONS # AND DECREASE LIQUIDATION PRICE FOR OPEN ISOLATED SHORT POSITIONS if leverage < 1: raise BadRequest(self.id + ' setLeverage() leverage should be minimum 1') await self.load_markets() market = self.market(symbol) marginMode = 'cross' marginMode, params = self.handle_margin_mode_and_params('setLeverage', params, marginMode) if (marginMode != 'cross') and (marginMode != 'isolated'): raise BadRequest(self.id + ' setLeverage() requires a marginMode parameter that must be either cross or isolated') mrgPosition = 'merge' mrgPosition, params = self.handle_option_and_params(params, 'setLeverage', 'mrgPosition', mrgPosition) if mrgPosition != 'merge' and mrgPosition != 'split': raise BadRequest(self.id + ' setLeverage() mrgPosition parameter must be either merge or split') request: dict = { 'lever': leverage, 'mgnMode': marginMode, 'instId': market['id'], 'mrgPosition': mrgPosition, } response = await self.privatePostDeepcoinAccountSetLeverage(self.extend(request, params)) # # { # code: '0', # msg: '', # data: { # instId: 'ETH-USDT-SWAP', # lever: '2', # mgnMode: 'cross', # mrgPosition: 'merge', # sCode: '0', # sMsg: '' # } # } # return response async def fetch_funding_rates(self, symbols: Strings = None, params={}) -> FundingRates: """ fetch the funding rate for multiple markets https://www.deepcoin.com/docs/DeepCoinTrade/currentFundRate :param str[]|None symbols: list of unified market symbols :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.subType]: "linear" or "inverse" :returns dict[]: a list of `funding rate structures `, indexed by market symbols """ await self.load_markets() symbols = self.market_symbols(symbols, 'swap', True, True, True) subType = 'linear' firstMarket: Market = None if symbols is not None: firstSymbol = self.safe_string(symbols, 0) firstMarket = self.market(firstSymbol) subType, params = self.handle_sub_type_and_params('fetchFundingRates', firstMarket, params, subType) instType = 'SwapU' if subType == 'inverse': instType = 'Swap' elif subType != 'linear': raise BadRequest(self.id + ' fetchFundingRates() subType parameter must be either linear or inverse') request: dict = { 'instType': instType, } response = await self.privateGetDeepcoinTradeFundRateCurrentFundingRate(self.extend(request, params)) # # { # "code": "0", # "msg": "", # "data": { # "current_fund_rates": [ # { # "instrumentId": "SPKUSDT", # "fundingRate": 0.00005 # }, # { # "instrumentId": "LAUNCHCOINUSDT", # "fundingRate": 0.00005 # } # ] # } # } # data = self.safe_dict(response, 'data', {}) rates = self.safe_list(data, 'current_fund_rates', []) return self.parse_funding_rates(rates, symbols) async def fetch_funding_rate(self, symbol: str, params={}) -> FundingRate: """ fetch the current funding rate https://www.deepcoin.com/docs/DeepCoinTrade/currentFundRate :param str symbol: unified market symbol :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `funding rate structure ` """ await self.load_markets() market = self.market(symbol) if not market['swap']: raise ExchangeError(self.id + ' fetchFundingRate() is only valid for swap markets') request: dict = { 'instId': market['id'], 'instType': self.get_product_group_from_market(market), } response = await self.privateGetDeepcoinTradeFundRateCurrentFundingRate(self.extend(request, params)) # # { # "code": "0", # "msg": "", # "data": { # "current_fund_rates": [ # { # "instrumentId": "ETHUSDT", # "fundingRate": 0.0000402356250176 # } # ] # } # } # data = self.safe_dict(response, 'data', {}) rates = self.safe_list(data, 'current_fund_rates', []) entry = self.safe_dict(rates, 0, {}) return self.parse_funding_rate(entry, market) def parse_funding_rate(self, contract, market: Market = None) -> FundingRate: # # { # "instrumentId": "ETHUSDT", # "fundingRate": 0.0000402356250176 # } # marketId = self.safe_string_2(contract, 'instrumentId', 'instrumentID') symbol = self.safe_symbol(marketId, market) return { 'info': contract, 'symbol': symbol, 'markPrice': None, 'indexPrice': None, 'interestRate': None, 'estimatedSettlePrice': None, 'timestamp': None, 'datetime': None, 'fundingRate': self.safe_number(contract, 'fundingRate'), 'fundingTimestamp': None, 'fundingDatetime': None, 'nextFundingRate': None, 'nextFundingTimestamp': None, 'nextFundingDatetime': None, 'previousFundingRate': None, 'previousFundingTimestamp': None, 'previousFundingDatetime': None, 'interval': None, } async def fetch_funding_rate_history(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}): """ fetches historical funding rate prices https://www.deepcoin.com/docs/DeepCoinTrade/fundingRateHistory :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 ` to fetch :param dict [params]: extra parameters specific to the exchange API endpoint :param int [params.page]: pagination page number :returns dict[]: a list of `funding rate structures ` """ if symbol is None: raise ArgumentsRequired(self.id + ' fetchFundingRateHistory() requires a symbol argument') await self.load_markets() market = self.market(symbol) request: dict = { 'instId': market['id'], } if limit is not None: request['size'] = limit # default 20, max 100 response = await self.privateGetDeepcoinTradeFundRateHistory(self.extend(request, params)) # # { # "code": "0", # "msg": "", # "data": { # "rows": [ # { # "instrumentID": "ETHUSD", # "rate": "0.00046493", # "CreateTime": 1760860800, # "ratePeriodSec": 0 # }, # { # "instrumentID": "ETHUSD", # "rate": "0.00047949", # "CreateTime": 1760832000, # "ratePeriodSec": 0 # } # ] # } # } # data = self.safe_dict(response, 'data', {}) rows = self.safe_list(data, 'rows', []) return self.parse_funding_rate_histories(rows, market, since, limit) def parse_funding_rate_history(self, info, market: Market = None): # # { # "instrumentID": "ETHUSD", # "rate": "0.00047949", # "CreateTime": 1760832000, # "ratePeriodSec": 0 # } # timestamp = self.safe_timestamp(info, 'CreateTime') instrumentID = self.safe_string_2(info, 'instrumentID', 'instrumentId') market = self.safe_market(instrumentID, market, None, 'swap') return { 'info': info, 'symbol': market['symbol'], 'fundingRate': self.safe_number(info, 'rate'), 'timestamp': timestamp, 'datetime': self.iso8601(timestamp), } async def fetch_my_trades(self, symbol: Str = None, since: Int = None, limit: Int = None, params={}): """ fetch all trades made by the user https://www.deepcoin.com/docs/DeepCoinTrade/tradeFills :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 :param dict [params]: extra parameters specific to the exchange API endpoint :param int [params.until]: timestamp in ms of the latest trade to fetch :param str [params.type]: 'spot' or 'swap', the market type for the trades(default is 'spot') :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) :returns Trade[]: a list of `trade structures ` """ await self.load_markets() paginate = False paginate, params = self.handle_option_and_params(params, 'fetchMyTrades', 'paginate') if paginate: return await self.fetch_paginated_call_dynamic('fetchMyTrades', symbol, since, limit, params) market: Market = None if symbol is not None: market = self.market(symbol) marketType = 'spot' marketType, params = self.handle_market_type_and_params('fetchMyTrades', market, params, marketType) request: dict = { 'instType': self.convert_to_instrument_type(marketType), } if market is not None: request['instId'] = market['id'] if since is not None: request['begin'] = since if limit is not None: request['limit'] = limit # default 100, max 100 until = self.safe_integer(params, 'until') if until is not None: params = self.omit(params, 'until') request['end'] = until response = await self.privateGetDeepcoinTradeFills(self.extend(request, params)) # # { # "code": "0", # "msg": "", # "data": [ # { # "instType": "SPOT", # "instId": "ETH-USDT", # "tradeId": "1001056429613610", # "ordId": "1001435238208686", # "clOrdId": "", # "billId": "10010564296136101", # "tag": "", # "fillPx": "3791.15", # "fillSz": "0.004", # "side": "sell", # "posSide": "", # "execType": "", # "feeCcy": "USDT", # "fee": "0.0151646", # "ts": "1760704540000" # } # ] # } # data = self.safe_list(response, 'data', []) return self.parse_trades(data, market, since, limit) 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 https://www.deepcoin.com/docs/DeepCoinTrade/tradeFills :param str id: order id :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 to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.type]: 'spot' or 'swap', the market type for the trades :returns dict[]: a list of `trade structures ` """ await self.load_markets() marketType = self.safe_string(params, 'type') if symbol is None and marketType is None: raise ArgumentsRequired(self.id + ' fetchOrderTrades requires a symbol argument or a market type in the params') params = self.extend({'ordId': id}, params) return await self.fetch_my_trades(symbol, since, limit, params) async def close_position(self, symbol: str, side: OrderSide = None, params={}) -> Order: """ closes open positions for a market https://www.deepcoin.com/docs/DeepCoinTrade/batchClosePosition https://www.deepcoin.com/docs/DeepCoinTrade/closePositionByIds :param str symbol: Unified CCXT market symbol :param str [side]: not used by deepcoin :param dict [params]: extra parameters specific to the exchange API endpoint :param str|None [params.positionId]: the id of the position you would like to close :param str[]|None [params.positionIds]: list of position ids to close(for batch closing) :returns dict: an `order structure ` """ await self.load_markets() market = self.market(symbol) productGroup = self.get_product_group_from_market(market) positionId = self.safe_string(params, 'positionId') positionIds = self.safe_list(params, 'positionIds') request: dict = { 'instId': market['id'], 'productGroup': productGroup, } response = None if positionId is None and positionIds is None: response = await self.privatePostDeepcoinTradeBatchClosePosition(self.extend(request, params)) else: if positionId is not None: params = self.omit(params, 'positionId') request['positionIds'] = [positionId] response = await self.privatePostDeepcoinTradeClosePositionByIds(self.extend(request, params)) data = self.safe_list(response, 'data', []) return self.parse_order(data, market) def sign(self, path, api='public', method='GET', params={}, headers=None, body=None): requestPath = path if method == 'GET': query = self.urlencode(params) if len(query): requestPath += '?' + query url = self.urls['api'][api] + '/' + requestPath if api == 'private': self.check_required_credentials() timestamp = self.milliseconds() dateTime = self.iso8601(timestamp) payload = dateTime + method + '/' + requestPath headers = { 'DC-ACCESS-KEY': self.apiKey, 'DC-ACCESS-TIMESTAMP': dateTime, 'DC-ACCESS-PASSPHRASE': self.password, 'appid': '200103', } if method != 'GET': body = self.json(params) headers['Content-Type'] = 'application/json' payload += body signature = self.hmac(self.encode(payload), self.encode(self.secret), hashlib.sha256, 'base64') headers['DC-ACCESS-SIGN'] = signature return {'url': url, 'method': method, 'body': body, 'headers': headers} def handle_errors(self, code: int, reason: str, url: str, method: str, headers: dict, body: str, response, requestHeaders, requestBody): data = self.safe_dict(response, 'data', {}) msg = self.safe_string(response, 'msg') messageCode = self.safe_string(response, 'code') sCode = self.safe_string(data, 'sCode') sMsg = self.safe_string(data, 'sMsg') errorCode = self.safe_string(data, 'errorCode') if (msg is not None) and (msg == '') and (sMsg is not None): msg = sMsg errorList = self.safe_list(data, 'errorList') if errorList is not None: for i in range(0, len(errorList)): entry = self.safe_dict(errorList, i, {}) errorCode = self.safe_string(entry, 'errorCode') feedback = self.id + ' ' + body if (sCode is None) and (errorCode is not None): sCode = errorCode retCode = self.safe_string(data, 'retCode') if (sCode is None) and (retCode is not None): sCode = retCode if (code != 200) or (messageCode != '0') or (sCode is not None and sCode != '0'): self.throw_exactly_matched_exception(self.exceptions['exact'], messageCode, feedback) self.throw_exactly_matched_exception(self.exceptions['exact'], sCode, feedback) self.throw_exactly_matched_exception(self.exceptions['exact'], msg, feedback) self.throw_broadly_matched_exception(self.exceptions['broad'], msg, feedback) raise ExchangeError(feedback) else: list = self.safe_list(data, 'list', []) if ('list' in data) and (list is None): raise NullResponse(feedback) return None