i@ddlmZddlmZddlmZmZmZmZm Z m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZddlmZddlmZddlmZddlmZddlmZdd lmZdd lmZdd lm Z dd lm!Z!dd lm"Z"ddlm#Z#ddlm$Z$ddlm%Z%ddl&m'Z'ddl(m)Z)GddeeZ*dS))kucoin) ImplicitAPI)BalancesCurrencyIntMarginModificationMarketNumOrder OrderBook OrderRequest OrderSide OrderTypeStrStringsTickerTickersTrade Transaction TransferEntry)List)AuthenticationError)PermissionDenied)AccountSuspended)ArgumentsRequired) BadRequest)InsufficientFunds) InvalidOrder) OrderNotFound) NotSupported)RateLimitExceeded)ExchangeNotAvailable) InvalidNonce) TICK_SIZE)Precisec eZdZfdZifdZifdeefdZifdZdddifde d e d e dee fd Z d>d ede fd Z ifde fdZdifde d e defdZifde defdZdifdedefdZd>d edefdZdddifded e d e fdZifde fdZdifdefdZd>d efdZdifde dedededef dZ ifdee!fdZ"difde dedededef d Z#difd!e defd"Z$difdefd#Z%ifde de&fd$Z'd>d ede&fd%Z(dddifded e d e fd&Z)dddifded e d e dee*fd'Z+dddifded e d e dee*fd(Z,ddifd!edefd)Z-d>d ede*fd*Z.ifde fd+Z/de0fd,Z1ifde0fd-Z2ifde ded.e d/e de3f d0Z4d>d1e5fd2Z6d3Z7dddifded e d e fd4Z8ddifde d e d e dee9fd5Z:d>d ede9fd6Z;dddifded e d e dee<fd7Z=dddifded e d e dee<fd8Z>ifde fd9Z?d>d efd:Z@dddifded e d e fd;ZAd>d efd<ZBdifde dede*fd=ZCxZDS)? kucoinfuturesc|tt|iddddddgddd d d d d d dddddidddddddd dd dddd dd dd dddd dddd d d d!d d"d d#d id$d d%d d&d d'd d(d d)d d*d d+dd,dd-d d.dd/dd0dd1d d2d d3dd4did5d d6d d7d d8dd9dd:dd;d ddd?dd@d dAd dBddCd dDd dEd idFd dGd dHd dIddJd dKddLd dMd dNd dOd dPd dQddRd dSddTddUd dVddWdXdYdZgd[d\d]d]d^d^d_d`dadbd d d dcddidedfdgdfdhdfdidfdjdkdldfdmdfdndfdodfdpdfdqdfdrdfdsdfdtdfdudfdvdfdwdfdxdfidydfidzid{dkd|d}d~dfddfddfddfddfddkddfddfddfddfdd}dd}ddfddfdd}d}dfdfddfdfdfdkdkdfdfdfdfdfdfd dfdfdfd}dfdfdfdddddfiiddtdidt dt dtdtdtdt dtdtdtdtdt dtdtdtdtdtdtt tt t t t t tt ttd dtiddd d |d|d|d|dg|d|dg|d|dg|d|dg|d|dg|d|dg|d|dg|d|dg|d|dg|d|dg|d|dg|d|dg|d|dgg |d|dg|d|dg|d|dg|d|dg|d|dg|d|dg|d|dg|d|dg|d|d¦g|d|dæg|d|dĦg|d|dŦg|d|dƦgg dǜdȜddiidɜdʜddddddddҜdfdddddddddddddݜ d dddiidddiiddodiidddddddS)Nidr'namezKuCoin Futures countriesSC rateLimitKversionv1 certifiedTprocommentz Platform 2.0quoteJsonNumbersFhasCORSspotmarginswapfutureoption addMargincancelAllOrders cancelOrdercloseAllPositions closePositionclosePositionscreateDepositAddress createOrder createOrderscreateReduceOnlyOrdercreateStopLimitOrdercreateStopLossOrdercreateStopMarketOrdercreateStopOrdercreateTakeProfitOrdercreateTriggerOrder fetchAccounts fetchBalancefetchBorrowRateHistoriesfetchBorrowRateHistoryfetchClosedOrdersfetchCrossBorrowRatefetchCrossBorrowRatesfetchCurrenciesfetchDepositAddress fetchDepositsfetchDepositWithdrawFeefetchDepositWithdrawFeesfetchFundingHistoryfetchFundingRatefetchFundingRateHistoryfetchIndexOHLCVfetchIsolatedBorrowRatefetchIsolatedBorrowRatesfetchL3OrderBook fetchLedgerfetchLeverageTiersfetchMarginAdjustmentHistoryfetchMarginModefetchMarketLeverageTiers fetchMarketsfetchMarkOHLCV fetchMyTrades fetchOHLCVfetchOpenOrders fetchOrderfetchOrderBook fetchPositionfetchPositionModefetchPositionsfetchPremiumIndexOHLCV fetchStatus fetchTicker fetchTickers fetchTime fetchTradesfetchTransactionFeefetchWithdrawals setLeverage setMarginModetransferwithdrawurlszdhttps://user-images.githubusercontent.com/1294454/147508995-9e35030a-d046-43a1-a006-6fabd981b554.jpgzhttps://docs.kucoin.com/futureszhttps://docs.kucoin.comzhttps://futures.kucoin.com/z(https://futures.kucoin.com/?rcode=E5wkqezhttps://openapi-v2.kucoin.comzhttps://api-futures.kucoin.comz)https://futures.kucoin.com/_api/web-front)publicprivatefuturesPrivate futuresPublic webExchange)logodocwwwreferralapirequiredCredentials)apiKeysecretpasswordrzcontracts/activezcontracts/{symbol}zcontracts/risk-limit/{symbol}tickerzlevel2/snapshotgHzG?zlevel2/depth{limit}zlevel2/message/queryzlevel3/message/queryzlevel3/snapshotz trade/historyzinterest/queryz index/queryzmark-price/{symbol}/currentz premium/queryzfunding-rate/{symbol}/current timestampstatusz kline/queryz bullet-public)getpostzaccount-overviewztransaction-historyg(\@zdeposit-addressz deposit-listzwithdrawals/quotaszwithdrawal-listz transfer-listorders stopOrdersrecentDoneOrdersorders/{orderId}zorders/byClientOidfills recentFillsopenOrderStatisticsposition positions)zfunding-history sub/api-keyztrade-statistics) withdrawals transfer-outz transfer-inrz orders/testz#position/margin/auto-deposit-statuszposition/margin/deposit-marginz position/risk-limit-level/changezbullet-privaterzsub/api-key/update)zwithdrawals/{withdrawalId}zcancel/transfer-outrrrrzorders/client-order/{clientOid})rrdeleterzcontract/{symbol}/funding-rates)r~r}r precisionMode exceptions400401403404405415429500503100001100004101030200004230003260100300003300012) 400001400002400003400004400005400006400007404000400100411100500000zPosition does not exist)exactbroadfeesz0.0006z0.0002050200z0.00051000z0.000420004000z0.000388000z0.0003515000z0.0003225000z0.0003400006000080000z0.02z0.015z0.01z-0.003z-0.006z-0.009z-0.012z-0.015)takermaker) tierBased percentagerrtiers)rrrydeposit)tradingfundingcommonCurrenciesHOTNOWDADIWAXPTriasVAIOTBTC)HOTEDGEWAXTRYVAIXBT<xiiii`') 1m3m5m15m30m1h2h4h6h8h12h1d1w-USDTPOSTrv2GET)r}r~omniethtrx)OMNIERC20TRC20)r/symbolSeparator defaultTypecode marginModes marginTypesversionsnetworks) timeframesoptions) deep_extendsuperr'describer$rrr r!r"rrrr#rr parse_number)self __class__s X/var/www/html/crypto-bot/backend/venv/lib/python3.11/site-packages/ccxt/kucoinfutures.pyrzkucoinfutures.describes mT : : C C E EzH /zH $zH  $zH   zH t zH  zH  4zH  ~zH  zH  EEE%E E $ E % ETE"4EtE$UE E!%E'EtEE (!E"'#EE$&t%E&('E("4)E*(+E,%d-E. /E01E2+E3E4)%5E6$T7E8'9E:(;E<"5=E>&t?E@ AEB*5CED+EEEEEF&tGEH#DIEJ*4KEL"5MEN*5OEP+EQER#DSETtUEV%eWEX/YEZ"5[E\+D]E^_E`!%aEb cEddeEf"4gEEEhdiEj!$kEl mEn$UoEp!$qEr)%sEttuEvtwExyEzT{E|t}E~&uE@#DAEBuCED EEFDGEHDIEEzH ` ~5-5F=>&F%E#N azH @ " $$AzH J *A,a8!!  *4  .q //*1()!&q6q(8 $Q!"!!#$&q%*(+""4*D-t*1'  -a  *1 (!$%a+A+A-a &t.q #A!"$T#$,0'(,-).()()'("&'+?@:;<=*+'(./  78/0,-"&&''(;<I-#-#^91 QMMKzH f YgzH h :.<<  <  : ,//lj./// /!"l#$2*11111*(.29>.}?""izH n !%"&!..x88!..x88"..s33T5F5Fx5P5PQ!..t44d6G6G6Q6QR!..u55t7H7H7R7RS!..u55t7H7H7R7RS!..v668I8I(8S8ST!..v668I8I(8S8ST!..v668I8I)8T8TU!..v668I8I)8T8TU!..w779J9J99U9UV!..w779J9J89T9TU!..w779J9J89T9TU!..w779J9J89T9TU!..w779J9J89T9TU" "..s33T5F5Fv5N5NO!..t44d6G6G6P6PQ!..u55t7H7H7P7PQ!..u55t7H7H7P7PQ!..v668I8I&8Q8QR!..v668I8I#8N8NO!..v668I8I#8N8NO!..v668I8I#8N8NO!..w779J9J89T9TU!..w779J9J89T9TU!..w779J9J89T9TU!..w779J9J89T9TU!..w779J9J89T9TU"! %%N"'"' "! O--ozH J  !!KzH \  #&%!!*D!' -t &  #"")yzH zH zH z z z c||}||di}||d}|dkrdndddd|dS)am the latest known information on the availability of the exchange API :see: https://www.kucoin.com/docs/rest/futures-trading/market-data/get-service-status :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `status structure ` dataropenok maintenanceN)rupdatedetaurlinfo)futuresPublicGetStatus safe_value safe_string)r paramsresponserrs r  fetch_statuszkucoinfutures.fetch_statusYso..v66x44!!$11%//ddm    r returnc,||}g}||dg}tdt|D]F}||}||d}||d}|rdnd} | } ||d} ||d} ||d } || }|| }|| }|d z|zd z|z}d }| r|d z||dz}d}||d}||d}||d}||d}||d}|}|||d}||d}|||d}||d}|T||d}||d}| tj ||}| id|d|d|d|d|d| d | d!| d"|d#dd$dd | d| d%dd&|d'kd(dd)| |||d*||d+| tj ||||dd||d,| d-||d.d/||d/||d/||d0||dd/d1||d2|d3 H|S)4a8 retrieves data on all markets for kucoinfutures :see: https://www.kucoin.com/docs/rest/futures-trading/market-data/get-symbols-list :param dict [params]: extra parameters specific to the exchange api endpoint :returns dict[]: an array of objects representing market data rrsymbol expireDateTF baseCurrency quoteCurrencysettleCurrency/:r9rr: isInverser multipliertickSizelotSizeN baseMinSize maxOrderQty baseMaxSizemaxPrice quoteMaxSizer)basequotesettlebaseIdquoteIdsettleIdtyper7r8r;activeOpencontractlinear takerFeeRate makerFeeRate)amountprice1 maxLeverage)minmax quoteMinSize)leverager<r=cost firstOpenDate) inverserr contractSizeexpiryexpiryDatetimestrike optionType precisionlimitscreatedr)futuresPublicGetContractsActiverrangelenr safe_integersafe_currency_codeyymmdd safe_numberrr% string_divappend string_absiso8601)r rrresultrimarketr)rHr:r9r2r3r4r/r0r1rr5rFrr'r(r)limitAmountMinlimitAmountMax limitPriceMaxbaseMinSizeStringquoteMaxSizeStrings r  fetch_marketszkucoinfutures.fetch_marketsts77??~x44q#d))$$S S A!WF!!&(33B&&v|<` r)currencyraddressNIMmemochain)rrrtagnetwork)rprfuturesPrivateGetDepositAddressrwrr check_address) r rrr currencyIdr}rrrs r fetch_deposit_addressz#kucoinfutures.fetch_deposit_addressks ==&&d^   77 GV8T8TUUx44""433      w ' ' '"##D&11''g66    r c |||d}|dkr|t|jdz||}d|di}|)|dks|dkr||d <nt|jd zd|d <||||}||d i}|| |d d z } | ||d| dddd} | |d| d<| S)aZ fetches information on open orders with bid(buy) and ask(sell) prices, volumes and other data :see: https://www.kucoin.com/docs/rest/futures-trading/market-data/get-part-order-book-level-2 :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 levelrNz) fetchOrderBook() can only return level 2rr)drgz2 fetchOrderBook() limit argument must be 20 or 100rts@Bbidsasksrrsequencenonce) rprUrr)r\ futuresPublicGetLevel2DepthLimitrwr parse_to_intrRparse_order_book) r rrgrrr\r}rrr orderbooks r fetch_order_bookzkucoinfutures.fetch_order_books]   11 A::%+TW'RRSS SV$$ fTl    ##(   +_!_```!GG 88Wf9U9UVV&x44%%d&7&7d&C&Cg&MNN ))$x0@)VU[]^`abb !..tZ@@ 'r c|||}d|di}||||}||d|S)a fetches a price ticker, a statistical calculation with the information calculated over the past 24 hours for a specific market :see: https://www.kucoin.com/docs/rest/futures-trading/market-data/get-ticker :param str symbol: unified symbol of the market to fetch the ticker for :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `ticker structure ` rr)r)rpr\futuresPublicGetTickerrw parse_ticker)r rrr\r}rs r  fetch_tickerzkucoinfutures.fetch_tickersw V$$ fTl ..t{{7F/K/KLL&  &!16:::r symbolsc|||}||}||dg}|||}||d|S)a* fetches price tickers for multiple markets, statistical information calculated over the past 24 hours for each market :see: https://www.kucoin.com/docs/rest/futures-trading/market-data/get-symbols-list :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 ` rr)rpmarket_symbolsrOrx parse_tickersfilter_by_array_tickers)r rrrrtickerss r  fetch_tickerszkucoinfutures.fetch_tickerss %%g..77??~~~h33$$T733++GXwGGGr c||d}|||d}||dd}||dd}|id|dd|d||d ||d d ||d d ||dd||dd||dd||dddddd|d|ddd||dd||ddd||d||d |d!|S)"Nrrr=lastTradePricergư>rdatetimehigh highPricelowlowPricebid bestBidPrice bidVolume bestBidSizeask bestAskPrice askVolume bestAskSizevwaprcloselast previousClosechangepriceChgr priceChgPctaverage volumeOf24h turnoverOf24h) baseVolume quoteVolumer)r safe_market safe_string_2safe_integer_product safe_tickerrY)r rr\r{rrs r rzkucoinfutures.parse_ticker0s^##FH55!!(FC88!!&'3CDD--fdHEE ! fX&! !   Y//!  D$$V[99 ! 4##FJ77 ! 4##FN;; !  ))&-@@!  4##FN;;!  ))&-@@!  D!  D!  T!  D!  T!  d&&vz::! $**6=AA!! " t#! $**6=AA++FODD)! ! ! * + r c|t|jdz|||}d|di}|||d<|||d<||||}||d}||dg} g} td t| D]} | | } | | d } | | || | | d | | | || d|| d || d || d|| d|| dd | S)aV fetch the history of funding payments paid and received on self account :see: https://www.kucoin.com/docs/rest/futures-trading/funding-fees/get-funding-history :param str symbol: unified market symbol :param int [since]: the earliest time in ms to fetch funding history for :param int [limit]: the maximum number of funding history structures to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `funding history structure ` Nz1 fetchFundingHistory() requires a symbol argumentrr)startAtmaxCountrdataListr timePointr"r fundingRate markPrice positionQty positionCost) rrrrrr)r<rrrr)rr)rpr\futuresPrivateGetFundingHistoryrwrrPrQrRrWrSrrYrU)r rrfrgrr\r}rrrrr[listItemrs r fetch_funding_historyz#kucoinfutures.fetch_funding_historys >#DG.a$abb b V$$ fTl   !&GI   "'GJ 77 GV8T8TUU.x00??4R88q#h--((  A{H))(K@@I KK  //0@0@K[0\0\]]& LL33&&x66**8Y??#//-HH!--h DD#//-HH $ 0 0> J J       r c|||}d|di}||||}||di}|||S)a :see: https://docs.kucoin.com/futures/#get-position-details fetch data on an open position :param str symbol: unified market symbol of the market the position is held in :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `position structure ` rr)r)rpr\futuresPrivateGetPositionrw safe_dictparse_positionr rrr\r}rrs r fetch_positionzkucoinfutures.fetch_positions V$$ fTl 11$++gv2N2NOOZ~~h33""4000r c|||}||d}|||S)ak fetch all open positions :see: https://docs.kucoin.com/futures/#get-position-list :param str[]|None symbols: list of unified market symbols :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict[]: a list of `position structure ` r)rpfuturesPrivateGetPositionsrxparse_positions)r rrrrs r fetch_positionszkucoinfutures.fetch_positionssU 226::^~~h//##D'222r c||d}|||}||d}||d}d}tj|drd}ntj|drd}tj||d}||d}tj||} ||d } ||d } | rd nd } | id |d||dd||dd|d| |ddd| |d| | d| |dd| |dd| |dd| |d| |dd| | d| tj|d||dd | |d!d| |d"| |d#d| |d$| |dddd% S)&NrcurrentTimestamp currentQtyrlongshortposCostposInit unrealisedPnl crossModecrossisolatedrr)rrlastUpdateTimestamp initialMargininitialMarginPercentagemaintenanceMarginposMaintmaintenanceMarginPercentagemaintMarginReq entryPrice avgEntryPricenotionalrC realLeverage unrealizedPnl contractsrG realizedPnl realisedPnlliquidationPricer maintMargin) marginRatiorr lastPrice collateral marginModesider stopLossPricetakeProfitPrice) rrrRr% string_gt string_ltrXrVr safe_positionrYrrU) r rr\rrsizerrrrrrrs r rzkucoinfutures.parse_positionTs5^!!(H55!!&&11%%h0BCC ,77  T3 ' ' DD  tS ) ) D%d&6&6x&K&KLL((9== ")"4]H"M"M((?CC OOHk:: )9WWz !!# H# $""8T22#  d&&vx88#   #  Y// # "4 #  T..}==#  &t'8'89P'Q'Q#  !1!1(J!G!G#  *4+;+;HFV+W+W#  $**8_EE#  ))(33#  ((>BB#  T..}==#  **7+=d+C+CDD# DOOFNCC!# " 4++HmDD## $ $ 0 0;M N N))(K@@**8]CC$!#7# # #    r r5rr<r=c|||}||dd}||d}|||||||} d} |r|| } n|| } || di} || |S)a2 Create an order on the exchange :see: https://docs.kucoin.com/futures/#place-an-order :param str symbol: Unified CCXT market symbol :param str type: 'limit' or 'market' :param str side: 'buy' or 'sell' :param float amount: the amount of currency to trade :param float [price]: *ignored in "market" orders* the price at which the order is to be fullfilled at in units of the quote currency :param dict [params]: extra parameters specific to the exchange API endpoint :param float [params.triggerPrice]: The price a trigger order is triggered at :param float [params.stopLossPrice]: price to trigger stop-loss orders :param float [params.takeProfitPrice]: price to trigger take-profit orders :param bool [params.reduceOnly]: A mark to reduce the position size only. Set to False by default. Need to set the position size when reduceOnly is True. :param str [params.timeInForce]: GTC, GTT, IOC, or FOK, default is GTC, limit orders only :param str [params.postOnly]: Post only flag, invalid when timeInForce is IOC or FOK * ----------------- Exchange Specific Parameters ----------------- :param float [params.leverage]: Leverage size of the order :param str [params.clientOid]: client order id, defaults to uuid if not passed :param str [params.remark]: remark for the order, length cannot exceed 100 utf8 characters :param str [params.stop]: 'up' or 'down', the direction the stopPrice is triggered from, requires stopPrice. down: Triggers when the price reaches or goes below the stopPrice. up: Triggers when the price reaches or goes above the stopPrice. :param str [params.stopPriceType]: TP, IP or MP, defaults to MP: Mark Price :param bool [params.closeOrder]: set to True to close position :param bool [params.test]: set to True to use the test order endpoint(does not submit order, use to validate params) :param bool [params.forceHold]: A mark to forcely hold the funds for an order, even though it's an order to reduce the position size. This helps the order stay on the order book and not get canceled when the position size changes. Set to False by default. :returns dict: an `order structure ` testFNr) rpr\ safe_boolomitcreate_contract_order_requestfuturesPrivatePostOrdersTestfuturesPrivatePostOrdersr parse_order) r rr5rr<r=rr\ testOrder orderRequestrrs r  create_orderzkucoinfutures.create_orders6 V$$NN66599 66**99&$fV[]cdd   C88FFHH44\BBH~~h33f---r rc |g}tdt|D]}||}||d}||}||d}||d} ||d} ||d} ||di} ||d|| | | | } || ||}| |d g}| |S) a create a list of trade orders :see: https://www.kucoin.com/docs/rest/futures-trading/orders/place-multiple-orders :param Array orders: list of orders to create, each object should contain the parameters required by createOrder, namely symbol, type, side, amount, price and params :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: an `order structure ` rrr5rr<r=rr)r) rprPrQrr\rr rWfuturesPrivatePostOrdersMultirx parse_orders)r rrordersRequestsr[rawOrderrr\r5rr<r= orderParamsrrrs r  create_orderszkucoinfutures.create_orderssH q#f++&& 0 0AayH%%h99F[[((F##Hf55D##Hf55D__Xx88FOOHg66E//(HbAAK==fTlDRVX^`egrssL  ! !, / / / /55nEE,~~h33  &&&r c||}||dd|}||ddg}|dkrt |jdzt |||} |||d|| dd} ||\} } } ddd d }| |d d }| |||}||gd }| r,|dkrdnd| d<| || | d<|| d<n]| s| rY| r'|dkrdnd| d<| || | d<n&|dkrdnd| d<| || | d<d| d<|| d<| }| |d}|dkr9|t|jdz| ||| d<||| d<d}||dkd|\}}|rd| d<||d}|r|t!|jdz||d}|r/||d }|t|jd!z||gd"}|| |S)#N clientOid clientOrderIdrz1 createOrder() minimum contract order amount is 1r))rrrr5rrCMPTPIP)markrindextriggerPriceTyper!)rr triggerPrice stopPricebuyupdownstopr% stopPriceTypeT reduceOnly timeInForceLIMITz9 createOrder() requires a price argument for limit ordersr=r\FpostOnlyhiddenzW createOrder() does not support the postOnly parameter together with a hidden parametericeberg visibleSizezB createOrder() requires a visibleSize parameter for iceberg orders)r,r%r$rr)r\ruuidr rr)intamount_to_precisionhandle_trigger_pricesrprice_to_precisionuppersafe_string_upperrhandle_post_onlyrrrw)r rr5rr<r=rr\r preciseAmountr}r$rrtriggerPriceTypesr#triggerPriceTypeValue uppercaseTyper,r.r/r0r1s r r z+kucoinfutures.create_contract_order_requestslV$$**6;QUQZQZQ\Q\]] 6K#ABB A::tw)\\]] ]D44VVDDEE &Tl!   8<7Q7QRX7Y7Y4 m_    ++F4FOO $ 0 01BDTVf g g6#d#d#dee  ='+u}}dd6GFO#'#:#:6<#P#PGK ''>v}'U'U $$-1U]]&&'+'>'>v'W'W $$(GL !'` rrNzJ cancelOrder() requires a symbol argument when cancelling by clientOrderIdr)rorderIdr) rprr rr)r\.futuresPrivateDeleteOrdersClientOrderClientOidrw!futuresPrivateDeleteOrdersOrderIdr)r r)rrrr}rr\s r  cancel_orderzkucoinfutures.cancel_orderNs **6;PP 6O#455  $~'2~(~[[((F &t GH #0GK JJ4;;W^`fKgKghhHH!#GI ==dkk'SY>Z>Z[[Hx000r c|i}||||d<||dd}||ddg}d}|r*||||}n)||||}||dS)aZ cancel all open orders :see: https://www.kucoin.com/docs/rest/futures-trading/orders/cancel-multiple-futures-limit-orders :see: https://www.kucoin.com/docs/rest/futures-trading/orders/cancel-multiple-futures-stop-orders :param str symbol: unified market symbol, only orders in the market of self symbol are cancelled when symbol is not None :param dict [params]: extra parameters specific to the exchange API endpoint :param dict [params.trigger]: When True, all the trigger orders will be cancelled :returns: Response from the exchange Nrr)triggerr)rp market_id safe_value_2r futuresPrivateDeleteStopOrdersrwfuturesPrivateDeleteOrdersr)r rrr}r)rs r cancel_all_orderszkucoinfutures.cancel_all_ordersss    $v 6 6GH   ;;6FI#677  U::4;;wPV;W;WXXHH66t{{7F7S7STTHx000r c|||}|}|d||||d}||||}||d}|||||||ddS)a add margin :see: https://www.kucoin.com/docs/rest/futures-trading/positions/add-margin-manually :param str symbol: unified market symbol :param float amount: amount of margin to add :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `margin structure ` r))rr8bizNorin)r< direction)rpr\r2r4-futuresPrivatePostPositionMarginDepositMarginrwrparse_margin_modification) r rr<rr\r2r}rrs r  add_marginzkucoinfutures.add_margins V$$yy{{Tl..vv>>   EEdkkRY[aFbFbccdx00{{499$GG..vv>>J J    r c ||d}|||}||d}||d}|rdnd}||d}||d}||||d|dd||d|||d S) Nr)r"rrrrr) rrr5rr<totalrrrr)rrrrR safe_symbolrSrY) r rr\r)rrmoder{rs r rOz'kucoinfutures.parse_margin_modifications\  dD ) )!!"f--%%d,<== OOD+66 #3ww##FH55%%d,>?? &&x88++J77" Y//   r c2|d}||dd\}}|r|d||||S||dd}||dd}||gd}|d krd }n|d krd }i} |s|| d <n|d krt |jdzd} | ||} | d| d<||| d<||| d<d} |r*| | | |} n)| | | |} | | di} | | dg} || | ||S)a~ fetches a list of orders placed on the exchange :see: https://docs.kucoin.com/futures/#get-order-list :see: https://docs.kucoin.com/futures/#get-untriggered-stop-order-list :param str status: 'active' or 'closed', only 'active' is valid for stop orders :param str symbol: unified symbol for the market to retrieve orders from :param int [since]: timestamp in ms of the earliest order to retrieve :param int [limit]: The maximum number of orders to retrieve :param dict [params]: exchange specific parameters :param bool [params.trigger]: set to True to retrieve untriggered stop orders :param int [params.until]: End time in ms :param str [params.side]: buy or sell :param str [params.type]: 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 [availble parameters](https://github.com/ccxt/ccxt/wiki/Manual#pagination-params) :returns: An `array of order structures ` FfetchOrdersByStatusrir)rDuntiltill)r)rWrXrDcloseddonerr6rz= fetchOrdersByStatus() can only fetch untriggered stop ordersNr)rrrritems)rprqfetch_paginated_call_dynamicrFsafe_integer_2r rr)r\futuresPrivateGetStopOrdersrwfuturesPrivateGetOrdersrrxr)r rrrfrgrrir)rWr}r\r responseDatars r fetch_orders_by_statusz$kucoinfutures.fetch_orders_by_statuss" 88AVXbcc&  j445JFTY[`bhii i  ;;##FGV<<6#G#G#GHH X  FF v  F h &GH   x  TW'ffgg g  [[((F &t GH   !&GI   $GG   R77 GV8T8TUUHH33DKK4P4PQQHhx<<  gr::  >>>r c|d}||dd\}}|r|d||||S|d||||S)a fetches information on multiple closed orders made by the user :see: https://docs.kucoin.com/futures/#get-order-list :param str symbol: unified market symbol of the market orders were made in :param int [since]: the earliest time in ms to fetch orders for :param int [limit]: the maximum number of order structures to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :param int [params.till]: end time in ms :param str [params.side]: buy or sell :param str [params.type]: 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 [availble parameters](https://github.com/ccxt/ccxt/wiki/Manual#pagination-params) :returns Order[]: a list of `order structures ` FrPrirZrprqr\rar rrfrgrris r fetch_closed_ordersz!kucoinfutures.fetch_closed_orderss~ 88ATV`aa&  h445H&RWY^`fgg g**665%PPPr c|d}||dd\}}|r|d||||S|d||||S)a\ fetches information on multiple open orders made by the user :see: https://docs.kucoin.com/futures/#get-order-list :see: https://docs.kucoin.com/futures/#get-untriggered-stop-order-list :param str symbol: unified market symbol of the market orders were made in :param int [since]: the earliest time in ms to fetch orders for :param int [limit]: the maximum number of order structures to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :param int [params.till]: end time in ms :param str [params.side]: buy or sell :param str [params.type]: limit, or market :param boolean [params.trigger]: set to True to retrieve untriggered stop orders :param boolean [params.paginate]: default False, when True will automatically paginate by calling self endpoint multiple times. See in the docs all the [availble parameters](https://github.com/ccxt/ccxt/wiki/Manual#pagination-params) :returns Order[]: a list of `order structures ` Frhrirrcrds r fetch_open_orderszkucoinfutures.fetch_open_orderss~ 88ART^__&  f445FPUW\^dee e**665%PPPr c |i}d}|w||dd}|t|jdz||d<||ddg}||||}n.||d<||||}|||nd}| |d}| ||S)a fetches information on an order made by the user :see: https://docs.kucoin.com/futures/#get-details-of-a-single-order :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 ` Nrrz7 fetchOrder() requires parameter id or params.clientOidr?r) rprrr)r "futuresPrivateGetOrdersByClientOidrwfuturesPrivateGetOrdersOrderIdr\rr) r r)rrr}rrr\r`s r  fetch_orderzkucoinfutures.fetch_orders  : ..v{OTTM$"47-f#fggg#0GK YYv _'EFFF>>t{{7TZ?[?[\\HH!#GI ::4;;wPV;W;WXXHX*0);V$$$$~~h77  f555r c ||d}|||}|d}||dd}||d}||d}||}||d} ||d} ||d} || } ||d } ||d }||d }||d }d}tj|d ro||d}|dr)tj |tj ||}n(tj tj |||}| |d}| |dd}d}||rdnd}|rdn|}d}| | | d}||d}||d}||d}| |d}| |d}||d}| id|d|d|d|d|d|d|d| d|d| d|d|d |d!|d"dd#|d$||||d||dd%|S)&Nrr)r?r5 createdAtr=r feeCurrencyfeer filledSize filledValuerrGr9isActive cancelExistFrrYcanceled)rrDrr,r%r.r+ updatedAtrr<r$rDfilled remainingrr)rorrlastTradeTimestamprrtrades)rrrrRrYrSrUr%rrV string_mulrr  safe_order)r orderr\r{rr?r5rrr=r feeCurrencyIdrnfeeCostr<rvrDrrGrrrsrrorr,r%r.r+rs r rzkucoinfutures.parse_ordersv##E844!!(F33!$$UD)<<v..%%e[99 << **  00v..(( >> --m<< ""5%00!!%00!!%66}55  VS ) ) ]++FNCCLh ]!,T73ElTZ3[3[\\!,W-? f-U-UW[\\??5*55nnUM5AA   '5VVXF*6  'C(( << &&um<< $$UK88 ??5*55__UL99 "//{CC ' ]  f  D  ;     *  D  f  U    I  D  f   ! " # $"1   2 3 r c|||}d|di}||||}||d}||d}id|d|dddddd dd dd dd dd ||dd|d||d||dddddddddddS)a fetch the current funding rate :see: https://www.kucoin.com/docs/rest/futures-trading/funding-fees/get-current-funding-rate :param str symbol: unified market symbol :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `funding rate structure ` rr)rrrrN indexPrice interestRateestimatedSettlePricerrrvaluefundingTimestampfundingDatetimenextFundingRatepredictedValuenextFundingTimestampnextFundingDatetimepreviousFundingRatepreviousFundingTimestamppreviousFundingDatetime)rpr\(futuresPublicGetFundingRateSymbolCurrentrwrrRrUrY)r rrr\r}rrrs r fetch_funding_ratez kucoinfutures.fetch_funding_ratexs V$$ fTl @@WV\A]A]^^x00,,T;?? D fX&    $  D  #D       4++D'::   0  t||,<==  t//6FGG  #D  "4  "4 '! " &t#  r cP|ddd}||d}||d}||}|}||d|d<||d|d<|||<||S)N)rrrrravailableBalancefree accountEquityrR)rrrSaccount safe_balance)r rrZrrrrs r  parse_balancezkucoinfutures.parse_balances   x00%%dJ77 &&z22,,..**41CDD++D/BBt   (((r c|||jd}||jdi}||d|}||d|}||}d|di}||||}||S)a query for balance and get the amount of funds available for trading or funds locked in orders :see: https://www.kucoin.com/docs/rest/funding/funding-overview/get-account-detail-futures :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `balance structure ` rrMrr))rprrrr futuresPrivateGetAccountOverviewrwr)r r defaultCodefetchBalanceOptionsrrr}rs r  fetch_balancezkucoinfutures.fetch_balances &&t|V<< "oodlNBOO&&':FKPP  <<==&&  88Wf9U9UVV !!(+++r  fromAccount toAccountc|dkr|dks|dkr#|dkr|dkrt|jdz|||}|||}||d|d}||||} || d } || | || |dd d S) a transfer currency internally between wallets on the same account :param str code: unified currency code :param float amount: amount to transfer :param str fromAccount: account to transfer from :param str toAccount: account to transfer to :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `transfer structure ` mainrfuturesr:r8zZ transfer() only supports transfers from contract(future) account to main(funding) accountr))rr<rr7)r<rr) rr)rprcurrency_to_precisionrfuturesPrivatePostTransferOutrwrparse_transferr) r rr<rrrramountToPrecisionr}rrs r rxzkucoinfutures.transfersO   I$:$: y@X@X]hlt]t]tzEISzSzSTW(DDEE E ==&& 66tVDD((488'   55dkk'66R6RSSx00{{4..tX>>''(9::#A A    r rc ||d}||d||||d|ddd||d|d S)NruapplyIdr) r)rrrr<rrrr)rRrrYrS)r rxrrs r rzkucoinfutures.parse_transfers%%h << ""8Y77" Y////h??&&x::   r c8ddi}||||S)N PROCESSINGpending)r)r rstatusess r parse_transfer_statusz#kucoinfutures.parse_transfer_statuss( ) &&999r c|d}||dd\}}|r|d||||Si}d}| ||}|d|d<|||d<|d||\}}||||}||d i} || d g} | | |||S) a :see: https://docs.kucoin.com/futures/#get-fills fetch all trades made by the user :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]: End time in ms :param boolean [params.paginate]: default False, when True will automatically paginate by calling self endpoint multiple times. See in the docs all the [availble parameters](https://github.com/ccxt/ccxt/wiki/Manual#pagination-params) :returns Trade[]: a list of `trade structures ` FrfriNr)rrrrr[) rprqr\r\handle_until_optionfuturesPrivateGetFillsrwrrx parse_trades) r rrfrgrrir}r\rrrys r fetch_my_tradeszkucoinfutures.fetch_my_tradess% 88R\]]&  d44_feUZ\bcc c   [[((F &t GH   !&GI 227GVLL..t{{7F/K/KLLD~~h33gr22  >>>r c|||}d|di}||||}||dg}|||||S)a@ get the list of most recent trades for a particular symbol :see: https://www.kucoin.com/docs/rest/futures-trading/market-data/get-transaction-history :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 :param dict [params]: extra parameters specific to the exchange API endpoint :returns Trade[]: a list of `trade structures ` rr)r)rpr\futuresPublicGetTradeHistoryrwrxr) r rrfrgrr\r}rrys r  fetch_tradeszkucoinfutures.fetch_trades`s V$$ fTl 44T[[&5Q5QRR$&"55  >>>r cf||d}|||d}||dd}||d}||d}||d}|||dz }n!||d }d |vr||d z}||d d }||dd} ||d} d} ||d} | ]||d} || }|| dkr|dn|d}| |||dd} ||dd}|dkrd}||dd}|@||d}t j|| }t j||}|||||| ||d||| || || d |S)NrrtradeIdr)r? liquidityrrrm dealValuerlr= dealPricerr<rrornsellr0r/feeRate)rDrrater5 orderTypematchfundsrrG) rr)r|rrrr5 takerOrMakerrr=r<rDro) rrrrRrrSr%rz safe_traderY)r trader\r{r)r?rr priceString amountStringrro feeCostStringr}rnr5 costStringrG contractCosts r  parse_tradezkucoinfutures.parse_tradesX##E844!!(FC88   y$ 7 7""5)44''{;; %%eT22  )))g*=>>II))%==Iu$$9+@%, ((EE ))%BB v..((66  $ ,,UMBBM11-@@K"26&..fWoovf~ %'(( ::C !!%== 7??D''w@@  ++FNCCL"-k<HHL +L,GGJ" Y//X&( "    r c6|i}d}| ||}|d|d<|||d<|||d<||||}|dd}|||||dd iS) a fetch all deposits made to an account :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 :returns dict[]: a list of `transaction structures ` Nr)rpageSizerrr[r5r)rprfuturesPrivateGetDepositListrwparse_transactions r rrfrgrr}rrr`s r fetch_depositszkucoinfutures.fetch_deposits s   }}T**H"*4.GJ   "'GJ   !&GI 44T[[&5Q5QRR8 '0 &&|XuefV_M`aaar c6|i}d}| ||}|d|d<|||d<|||d<||||}|dd}|||||dd iS) a fetch all withdrawals made from an account :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 :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict[]: a list of `transaction structures ` Nr)rrrrr[r5 withdrawal)rprfuturesPrivateGetWithdrawalListrwrrs r fetch_withdrawalszkucoinfutures.fetch_withdrawals6 s   }}T**H"*4.GJ   "'GJ   !&GI 77 GV8T8TUU8 '0 &&|XuefVbMcdddr cP|||}|dst|jdzd|di}||||}||d}|||S)a retrieve information on the maximum leverage, and maintenance margin for trades of varying trade sizes for a single market :see: https://www.kucoin.com/docs/rest/futures-trading/risk-limit/get-futures-risk-limit-level :param str symbol: unified market symbol :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `leverage tiers structure ` r8z: fetchMarketLeverageTiers() supports contract markets onlyrr)r)rpr\rr)(futuresPublicGetContractsRiskLimitSymbolrwrparse_market_leverage_tiersrs r fetch_market_leverage_tiersz)kucoinfutures.fetch_market_leverage_tiersh s V$$j! eTW'ccdd d fTl @@WV\A]A]^^$x00//f===r c hg}tdt|D]}||}|||d|d||d||d||d||d|d|S) z * @ignore :param dict info: Exchange market response for 1 market :param dict market: CCXT market rrr/ minRiskLimit maxRiskLimitmaintainMarginr?)tierr minNotional maxNotionalmaintenanceMarginRater?r)rPrQrWrU)r rr\rr[rs r rz)kucoinfutures.parse_market_leverage_tiers s"q#d))$$  A7D LL((w77"6N#//nEE#//nEE)-)9)9$@P)Q)Q#//mDD     r c|t|jdz|||}|dd|d}||dd}||ddg}|||d<||d z|d <|||d <||d z |d <||||}| |d } | | |||S) a :see: https://www.kucoin.com/docs/rest/futures-trading/funding-fees/get-public-funding-history#request-url fetches historical funding rate prices :param str symbol: unified symbol of the market to fetch the funding rate history for :param int [since]: not used by kucuoinfutures :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.until]: end time in ms :returns dict[]: a list of `funding rate structures ` Nz5 fetchFundingRateHistory() requires a symbol argumentr)r)rrmrorWrXrmlPRWror) rr)rpr\rtr]r $futuresPublicGetContractFundingRatesrwrparse_funding_rate_histories) r rrfrgrr\r}rWrrs r fetch_funding_rate_historyz(kucoinfutures.fetch_funding_rate_history s/ >#DG.e$eff f V$$Tl##%%   ##FGV<<6GV#455  #GFO} %(@ @  !GDM} %(@ @ <` rr FNr)Tr\)r closeOrderrr5) rpr\rr r number_to_stringrrrwrr) r rrrr\rrr}rs r close_positionzkucoinfutures.close_position s V$$((AA NN66599 6FO#<==   11$**,,??MTl&      S88Wf9U9UVVHH44T[[&5Q5QRRH&111r )N)E__name__ __module__ __qualname__rrrr rbrestrrlistrrrr rrrrrrrrrrrrrrfloatr rr rr rBrIrrPrOrar rergrkrrrrrrrxrrrrrrrrrrrrrrr __classcell__)r s@r r'r's{ { { { { z #%    6$&\\$v,\\\\|!#3333 26DW[df2H2H#2Hc2HQT2Hkoptku2H2H2H2Hh   4    *79# # ## # # # J:>b//s/3/Y////b02 ; ;3 ;f ; ; ; ;D04BKHKHWKH7KHKHKHKHZhh6hVhhhhT37TX\eg@@C@s@RU@@@@D24;1;1S;1;1;1;1z26b9393w93939393v\ \ v\ \ \ \ |gksu....3..i..y..RW..`c........`@B,','D$6,',',','\x|EG<,<,C<,y<,PY<,ch<,qt<,<,<,<,|37r#1#1s#1C#1#1#1#1J/32111111B68G G G ">#">">">">H>8<$]ajl,M,M,MC,MWZ,M,M,M,M\   v     =A22S2 2PU22222222r r'N)+ ccxt.kucoinrccxt.abstract.kucoinfuturesrccxt.base.typesrrrrr r r r r rrrrrrrrrtypingrccxt.base.errorsrrrrrrrrr r!r"r#ccxt.base.decimal_to_precisionr$ccxt.base.preciser%r'r r rsi 333333MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM000000------------......''''''......))))))******))))))......111111))))))444444%%%%%%f'2f'2f'2f'2f'2FKf'2f'2f'2f'2f'2r