!:h ddlmZddlmZddlZddlmZmZmZm Z m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+ddl,m-Z-ddl.m/Z/ddl.m0Z0ddl.m1Z1dd l.m2Z2dd l.m3Z3dd l.m4Z4dd l.m5Z5dd l.m6Z6ddl.m7Z7ddl.m8Z8ddl.m9Z9ddl.m:Z:ddl.m;Z;ddl.mZ>ddl.m?Z?ddl.m@Z@ddl.mAZAddl.mBZBddl.mCZCddl.mDZDddl.mEZEddl.mFZFddlGmHZHddlImJZJGd d!eeZKy)")Exchange) ImplicitAPIN)&AccountAnyBalancesBorrowInterest ConversionCrossBorrowRateCrossBorrowRates CurrenciesCurrencyDepositAddressGreeksInt LedgerEntryLeverage LeverageTierLongShortRatioMarginModificationMarketNumOption OptionChainOrder OrderBook OrderRequestCancellationRequest OrderSide OrderTypePositionStrStringsTickerTickers FundingRateTradeTradingFeeInterface TransactionMarketInterface TransferEntry)List) ExchangeError)AuthenticationError)PermissionDenied)AccountNotEnabled)AccountSuspended)ArgumentsRequired) BadRequest) BadSymbol)OperationRejected)ManualInteractionNeeded)InsufficientFunds)InvalidAddress) InvalidOrder) OrderNotFound)ContractUnavailable) NotSupported) NetworkError)DDoSProtection)RateLimitExceeded)ExchangeNotAvailable) OnMaintenance) InvalidNonce)RequestTimeout) CancelPending) TICK_SIZE)Precisec D eZdZdeffd Zdidfdededeffd ZdZdefd Z dd e ded e d e de f fd Z ifdZ ifdefdZifdeefdZdZifdeefdZdedefdZifdZifdefdZdifdededefdZddededefdZifdedefdZdifdede fdZ!ifdedefdZ"difdede fdZ#ddedede$fd Z%ddifded!ededee$fd"Z&ddede'fd#Z(d$ddifded!ededee'fd%Z)dddifde d!edefd&Z*d'Z+d(Z,d)Z-dd*edede.fd+Z/ifdede.fd,Z0ifde1fd-Z2ifded.e3fd/Z4ifded.e3fd0Z5difded1e6d2e7d3e3d4e8f d5Z9difded1e6d2e7d3e3d4e8f d6Z:ifd7ee;fd8Zdifd9ede fd<Z?d=Z@difde fd>ZAifd7eeBfd?ZCifd@efdAZDdBe fdCZEddDededeFfdEZGdifd9ede fdFZHdddifde d!ededeeFfdGZIdddifde d!edefdHZJdddifde d!ededeeFfdIZKdddifde d!edefdJZLdddifd9ede d!edefdKZMdddifdLe d!ededeeNfdMZOdNZPddOedPeQdeNfdQZRddPeQdeSfdRZTifdLedeeSfdSZUifdLedeSfdTZVdifdLed3e3dUedeWfdVZXdddifdLe d!ededeeWfdWZYdifd9edLe fdXZZdddifdLe d!ededeeWfdYZ[difd9edLe fdZZ\dBe fd[Z]dd\edPeQdeWfd]Z^ifdede_fd^Z`dd_edede_fd`ZaifdefdaZbdifdedeecfdbZdifdefdcZedddedefdeZfifdLed3e3dfedgedegf dhZhddiedPeQdegfdjZidBe de fdkZjdifd9edLe degfdlZkdddifdLe d!ededeegfdmZldndoiddfdpZmddedenfdqZodrZpifdedenfdsZqifdedenfdtZrdddifde d!edefduZsdifd_ede fdvZtdifde fdwZudifdxevde fdyZwdifdzede fd{Zxifdeyfd|ZzifdLede{fd}Z|ddPeQfd~Z}dZ~dddifd!edefdZddifdLed!edefdZifdedefdZddededefdZifded3e3defdZifded3e3defdZifdedeefdZddedeefdZddddifdLe de d!ededeef dZddededefdZifdLed3e3fdZifdLefdZddPeQfdZifdefdZdddifded!edefdZddefdZdevffd ZdifdefdZddZdddifde d!edefdZdZdZifdZifdedefdZddededefdZdifded2e7deFfdZifdedefdZifdLedefdZddedPeQdedefdZdifdeded3e8defdZdifd9ededed3e8def dZdifd9edLe defdZdddifdLe d!ededeefdZddedeQdeQdefdZifdefdZdedededededef dZddddifde d1e d!e8de8deef dZdddifded!ededeecfdZddddifde de d!ededeef dZddededefdZxZS)okxreturnc-|jtt|idddddddgdd d d d d dd didddd dd dd dd dd dd dddd dd dd dd dddd dd d dd!d id"d d#d d$d d%d d&d d'd d(d d)d d*d d+d d,d d-d d.d d/d d0d d1d d2did3d d4d d5d d6d d7dd8d d9d d:d d;d dd d?d d@d dAd dBddCd idDd dEddFdGdHd dId dJd dKddLd dMd dNddOd dPd dQddRddSddTd dUdidVd dWddXddYd dZd d[d d\d d]d d^d d_d d`ddad dbd dcd ddd deddfd idgd dhd did djd dkddlddmd dnd dodGdpd dqd drd dsddtddud dvd dwd idxd dyd dzd d{d d|dd}dd~ddddddd dd dd dddd dd dddd d d d dd d dd d d ddddddddddddddddddddddiddddddddidddiddddddddddddddddddddddddddddddddddiddddddddddddddddddddddddddddddddddiddddddddddddddddړddړddړddړddړddړddړddړddړddړiddړddړddddddddddddddddddddddddddddddddddddddddddd iiddړddړddړddddddړddړddddddddddddddddddd did d d dd dddddddddddddddddddddddddddddiddddddd dd!dd"dd#dd$dd%dd&dd'dd(dd)dd*d+d,dd-dd.did/dd0dړd1dd2dd3dd4dړd5dd6dړd7dړd8dړd9dd:dd;dړddړd?dړid@dړdAdړdBddCddDdړdEdړdFddGddHddIdړdJdړdKddLddMddNddOddPdidQddRddSdړdTddUddVddWddXddYddddZdd[dd\dd]dd^dd_dd`didaddbddcdddddeddfddgddhddiddjddkddldmdnddoddpddqddrdړidsdړdtdړdudړdvdړdwdړdxdړdydړdzdd{dd|dd}dd~dړddړdd+dddddddddddڐdiddړddړddddddddړddړdd+ddddddddddddddddddiddddddddddddddd dd dddddddddddddddړddiddddddddddddddd&dddړddddddړddړddړddddddiddddړddړddړddړdDd+ddddddddd/dddddddddddړddiddddddddddddddddddddddddddddddddddiddddddddddddddddddddddmddmddmddddddddiddddddړddړddړddړddړddddd|dddddddړddړddd}dddddddddddd|j d|j dd|j d|j dd|j d|j dd|j d|j ddddd d d ddidt d t d t d td td tdtdtdtdtdtdtdt dtdt dtdtidt dt dt dt dt dt dt d t d!t d"td#t d$td%td&t d'td(t d)t id*t d+td,td-td.td/td0td1td2t d3t d4td5td6td7td8td9td:tid;t dt"d?t"d@t"dAt"dBt$dCtdDt&dEt"dFt dGt dHt dIt"dJt dKt idLt dMt"dNt(dOt(dPt dQtdRt dSt dTt(dUt(dVt(dWt(dXt"dYt"dZt"d[t"d\t"id]t"d^t"d_t"d`t"dat"dbt"dct"ddt"det"dft"dgt"dht"dit"djt"dkt"dlt"dmt"idnt"dot"dpt"dqt"drtdst"dttdut"dvt"dwt"dxt"dyt$dzt"d{t"d|t"d}t"d~t"idt"dt$dt"dt"dt dt$dt"dt"dt"dt"dt"dt"dt"dt"dtdtdt"idt"dt"dt"dt"dt"dt"dt"dt"dt"dt"dt"dt"dt"dt"dt"dt"dt"idt"dt"dt"dt"dt"dt"dt"dt"dt"dt"dt"dt"dt"dt"dt"dt"dt"idt"dt"dt"dt"dt"dt"dt"dtdtdt"dt"dt"dt"dt"dt*dt*dt*idt"dt"dt dt dtdt dt dt,dt dt dt$dt dt dt dt dt dt idt dt dt dt*dtdtdtdt dt$dt dt dt dt"dt"dt"dt"dt"idt"dt"dt"dt"dt"dt"dt dtdtdt dtdt dt dt dt dtdtidt dt dt dt dt dt dt dt dt dt dt dt dt dt dtdtdtidtdt d t d t d t.d td t dt dt.dt dt dt dt dt dtdtdtidtdtdtdt$dt dt$dt dt d t d!t d"t d#t$d$t d%t d&t d't d(t$id)t d*t"d+t$d,t$d-td.td/td0t d1t d2t d3t d4t0d5t$d6t0d7t0d8td9t id:t d;t dt d?t d@t dAtdBt dCt dDt dEt dFt dGtdHt dItdJtidKtdLtdMtdNtdOtdPtdQtdRtdStdTtdUtdVtdWt2dXtdYtdZtd[tid\t d]t&d^td_t4d`tdat dbtdct6ddt8det&dft&dgtdhtdit djtdktdltidmt&dntdotdptdqtdrtdstdttdutdvtdwtdxtdytdztd{td|t2d}ttttd~ttddddtidt:iddddddddddiddddddddddddddddddddddddddddddddddidddddddddddddddddddddddddddddd“dÐdÓdĐdēidŐdƓdǐdȓdɐdʓdːd̓d͐dΓdϐdГdѐdғdӐdӓdԐdՓd֐dדdؐdٓdڐdۓdܐdݓdސdߓddddddidddddddddddddddddddddddddddddddddddddddddddddddddd idbd d idpd d id#dddd\gddddddddTd didid didfd didd did did didddd d d d d d dddddddddddd d!d"d#d$d%d%d&d"d#d$d%d&d' d(d)d d d d d d d*dd d d d d d*d d+d d d dd,d d d dd d dd-d.didd/d+d0dd1dd d d d2dd+d d dd3ddd+d/d4dd d dd5dd+d6d7 d8d9id8d9id8d9id:d8d9id8d9id:d;d<d=d>d?S(@NidrGnameOKX countriesCNUSversionv5 rateLimitgY@proT certifiedhasCORSspotmarginswapfutureoption addMargincancelAllOrdersFcancelAllOrdersAfter cancelOrder cancelOrderscancelOrdersForSymbolscloseAllPositions closePositioncreateConvertTradecreateDepositAddresscreateMarketBuyOrderWithCostcreateMarketSellOrderWithCost createOrder createOrders$createOrderWithTakeProfitAndStopLosscreatePostOnlyOrdercreateReduceOnlyOrdercreateStopLimitOrdercreateStopLossOrdercreateStopMarketOrdercreateStopOrdercreateTakeProfitOrdercreateTrailingPercentOrdercreateTriggerOrder editOrder fetchAccounts fetchBalance fetchBidsAsksfetchBorrowInterestfetchBorrowRateHistoriesfetchBorrowRateHistoryfetchCanceledOrdersfetchClosedOrderfetchClosedOrdersfetchConvertCurrenciesfetchConvertQuotefetchConvertTradefetchConvertTradeHistoryfetchCrossBorrowRatefetchCrossBorrowRatesfetchCurrencies fetchDepositfetchDepositAddressfetchDepositAddressesfetchDepositAddressesByNetwork fetchDepositsfetchDepositsWithdrawalsfetchDepositWithdrawFeeemulatedfetchDepositWithdrawFeesfetchFundingHistoryfetchFundingIntervalfetchFundingIntervalsfetchFundingRatefetchFundingRateHistoryfetchFundingRates fetchGreeksfetchIndexOHLCVfetchIsolatedBorrowRatefetchIsolatedBorrowRatesfetchL3OrderBook fetchLedgerfetchLedgerEntry fetchLeveragefetchLeverageTiersfetchLongShortRatiofetchLongShortRatioHistoryfetchMarginAdjustmentHistoryfetchMarketLeverageTiers fetchMarketsfetchMarkOHLCVfetchMarkPricefetchMarkPricesfetchMySettlementHistory fetchMyTrades fetchOHLCVfetchOpenInterestfetchOpenInterestHistoryfetchOpenOrderfetchOpenOrders fetchOptionfetchOptionChain fetchOrderfetchOrderBookfetchOrderBooks fetchOrdersfetchOrderTrades fetchPositionfetchPositionHistoryfetchPositionsfetchPositionsForSymbolfetchPositionsHistoryfetchPositionsRiskfetchPremiumIndexOHLCVfetchSettlementHistory fetchStatus fetchTicker fetchTickers fetchTime fetchTradesfetchTradingFeefetchTradingFeesfetchTradingLimitsfetchTransactionFeefetchTransactionFeesfetchTransactions fetchTransferfetchTransfersfetchUnderlyingAssetsfetchVolatilityHistoryfetchWithdrawalfetchWithdrawalsfetchWithdrawalWhitelist reduceMargin) repayCrossMarginsandbox setLeverage setMargin setMarginModesetPositionModesignIntransferwithdraw timeframes1m3m5m15m30m1H2H4H6H12H1D1W1M3M)rrrrr1h2h4h6h12h1d1wrrhostnamez www.okx.comurlszdhttps://user-images.githubusercontent.com/1294454/152485636-38b19e4a-bece-4dec-979a-5982859ffc04.jpgrestzhttps://{hostname}zhttps://www.okx.comzhttps://www.okx.com/docs-v5/en/z,https://www.okx.com/pages/products/fees.htmlz!https://www.okx.com/join/CCXT2023g?)urldiscount)logoapiwwwdocfeesreferraltestrgetzmarket/books-fullzmarket/tickersz market/tickerzmarket/index-tickersz market/booksg?zmarket/books-liteg?zmarket/candleszmarket/history-candleszmarket/index-candleszmarket/history-index-candleszmarket/mark-price-candlesz!market/history-mark-price-candlesz market/tradeszmarket/history-tradesz&market/option/instrument-family-tradeszmarket/platform-24-volume zmarket/open-oracle2zmarket/exchange-ratezmarket/index-componentszpublic/economic-calendarzmarket/block-tickerszmarket/block-tickerzpublic/block-tradeszpublic/instrumentsz public/delivery-exercise-historyzpublic/open-interestzpublic/funding-ratezpublic/funding-rate-historyzpublic/price-limitzpublic/opt-summaryzpublic/estimated-pricez(public/discount-rate-interest-free-quotaz public/timezpublic/mark-pricezpublic/position-tierszpublic/interest-rate-loan-quotaz#public/vip-interest-rate-loan-quotazpublic/underlyingzpublic/insurance-fundzpublic/convert-contract-coinzpublic/option-tradeszpublic/instrument-tick-bandsz$rubik/stat/trading-data/support-coinzrubik/stat/taker-volumezrubik/stat/margin/loan-ratioz-rubik/stat/contracts/long-short-account-ratioz6rubik/stat/contracts/long-short-account-ratio-contractz)rubik/stat/contracts/open-interest-volumez&rubik/stat/option/open-interest-volumez,rubik/stat/option/open-interest-volume-ratioz-rubik/stat/option/open-interest-volume-expiryz-rubik/stat/option/open-interest-volume-strikez$rubik/stat/option/taker-block-volumez system/statusz sprd/spreadsz sprd/booksz sprd/tickerzsprd/public-tradeszmarket/sprd-tickerzmarket/sprd-candleszmarket/sprd-history-candlesztradingBot/grid/ai-paramztradingBot/grid/min-investmentz"tradingBot/public/rsi-back-testingzasset/exchange-listz$finance/staking-defi/eth/apy-historyz$finance/staking-defi/sol/apy-historyz$finance/savings/lending-rate-summaryg @gUUUUUU?) z$finance/savings/lending-rate-historyz!finance/fixed-loan/lending-offersz&finance/fixed-loan/lending-apy-historyz)finance/fixed-loan/pending-lending-volumezfinance/sfp/dcd/productszcopytrading/public-lead-traderszcopytrading/public-weekly-pnlzcopytrading/public-statsz©trading/public-preference-currencyz'copytrading/public-current-subpositionsz'copytrading/public-subpositions-historyzsupport/announcements-typeszrfq/counterpartieszrfq/maker-instrument-settingszrfq/mmp-configzrfq/rfqsz rfq/quotesz rfq/tradeszrfq/public-tradesz sprd/ordergUUUUUU?zsprd/orders-pendingzsprd/orders-historyzsprd/orders-history-archivez sprd/trades trade/orderztrade/orders-pendingztrade/orders-historyztrade/orders-history-archivez trade/fillsztrade/fills-historyg@ztrade/fills-archivetrade/order-algoztrade/orders-algo-pendingztrade/orders-algo-historyz trade/easy-convert-currency-listztrade/easy-convert-historyz#trade/one-click-repay-currency-listz&trade/one-click-repay-currency-list-v2ztrade/one-click-repay-historyz trade/one-click-repay-history-v2ztrade/account-rate-limitzasset/currencieszasset/balanceszasset/non-tradable-assetszasset/asset-valuationzasset/transfer-statez asset/billszasset/deposit-lightningzasset/deposit-addresszasset/deposit-historyzasset/withdrawal-historyzasset/deposit-withdraw-statuszasset/convert/currencieszasset/convert/currency-pairzasset/convert/historyzasset/monthly-statementzaccount/instrumentszaccount/balancezaccount/positionszaccount/positions-historydzaccount/account-position-riskz account/billszaccount/bills-archivezaccount/bills-history-archivezaccount/configzaccount/max-sizezaccount/max-avail-sizezaccount/leverage-infozaccount/adjust-leverage-infozaccount/max-loanzaccount/trade-feezaccount/interest-accruedzaccount/interest-ratezaccount/max-withdrawalzaccount/risk-statez)account/quick-margin-borrow-repay-historyzaccount/borrow-repay-historyzaccount/vip-interest-accruedzaccount/vip-interest-deductedzaccount/vip-loan-order-listzaccount/vip-loan-order-detailzaccount/interest-limitszaccount/greekszaccount/position-tierszaccount/mmp-configz"account/fixed-loan/borrowing-limitz"account/fixed-loan/borrowing-quotez(account/fixed-loan/borrowing-orders-listz account/spot-manual-borrow-repayzaccount/set-auto-repayz!account/spot-borrow-repay-historyzaccount/move-positions-historyzusers/subaccount/listzaccount/subaccount/balanceszasset/subaccount/balancesz!account/subaccount/max-withdrawalzasset/subaccount/billsz)asset/subaccount/managed-subaccount-billszusers/entrust-subaccount-listz"account/subaccount/interest-limitszusers/subaccount/apikeyz#tradingBot/grid/orders-algo-pendingz#tradingBot/grid/orders-algo-historyz#tradingBot/grid/orders-algo-detailsztradingBot/grid/sub-ordersztradingBot/grid/positionsztradingBot/signal/signalsz%tradingBot/signal/orders-algo-detailsz%tradingBot/signal/orders-algo-historyztradingBot/signal/positionsz#tradingBot/signal/positions-historyztradingBot/signal/sub-ordersztradingBot/signal/event-historyz(tradingBot/recurring/orders-algo-pendingz(tradingBot/recurring/orders-algo-historyz(tradingBot/recurring/orders-algo-detailsztradingBot/recurring/sub-orderszfinance/savings/balancezfinance/savings/lending-historyzfinance/staking-defi/offersz"finance/staking-defi/orders-activez#finance/staking-defi/orders-historyz finance/staking-defi/eth/balancez0finance/staking-defi/eth/purchase-redeem-historyz%finance/staking-defi/eth/product-infoz finance/staking-defi/sol/balancez0finance/staking-defi/sol/purchase-redeem-historyz copytrading/current-subpositionsz copytrading/subpositions-historyzcopytrading/instrumentsz"copytrading/profit-sharing-detailsz copytrading/total-profit-sharingz-copytrading/unrealized-profit-sharing-detailszcopytrading/copy-settingszcopytrading/batch-leverage-infoz copytrading/current-lead-tradersz copytrading/lead-traders-historyzbroker/nd/infozbroker/nd/subaccount-infozbroker/nd/subaccount/apikeyz*asset/broker/nd/subaccount-deposit-addressz*asset/broker/nd/subaccount-deposit-historyz-asset/broker/nd/subaccount-withdrawal-historyzbroker/nd/rebate-dailybroker/nd/rebate-per-orders,finance/sfp/dcd/orderzfinance/sfp/dcd/orders)broker/fd/rebate-per-orderszbroker/fd/if-rebatezaffiliate/invitee/detailzusers/partner/if-rebatezsupport/announcementszrfq/create-rfqzrfq/cancel-rfqzrfq/cancel-batch-rfqszrfq/cancel-all-rfqszrfq/execute-quotez rfq/mmp-resetzrfq/create-quoteg?zrfq/cancel-quotezrfq/cancel-batch-quoteszrfq/cancel-all-quoteszsprd/cancel-orderzsprd/mass-cancelzsprd/amend-orderzsprd/cancel-all-aftertrade/batch-ordersg?ztrade/cancel-orderztrade/cancel-batch-ordersztrade/amend-orderztrade/amend-batch-ordersgO贁N{?ztrade/close-positioniztrade/cancel-algosztrade/amend-algosztrade/cancel-advance-algosztrade/easy-convertztrade/one-click-repayztrade/one-click-repay-v2ztrade/mass-cancelztrade/cancel-all-afterzasset/transferzasset/withdrawalzasset/withdrawal-lightningzasset/cancel-withdrawalzasset/convert-dust-assetszasset/convert/estimate-quotezasset/convert/tradezaccount/set-position-modezaccount/set-leveragezaccount/position/margin-balancezaccount/set-greekszaccount/set-isolated-modez!account/quick-margin-borrow-repayzaccount/borrow-repayzaccount/simulated_marginzaccount/position-builderzaccount/set-riskOffset-typezaccount/activate-optionzaccount/set-auto-loanzaccount/set-account-levelzaccount/mmp-resetz"account/fixed-loan/borrowing-orderz(account/fixed-loan/amend-borrowing-orderz"account/fixed-loan/manual-reborrowz(account/fixed-loan/repay-borrowing-orderi@zaccount/move-positionszusers/subaccount/modify-apikeyzasset/subaccount/transferz!users/subaccount/set-transfer-outz&account/subaccount/set-loan-allocationz"users/subaccount/create-subaccountz"users/subaccount/subaccount-apikeyzusers/subaccount/delete-apikeyztradingBot/grid/order-algoz tradingBot/grid/amend-order-algoztradingBot/grid/stop-order-algoztradingBot/grid/close-positionz"tradingBot/grid/cancel-close-orderz%tradingBot/grid/order-instant-triggerztradingBot/grid/withdraw-incomez&tradingBot/grid/compute-margin-balanceztradingBot/grid/margin-balancez!tradingBot/grid/adjust-investmentztradingBot/signal/create-signalztradingBot/signal/order-algoz!tradingBot/signal/stop-order-algoz tradingBot/signal/margin-balanceztradingBot/signal/amendTPSLz!tradingBot/signal/set-instrumentsz tradingBot/signal/close-positionztradingBot/signal/sub-orderz"tradingBot/signal/cancel-sub-orderztradingBot/recurring/order-algoz%tradingBot/recurring/amend-order-algoz$tradingBot/recurring/stop-order-algoz finance/savings/purchase-redemptz finance/savings/set-lending-ratezfinance/staking-defi/purchasezfinance/staking-defi/redeemzfinance/staking-defi/cancelz!finance/staking-defi/eth/purchasezfinance/staking-defi/eth/redeemz!finance/staking-defi/sol/purchasezfinance/staking-defi/sol/redeemzcopytrading/algo-orderzcopytrading/close-subpositionzcopytrading/set-instrumentszcopytrading/first-copy-settingszcopytrading/amend-copy-settingszcopytrading/stop-copy-tradingzcopytrading/batch-set-leveragezbroker/nd/create-subaccountg?zbroker/nd/delete-subaccountz"broker/nd/subaccount/modify-apikeyz"broker/nd/subaccount/delete-apikeyzbroker/nd/set-subaccount-levelz!broker/nd/set-subaccount-fee-ratezbroker/nd/set-subaccount-assetsz1asset/broker/nd/modify-subaccount-deposit-addressi)rzfinance/sfp/dcd/quoterzbroker/nd/report-subaccount-ipr)rpost)publicprivaterz0.0015z0.0010)takermakerz0.0005z0.0002z0.00050z0.00020)tradingrWrZrYrequiredCredentials)apiKeysecretpassword exceptions1240885000050001500025000450005500065000750008500095001050011500125001350014500155001650017500185001950020500215002250023500245002550026500275002850044500615006250100501015010250103501045010550106501075010850109501105011150112501135011450115510005100151002510035100451005510065100751008510095101051011510125101451015510165101751018510195102051021510225102351024510255102651027510285102951030510315104651047510725107351074510905109151092510935109451095510965109851099511005110151102511035110451105511065110751108511095111051111511125111351115511165111751118511195112051121511225112451125511265112751128511295113051131511325113351134511355113651137511385113951156511595116251163511665117451185512015120251203512045120551250512515125251253512545125551256512575125851259512605126151262512635126451265512675126851269512705127151272512735127451275512765127751278512795128051321513225132351324513255132751328513295133051400514015140251403514045140551406514075140851409514105150051501515025150351506515085150951510515115160051601516025160351732517335173451735517365200054000540015400854009540115510055101551025510355104551115511255113580005800158002580035800458005580065800758100581015810258103581045810558106581075810858109581105811158112581145811558116581175812558126581275812858200582015820258203582045820558206582075820858209582105821158212582135822158222582245822758228582295830058350590005900159100591015910259103591045910559106591075910859109591285920059201592165926059262593005930159313594015941059411594125941359414595005950159502595035950459505595065950759508595155951659517595185951959642596436000160002600036000460005600066000760008600096001060011600126001360014600156001660017600186001960020600216002260023600246002560026600276002860029600306003160032639996400064001640026400370010700137001670060700617006270064700657006670067100940014002400340044005)400640074008)zInternal Server Errorz server error)exactbroadhttpExceptions429 precisionMode sandboxModedefaultNetworkERC20defaultNetworksBTCTRC20)ETHrUSDTnetworksBitcoinBTCLN Lightning BTCLIGHTNINGBEP20BSCBRC20CRC20CryptoACAAcalaALGOAlgorandAPTAptosSCROLLScrollARBONEz Arbitrum OneAVAXCzAvalanche C-ChainAVAXXzAvalanche X-ChainBASEBaseSUI ZKSYNCERAz zkSync EraLINEALineaARArweaveASTRAstarBCH BitcoinCashBSVz Bitcoin SVADACardanoCSPRCasperCELOXCHChiaATOMCosmosDGBDigibyteDOGEDogecoinEGLDElrondCFXConfluxEOSCOREETCzEthereum ClassicETHW EthereumPowFILFilecoinONEHarmonyHBARHederaICXICONICPDfinityIOSTIOTAMIOTAKLAYKlaytnKSMKusamaLSKLiskLTCLitecoinMETISMetisMINAMinaGLRMMoonbeamMOVR MoonriverNANONanoNEARNULSOASYSONTOntologyOPTIMISMOptimismLATPlatONDOTPolkadotMATICPolygonRVN RavencoinXRPRippleSCSiacoinSOLSolanaSTXzl-StacksXLMzStellar LumensXTZTezosTONThetaWaxZilliqa)THETAWAXZIL8H)rr8hr5MrrrtimezoneUTCmethodprivateGetAccountPositionsprivatePostTradeBatchOrders!createMarketBuyOrderRequiresPrice)rWrZrYr[timeDifferenceradjustForTimeDifference defaultTypeprivateGetAccountBillsprivateGetTradeOrderprivateGetTradeOrdersPending!privatePostTradeCancelBatchOrdersprivateGetTradeOrdersHistory)rpwd) conditionaltriggerocomove_order_stopicebergtwap618)fundingrrWrZfuturesrXrYr[r-r)r+r,SPOTMARGINSWAPFUTURESOPTION) rWrXrYrZr.r[r/r0r1r2r3e847386590ce4dBC)r{r}ralgoOrderTypesaccountsByType accountsById exchangeTypebrokerId)lastmarkindex)triggerPriceTypeprice)IOCFOKPOGTD) marginMode triggerPricer=triggerDirection stopLossPricetakeProfitPriceattachedStopLossTakeProfit timeInForcehedgedtrailingr)leverageselfTradePreventionmarketBuyByCostmarketBuyRequiresPricemaxZi')rCdaysBacklimit untilDayssymbolRequired)rCr&rKrU)rCrSr&rKrUgUUUUUU?)rCrSrRdaysBackCanceledrTr&rKrU)rS historical) rrhrirrrrr}rextendsdefault)linearinverse)rYrWrYrZAETWINTOKEN)AEWIN)optionsfeaturescommonCurrencies) deep_extendsuperrGdescribe parse_numberr,r5r2r@rBr?r0r-r>r.rAr3r8r6r/r:r9rCr7r4r<r=r1r;rD)self __class__s B/var/www/html/turnos/venv/lib/python3.12/site-packages/ccxt/okx.pyrez okx.describe)s>9c4 9 ;T> %T> ET>  $T>  t T>  T> 4 T>  T>  AAA$A A $ A $ ATA"5A'AtAA)$A$UA A%dA '!A"/#A$0%A&t'A()A*7+A,&t-A.(/A0'1A2&t3A4(5A6"47A8(9A:-d;A<%d=A>T?A@ AABCAD EAF&tGAH+DIAJ)$KAL&tMAN#DOAP$TQAR)$SAT$TUAV$TWAX+DYAZ'[A\(]A^"4_A`aAb&tcAd(eAf1$gAh iAj+EkAl*:mAn+DoAp&tqAr'sAt(uAv#DwAx*4yAz$U{A|t}A~"4A@*5AAB+ECAD#EEAFtGAH#DIAJ KAL%eMAN&uOAP-dQAR/SAT+DUAVWAX!$YAZ!$[A\"4]A^+E_A` aAbdcAd$TeAf+DgAh!$iAj"4kAltmAn#DoApdqAr!$sAt"5uAvuwAx#DyAz {A|' }A~!$A@*4AAB(CAD%eEAF)%GAH)$IAJtKALtMANOAPTQARtSAT"4UAV#EWAX%eYAZ&u[A\']A^$U_A` aAb!$cAd(eAf)%gAh"4iAj#DkAl+EmAnoAp%)#"!%#'  AAT> T UT> t  uT> v ~0-8F? # 0wT> Z V+QV(!V(V/ V ' V ,U V)%V1!V/V7V4QV1!?V@CBAVB&qCVD,QEVF0GVH:2IVJ>rKVL,QMVN0OVP7QVR/SVT7UVV?WVX21YVZ7[V^H_V`QRSaVbDQcVdA!eVhGiVjHkVlHmVn?oVp(qVt'uVv%ewVx&qyVz-e{V|-a}V~.qV@6qAVB3ACVD9!EVF=aGVH.uIVJ?KVL?MVN?OVPAF=CBHEK49;<9:45BCCDCD79kVXtZ,aZ8Z)! Z #B Z %b Z%aZ,QZ%eZ.uZ.uZ6uZ&uZ &u!Z"/#Z$/%Z&7'Z(&u)Z*.s+Z,.q-Z.+A/Z04Q1Z24Q3Z4;B5Z65b7Z8>r9Z:A";Z<8=Z>;B?Z@3AAZD+EEZF)%GZH4UIZJ0KZL/MZN&uOZP21QZR0SZT0UZV3EWZX8YZZ3E[Z\6u]Z^0_Z`21aZd.qeZf*1gZh,QiZj4SkZl8mZn(oZp0qZr8sZt)!uZv+AwZx1!yZz0{Z|7}Z~+AZ@,QAZB3ACZD0EZF1!GZH-aIZJDQKZL7MZN7OZP8QZR6qSZT8UZV21WZX)!YZZ1![Z\-a]Z^=a_Z`=aaZbCAcZd;BeZf1!gZhqCZD>qEZF>qGZH5aIZJ4QKZL3AMZN4QOZP@QZR@SZT6qUZV>qWZX7YZZ:1[Z\CA]Z^CA_Z`CAaZb:1cZf25gZh:5iZj6vkZl=fmZn>voZr;EsZtKEuZv@wZx;EyZzKE{Z~;AZ@;AAZB21CZD=aEZF;AGZHHIZJ4QKZL:1MZN;AOZP;AQZT)"UZV4RWZX6rYZZEe[Z\Ea]Z^H_Z`1#aZb6scZd0eZf1!gZh8;/0453412sZvH(!H)!H0 H .r H ,R H8H(H)#H+CH+CH22H0H%aH ,Q!H"+A#H$+A%H&0'H*&u+H,-f-H.-e/H04V1H2,U3H43G5H6/7H8.v9H:+A;H<-a=H>,Q?H@5aAHB-bCHD0EHF3BGHH,QIHJ1"KHN)"OHP+EQHR5aSHT25UHV4RWHX7YHZ.q[H\21]H`4QaHb/cHd:1eHf-agHh4QiHj7 \ !..x8!..x8 "..x8!..x8 "..x8!..x8 "..y9!..y9]T> @ " $AT> J DD D 3 D Z D]DZD^D1DZD-D0D-D]D .!D"]#D$1%D&Z'D(])D*]+D,]-D.]/D0]1D2]3D4]5D6]7D8]9D:Z;D<]=D>1?D@-ADB]CDDZEDF]GDH]IDL]MDN0ODP\QDR0SDT0UDV0WDX0YDZ0[D\]]D^]_D`-aDb0cDd0eDf0gDh0iDjZkDnZoDpYqDrYsDtZuDv\wDx\yDz\{D|\}D~.D@-ADB.CDD\EDFYGDHYIDJYKDL\MDN]ODP]QDR]SDT\UDV0WDX0YDZ][D\-]D^]_D`YaDb0cDd0eDf0gDh0iDj\kDl\mDn\oDp\qDr\sDt\uDv\wDx\yDz\{D|\}D~\D@\ADB\CDD\EDF\GDH\IDJ\KDL\MDN\ODP\QDR\SDT\UDV\WDX\YDZ\[D\\]D^Z_D`\aDb.cDd\eDf\gDh\iDj\kDl.mDn\oDp\qDr\sDt\uDv\wDx\yDz.{D|\}D~\D@YADB.CDD\EDF\GDH\IDJ\KDL\MDN\ODP\QDR\SDTZUDVZWDX\YDZ\[D\\]D^\_D`\aDb\cDd\eDf\gDh\iDj\kDl\mDn\oDp\qDr\sDt\uDv\wDx\yDz\{D|\}D~\D@\ADB\CDD\EDF\GDH\IDJ\KDL\MDN\ODP\QDR\SDT\UDV\WDX\YDZ\[D\\]D^\_D`\aDb\cDd\eDf\gDh\iDj\kDlZmDnZoDp\qDr\sDt\uDv\wDx\yDz]{D|]}D~]D@\ADB\CDD]EDF]GDHZIDJ]KDL]MDN]ODP]QDR]SDT.UDV]WDX]YDZ][D\]]D^]_D`]aDb]cDd]eDf]gDh]iDj0kDl0mDn0oDp]qDr.sDv]wDz]{D|]}D~\D@\ADB\CDF\GDH\IDJ\KDL\MDN\ODP\QDR\SDT\UDX]YDZ0[D\-]D^]_D`-aDb]cDd]eDf]gDh]iDj-kDl.mDn]oDp]qDr]sDt]uDv]wDx]yDz]{D|]}D~]D@]ADB]CDD]EDF]GDH]IDJZKDLZMDNZODPZQDR]SDT]UDV]WDX^YDZ-[D\]]D^]_D`^aDb]cDd]eDf]gDh]iDj]kDl0mDnZoDpZqDrZsDtZuDvZwDx.yDz]{D|.}D@ ]A DB ]C DD ]E DF ]G DH ]I DJ .K DL ]M DN ]O DP ]Q DR ]S DT .U DV ]W DX \Y DZ .[ D\ .] D^ Z_ D` -a Db -c Dd ]e Df ]g Dh ]i Dj ]k Dl .m Dn .o Dp .q Dr .s Dt Zu Dv ]w Dx ]y Dz ]{ D| ]} D~ ] D@ ]A DB ]C DD ]E DF -G DH ]I DJ ]K DL ]M DN ]O DP ]Q DR ZS DT ]U DX 0Y DZ 0[ D\ 0] D^ 0_ D` 0a Db \c Dd 0e Df 0g Dh 0i Dj 0k Dl 0m Dn Zo Dp Zq Dr .s Dt \u Dv 1w Dx Zy Dz Z{ D| Z} D~ ] D@ .A DB 0C DD ^E DF 0G DH ]I DJ 0K DL .M DN \O DP .Q DR .S DT 0U DV 0W DX ]Y DZ Z[ D\ Z] D^ Z_ D` .a Db Zc Dd Ze Df Zg Dh Zi Dj Zk Dl Zm Dn Zo Dp Zq Dr Zs Dt Zu Dv Jw Dx /y Dz J{ D| -} D~ L D@ 0A DB '/-G DL .B$8M JKT> ` +aT> f YgT> h[u[ '["" #$[y9y[y#KyU y W y W yWyXy7yJy7yhyny0y0y F!y"5#y$ %y&W'y())y*G+y,=-y.J?y@HAyB9CyD5EyFFGyH-IyJMKyN:OyP9QyRHSyT6UyV9WyXFYyZG[y\H]y^8_y`6ayb:cydWeyfFgyhJiyjKkylFmynFoypFqyrWsyt:uyv wyz8{y|:}y~Yy@;AyB8CyD)EyF8GyH:IyJ+KyL7MyN5OyP% $Uy[D+ """""""" # -E[\][d!:#e[j T T N methodNamemarketc|j|d}|j|d}|j|d}||||d<tt|||||S)NinstTypetype) safe_stringomitrdrGhandle_market_type_and_params)rgrkrlparams defaultValuernrorhs rirrz!okx.handle_market_type_and_params@sd##FJ76:./ Lx3%F6NS$=j&RXZfggrjcb|j|jdi}|j|||S)Nr8) safe_dictr`rp)rgro exchangeTypess riconvert_to_instrument_typezokx.convert_to_instrument_typeHs-t||^RH  tT::rjsymbolc d}|jd}|jd}d}|jddkDr|j|d}n|j|d}|}|j|d}|j|d}|j|d} |j|} |j | } id |dz|zdz|zdz|zdz| zd |dz|zd z|zdz|zdz|zdz| zd |d |d|d|d|d|ddddddddddddddddddd|j d| | | dk(rdnd |j |ddd!ddd"ddd"ddd"d#dd$ S)%NUSD-/rrrrrJry:basequotesettlebaseIdquoteIdsettleIdactiveFror[rZr[rWrYrZTrXrCcallputamountr>minrP)rr>cost) contract contractSizeexpiryexpiryDatetime optionTypestrike precisionlimitsinfo)splitfindrpconvert_expire_date parse8601rf) rgryr optionParts symbolBaserrrrrdatetime timestamps ricreate_expired_option_marketz okx.create_expired_option_marketLsWll3' \\#&  ;;s b ##J2D##K3D!!+q1!!+q1%%k15 ++F3NN8, + $*u$s*V3c9FBSH:U+ dSj5(3.7#=FLvUX[[^hh+  D+  U + f + d +  u+  +  e+  H+  d+  t+  E+  E+  e+ d!+ " e#+ $ --c2&%/3%6&U''/       U+ + rjmarketId delimiter marketTypec|duxr*|jddkDxs|jddkD}|r||jvr|j|Stt|||||S)Nz-Cr~z-P)r markets_by_idrrdrG safe_market)rgrrlrrisOptionrhs rirzokx.safe_marketsnD(h d0Cb0H/ghmm\`NadfNf X););;44X> >S$+HfiTTrjc|j|}|j|dg}t|}d|dk(rdnddd|d}tdt|D]o}||}|j |d}|j |d|d <|j |d |d <|d k(rd|d <O|dk(rd|d <Z|dk(rd|d <e|dk(skd|d <q|S)aK the latest known information on the availability of the exchange API https://www.okx.com/docs-v5/en/#status-get-status :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `status structure ` dataNrok maintenance)updatedstatusetarrstateendrhrefrongoingr scheduled completedcanceled)publicGetSystemStatus safe_listlenrangerp safe_integer) rgrsresponser dataLengthupdateieventrs ri fetch_statuszokx.fetch_statuss--f5*~~h3Y )Qd]  q#d)$ (AGE$$UG4E --eU;F5M ,,UF;F5M !#0x +%#'x +%#'x *$#'x  ( rjc|j|}|j|dg}|j|di}|j|dS)aa fetches the current integer timestamp in milliseconds from the exchange server https://www.okx.com/docs-v5/en/#public-data-rest-api-get-system-time :param dict [params]: extra parameters specific to the exchange API endpoint :returns int: the current integer timestamp in milliseconds from the exchange server rrts)publicGetPublicTimerrvr)rgrsrrfirsts ri fetch_timezokx.fetch_timesM++F3~~h3tQ+  --rjc |j|}|j|dg}g}tdt|D]B}||}|j |d}|j |d}|j ||d|ddD|S)a| fetch all the accounts associated with a profile https://www.okx.com/docs-v5/en/#trading-account-rest-api-get-account-configuration :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a dictionary of `account structures ` indexed by the account type rruidacctLvN)rJrocurrencyrcode)privateGetAccountConfigrrrrpappend) rgrsrrresultraccount accountIdros rifetch_accountszokx.fetch_accountss//7(~~h3q#d)$ A1gG((%8I##GX6D MM     rjcB|j|jdz S)Nr) millisecondsr`)rgs rinoncez okx.nonce s   "T\\2B%CCCrjcd|jdr|j|j|jdg}g}g}tdt |D]&}|j |j |||(|}tdt |D]}|j|||}|S)a! retrieves data on all markets for okx https://www.okx.com/docs-v5/en/#rest-api-public-data-get-instruments :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict[]: an array of objects representing market data rrr)r`load_time_differencerrrrfetch_markets_by_type array_concat)rgrstypespromisesrrs ri fetch_marketszokx.fetch_markets s <<1 2  % % 't||^R@q#e*% JA OOD66uQxH I Jq#h-( r) r[rrrrrcreatedrrr)rpsafe_string_lowersafe_currency_coderryymmdd safe_dict_2rrE string_max safe_numberextend string_gtiso8601rf)rgrlrJrorWrZrYr[rrrrr underlyingpartsrrryr strikePricerymdr maxLeverage maxSpotCosts ri parse_marketzokx.parse_market!s:d  fh /%%fj9 9 D("("+6+V!!&)R8""6:r:##FK8((2%%fe4  "D$$S)E%%eQ/F&&ua0G&&v.''0e#  !#.**69=%++f-C#c\C/F**69="..vu= !--fi@ %++f-C#c\C/#5 CcIJVF+5+<6J 4B?&&vw< ((c: &&vz: {{40" "0" f0"  D0"  U 0" f 0" f 0"  w0"  0"  D0"  D0"  dD 1 1+s C0"  D0"  f0"  f0"  d0" !0" " xw(*T#0" $08(*TAID,,VW=t"ll62'' 4$((<**67;))&(;  ,,S1,,[9  ++FG<    #+4$_0" 0 0 rjc td|j|i}|dk(r|j|jdddg}g}tdt |D]<}||}||d<|j |j |j||>|}g} tdt |D]:}|j||i} |j| dg} |j| | } <|j| S|j |j||} |j| dg} |j| S) Nrnr[defaultUnderlyingBTC-USDzETH-USDrrr) rxrr`rrrpublicGetPublicInstrumentsrrvr parse_markets)rgrorsrequestoptionsUnderlyingrrrpromisesResultmarketsresr`r dataResponses rirzokx.fetch_markets_by_typesL 77=  8  $t||=PS\^gRh i H1c"345 _.q1 !+ ? ? GU[@\ ]^ _&NG1c.12 >nn^Q;..fb9++GW= >%%g. .224;;w3OPD~~h; !!,//rjcH|j|jdd}|jdr|ry|j|}|j |dg}i}|j |d}t |j}tdt|D]}||} |j| } | d} || } i} d}t| }td|D]}| |}|j|d d }|d k(rd }|jd }|j|d }d j|}|j|| d}||d|j|d|j|d|j!|d|j#|j%|j|dd|j!|d|j!|ddi|d | |<|j'| di}|j)| | | |j|ddddddddddi|| d || <|S)a fetches all available currencies on an exchange https://www.okx.com/docs-v5/en/#rest-api-funding-get-currencies :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: an associative dictionary of currencies rFNrccyrrcryptochainrfiatr|rcanDepcanWdfeewdTickSzrminWdmaxWdr) rJnetworkrdepositrrrrrrKr) rrrJrKrrrrrrror) safe_boolr`check_required_credentialsprivateGetAssetCurrenciesrgroup_bylistkeysrr safe_currencyrpr array_slicejoinnetwork_id_to_coderrfparse_precisionrvsafe_currency_structure)rgrs isSandboxModerrrdataByCurrencyId currencyIdsr currencyIdrrchainsrro chainsLengthjr  networkIdidPartsr chainPart networkCode firstChains rifetch_currencieszokx.fetch_currenciesspt||]EJ ..u5 11&9X~~h3==u5+0023 q#k*+6 A$QJ))*5HF#D%j1FHDv;L1l+ q  ,,UGR@ ?!D#//#.((!4HHUO "55i&AQR #*"#~~eX> $ug >++E59!%!2!243G3GHXHXY^`jHk3l!m"#'#3#3E7#C#'#3#3E7#C% ")% 626J77 ((V< !## $#9F4LI6 n rjrSc|j|j|}d|di}d}|j|ddd\}}|dk(r|d}|d n|}|||d <d}|dk(s|d kDr"|j|j ||}n!|j |j ||}|j |d g}|j|d i} |j| d} |j| || S)a fetches information on open orders with bid(buy) and ask(sell) prices, volumes and other data https://www.okx.com/docs-v5/en/#order-book-trading-market-data-get-order-book :param str symbol: unified symbol of the market to fetch the order book for :param int [limit]: the maximum amount of order book entries to return :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.method]: 'publicGetMarketBooksFull' or 'publicGetMarketBooks' default is 'publicGetMarketBooks' :returns dict: A dictionary of `order book structures ` indexed by market symbols rrJNrrpublicGetMarketBookspublicGetMarketBooksFullirszirrr) load_marketsrlhandle_option_and_paramsr1rr0rrvrparse_order_book) rgryrSrsrlrrrrrrs rifetch_order_bookzokx.fetch_order_bookfs V$ fTl 66v?OQY[qr / /EME E  !GDM 0 0eck44T[[&5QRH00Wf1MNH,~~h3tQ+%%eT2 $$UFI>>rjtickerc |j|d}|j|d}|j||d}|d}|j|d}|j|d}|j|dd}|r|j|d nd} |j|d } |j|d } |j|d } |j id|d |d|j |d| d| d|j|dd|j|dd|j|dd|j|dddd|d|d|dddddddd| | |j|d |j|d!|d"|S)#Nrrr|ryr:open24hrWF volCcy24hvol24hhigh24hlow24hrrhighlowbidbidPx bidVolumebidSzaskaskPx askVolumeaskSzvwapopenclose previousClosechange percentageaveragemarkPxidxPx) baseVolume quoteVolume markPrice indexPricer)rrprr safe_tickerr) rgr7rlrrryr:rIrWrRrQr>r?s ri parse_tickerzokx.parse_tickersL%%fd3 ##FH5!!(FC8!/ 2~~ffe4?Cd&&v{; %%fh7  2vx0! f! !   Y/!  D ! 3 ! 4##FG4 !  ))&':!  4##FG4!  ))&':!  D!  D!  T!  D!  T!  d! $!! " t#! $%&))&(;**67;-! . / rjc|j|j|}d|di}|j|j||}|j |dg}|j |di}|j ||S)a fetches a price ticker, a statistical calculation with the information calculated over the past 24 hours for a specific market https://www.okx.com/docs-v5/en/#order-book-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 ` rrJrr)r3rlpublicGetMarketTickerrrrvrVrgryrsrlrrrrs ri fetch_tickerzokx.fetch_tickers V$ fTl --dkk'6.JK6~~h3tQ+  //rjsymbolsc|j|j|}|j|}d}|jd||\}}d|j |i}|dk(rP|j |j dd}|j|dd|}|t|jd z||d<|j|j||}|j|d g} |j| |S) a# fetches price tickers for multiple markets, statistical information calculated over the past 24 hours for each market https://www.okx.com/docs-v5/en/#order-book-trading-market-data-get-tickers :param str[] [symbols]: unified symbols of the markets to fetch the ticker for, all market tickers are returned if not assigned :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a dictionary of `ticker structures ` Nrrnr[rrrrzT fetchTickers() requires an underlying uly or marketId parameter for options marketsr)r3market_symbolsget_market_from_symbolsrrrxrpr` safe_string_2r1rJpublicGetMarketTickersrr parse_tickers rgr[rsrlrrrr%rtickerss ri fetch_tickerszokx.fetch_tickerss %%g.--g6 !??PVX^_ F 77 C   ! $ 0 0?RT] ^ ++FE:GXYJ!'3I)IJJ!+..t{{7F/KL6..626!!'733rjc|j|j|}d|di}|j|j||}|j |d}|j |j |d|S)a fetches mark price for the market https://www.okx.com/docs-v5/en/#public-data-rest-api-get-mark-price :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 dictionary of `ticker structures ` rrJrr)r3rlpublicGetPublicMarkPricerrrVrv)rgryrsrlrrrs rifetch_mark_pricezokx.fetch_mark_priceLs{ V$ fTl 00Wf1MN~~h/  a!8&AArjc|j|j|}|j|}d}|jd||d\}}d|j |i}|dk(rP|j |j dd}|j|dd |}|t|jd z||d<|j|j||}|j|d g} |j| |S) a fetches price tickers for multiple markets, statistical information calculated over the past 24 hours for each market https://www.okx.com/docs-v5/en/#public-data-rest-api-get-mark-price :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 ` NrrYrnr[rrrrzW fetchMarkPrices() requires an underlying uly or marketId parameter for options marketsr)r3r]r^rrrxrpr`r_r1rJrfrrrarbs rifetch_mark_priceszokx.fetch_mark_pricesms %%g.--g6 !??PVX^`fg F 77 C   ! $ 0 0?RT] ^ ++FE:GXYJ!'3L)LMM!+00Wf1MN..626!!'733rjtradecx|j|d}|j|d}|j||d}|d}|j|d}|j|dd}|j|dd }|j|d } |j|d } |j|d } d} | =t j | } |j|d }|j |}| |d} |j|d}|dk(rd}n|dk(rd}|j|||j|||| d|| ||d| d |S)NtradeIdrr|ryrfillPxpxfillSzr2sideordIdrfeeCcyrrexecTypeTrMr) rrrryrJorderro takerOrMakerrpr>rrr) rprrr_rE string_negr safe_trader)rgrjrlrJrryrr>rrporderId feeCostStringr feeCostSigned feeCurrencyIdfeeCurrencyCoderxs ri parse_tradezokx.parse_tradeszd  eY /##E84!!(FC8!%%eT2 ""5(D9##E8T:v.""5'2((6   $#..}=M ,,UH=M"55mDO%+C''z: 3 "L S "L" Y/(   rjsincec 2|jd}|j|dd\}}|r|jd||||dddd S|j|}d|d i}d}|d r"|j |j ||}nm|||d <d} |j|dd d \} }| d k(r"|j |j ||}n&| dk(r!|j|j ||}|j|dg} |j| |||S)a get the list of most recent trades for a particular symbol https://www.okx.com/docs-v5/en/#rest-api-market-data-get-trades https://www.okx.com/docs-v5/en/#rest-api-public-data-get-option-trades :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 :param str [params.method]: 'publicGetMarketTrades' or 'publicGetMarketHistoryTrades' default is 'publicGetMarketTrades' :param boolean [params.paginate]: *only applies to publicGetMarketHistoryTrades* default False, when True will automatically paginate by calling self endpoint multiple times :returns Trade[]: a list of `trade structures ` FrpaginaterlafterNrrrJr[rSrpublicGetMarketTradespublicGetMarketHistoryTradesr) r3r4fetch_paginated_call_cursorrlpublicGetPublicOptionTradesrrrr parse_trades) rgryrrSrsrrlrrrrs ri fetch_tradeszokx.fetch_tradessG 88PZ[& 33M65RWY_ajlsuy{~ V$ fTl  ( 77 GV8TUH #( F!::6=RZ\stNFF0055dkk'66RS99<rrNrri`TrJ)rbarrSCandlesiHistoryCandlesrrbeforeruntilror;r<r instFamilyrr)r3rlr4"fetch_paginated_call_deterministicrprqrvr`rparse_timeframerlowerrrPsumr&publicGetMarketHistoryMarkPriceCandlesrpublicGetMarketMarkPriceCandles"publicGetMarketHistoryIndexCandlespublicGetMarketIndexCandlespublicGetMarketHistoryCandlespublicGetMarketCandlesr parse_ohlcvs)rgry timeframerrSrsrlrr>r`rdurationrrrnowdurationInMilliseconds historyBorder startTimerroisHistoryCandlesrrs ri fetch_ohlcvzokx.fetch_ohlcvG s* V$88zZ& ::<QVX]_hjpruv v  167+..|R@##GZ? =EsOE'' 2t 9E  H$5 8>># #CTl    ##%C%-_ "H0F#FGM}$. E3EAIq)I )GH #xx/E/MNGG !!&'2  $GG YYvw/F&&w D  <66* $44 F?FFt{{SZ\bGcd?? GU[@\] g  &v| Z[66t{{7F7ST~~h3  vy%GGrjc |t|jdz|jd}|j|dd\}}|r|j d|||d|dS|j |}d|di}|t |d z d |d <|||d <|j|j||}g} |j|d g} td t| D]n} | | } |j| d} | j| |j|j| d|j!| d| |j#| dp|j%| d}|j'||d||S)a fetches historical funding rate prices https://www.okx.com/docs-v5/en/#public-data-rest-api-get-funding-rate-history :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 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 dict[]: a list of `funding rate structures ` z5 fetchFundingRateHistory() requires a symbol argumentFrrrrrrJrrrrSr fundingTime realizedRate)rry fundingRaterrrry)r1rJr3r4rrlrP!publicGetPublicFundingRateHistoryrrrrrr safe_symbolrprrsort_byfilter_by_symbol_since_limit)rgryrrSrsrrlrrratesrrratersorteds rifetch_funding_rate_historyzokx.fetch_funding_rate_history s >#DGG.e$ef f 88AZ\fg& ::;TV\^cejlprxz}~ ~V$ fTl    #EAIq 1GH   $GG 99$++gv:VW.~~h3q#d)$ A7D))$ >I LL**4+;+;D(+KL#//nE& LL3   e[1009I5RWXXrjcP|dk(r|j|S|j|S)Nr-)parse_funding_balanceparse_trading_balance)rgrors riparse_balance_by_typezokx.parse_balance_by_type s, 9 --h7 7--h7 7rjc\d|i}|j|dg}|j|di}|j|d}|j|dg}tdt |D]}||}|j |d} |j | } |j} |j |d} |j |d} | | +|j |d | d <|j |d | d <n | | d <| | d <| || <||d<|j||d<|j|S)NrrruTimedetailsr eqavailEqavailBalfree frozenBalusedtotalrr) rrvrrrrprrr safe_balance)rgrrrrrrrbalancer%rrrrs rirzokx.parse_trading_balance sI)~~h3tQ+%%eW5 .. 26q#g,' #AajG))'59J**:6DllnG!!'40B&&w :G "&"2"27J"G"&"2"27K"H#% ")"F4L #({!\\)4z  ((rjc~d|i}|j|dg}tdt|D]~}||}|j|d}|j |}|j }|j|d|d<|j|d|d<|j|d |d <|||<|j |S) Nrrrr balrrrrr)rrrrprrr) rgrrrrrr%rrs rirzokx.parse_funding_balance s)~~h3q#d)$ #A1gG))'59J**:6DllnG#//?GG "..w CGFO"..w DGFO"F4L #  ((rjrc ||jd||jtj|j |dd|jtj|j |dddddS)NrmakerUrtakerU)rryrrrM tierBased)rrfrEryr_)rgrrls riparse_trading_feezokx.parse_trading_fee s{&&tV4&&w'9'9$:L:LSRY[c:d'ef&&w'9'9$:L:LSRY[c:d'ef  rjc|j|j|}d|j|di}|dr |d|d<n9|ds |ds|dr|d d z|d z|d <nt|jd z|j |j ||}|j|dg}|j|di}|j||S)aa fetch the trading fees for a market https://www.okx.com/docs-v5/en/#trading-account-rest-api-get-fee-rates :param str symbol: unified market symbol :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `fee structure ` rnrorWrJrrYrZr[rr|rrzE fetchTradingFee() supports spot, swap, future or option markets onlyrr) r3rlrxr;rJprivateGetAccountTradeFeerrrvrrYs rifetch_trading_feezokx.fetch_trading_fee. s V$ 77vG  &> &t GH  F^vh/6(3C#H-3fY6GGGENtww)ppq q11$++gv2NO&~~h3tQ+%%eV44rjc |j|jdd|\}}i}d}|dk(r"|j|j||}n!|j |j||}|j ||S)a query for balance and get the amount of funds available for trading or funds locked in orders https://www.okx.com/docs-v5/en/#funding-account-rest-api-get-balance https://www.okx.com/docs-v5/en/#trading-account-rest-api-get-balance :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.type]: wallet type, ['funding' or 'trading'] default is 'trading' :returns dict: a `balance structure ` rvNr-)r3rrprivateGetAssetBalancesrprivateGetAccountBalancer)rgrsrqueryrrs ri fetch_balancezokx.fetch_balance] s  >>~tU[\ E   "33DKK4OPH44T[[%5PQHN))*h??rjrc |j|j|}|dst|jdzddd}|j |dd|d|j ||S)  https://www.okx.com/docs-v5/en/#order-book-trading-trade-post-place-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 ` rWz: createMarketBuyOrderWithCost() supports spot markets onlyF quote_ccyrtgtCcyrlbuyNr3rlr;rJ create_orderrrgryrrsrlreqs ri!create_market_buy_order_with_costz%okx.create_market_buy_order_with_cost sq V$f~tww)eef f16!   5$dkkRUW]F^__rjc |j|j|}|dst|jdzddd}|j |dd|d|j ||S) rrWz; createMarketSellOrderWithCost() supports spot markets onlyFrrrlsellNrrs ri"create_market_sell_order_with_costz&okx.create_market_sell_order_with_cost sq V$f~tww)ffg g16!   64t{{SVX^G_``rjrorprr>c|j|}|d|||j||d}|d} |d} |j|gd} |j|dd} |j |dd } |j |d |}|j|d d }|j |d d}|j |d|}|j|dd }|j |dd}|j |d}|du}|j |d}|du}|j |dd}|du}| duxs|dk(}|j |dd}|j |jddd}|j |dd}d}||dk7rd}n|}|j|d d}| rD|r6|d!k(r|d"n|d#}|j|d$|} |j| |d$<|r|nd}!|!|d<n| r|d%s|d&rvd}"|j|d'd(\}"}|"|"|d)<nVd}#|j|d'd*\}#}|#r<|d!k(}$| duxs|duxs|}%|%r|$rd+nd,|d)<|r|j|d}n |$rd,nd+|d)<||d<|d-k(}&d}'|j|&|d.k(|\}'}|j|gd/}| d0k(xs|d1k(}(| d2k(xs|d3k(})|duxs | duxs|d4k(}*|&xr|(xs|d5k(}+|j|jd6d7},|j|d6|,}-| s|s|-|d6<|&s|+rd-|d8<| r|d!k(r|-d9k(rd}.|j|d'd:d\}.}|j|d;d<}/|j|d;d<|'rd.|d8<n|(r|+sd1|d8<n|)rd3|d8<|r"tj,|d?}3|3|d<d@|d8<n-|s|rl|r-|j|gdA}4|4t%|j&dBz|j+||4|d<|j|gdC}5|j|dD}6|6c|6dEk(}7|6d-k(}8|7s|8st%|j&dFz|7r0|5t%|j&dGz|j+||5|d<n(|6d-k(r#dH|d<n|5|j+||5|d<ndH|d<|j |dIdd }9|9,|9d k7r"|9dJk7r|9dKk7rt%|j&dLz|9|d<|r|j|gdM}:|:t%|j&dNz|j+||:|d <|j|gdO};|j |dDdP}<||=s|>st%|j&dQz|=r5|;t%|j&dRz|<|dP<|j+||;|d <n-|rFrrorSzL createOrder() params["stopLoss"]["type"] must be either "limit" or "market"z createOrder() requires a limit price in params["stopLoss"]["price"] or params["stopLoss"]["slOrdPx"] for a stop loss limit order-1r=r<r;zT createOrder() stop loss trigger price type must be one of "last", "index" or "mark")rDrrz createOrder() requires a trigger price in params["takeProfit"]["triggerPrice"], or params["takeProfit"]["stopPrice"], or params["takeProfit"]["tpTriggerPx"] for a take profit order)r>rGr tpOrdKindzN createOrder() params["takeProfit"]["type"] must be either "limit" or "market"z createOrder() requires a limit price in params["takeProfit"]["price"] or params["takeProfit"]["tpOrdPx"] for a take profit limit orderzV createOrder() take profit trigger price type must be one of "last", "index" or "mark"rorderPxr'r9tag)rlamount_to_precision safe_value_nrp safe_value_2 safe_valuer_r`rrr4rqhandle_post_only safe_number_2number_to_stringrE string_mulrfr8rJcost_to_precisionprice_to_precision string_divuuid16r)Drgryrorprr>rsrlrrWrrDrIrGrrrFrrrrstopLossDefinedrtakeProfitDefinedrisTrailingPercentOrderr& isReduceOnlyrrCrXdefaultCurrencyr tradeModerrJisBuy isProtective isMarketOrderpostOnlyrrr% marketIOC defaultTgtCcyrrnotional amountString priceString quoteAmountconvertedTrailingPercentstopLossTriggerPricestopLossLimitPricestopLossOrderTypestopLossLimitOrderTypestopLossMarketOrderTypestopLossTriggerPriceTypetakeProfitTriggerPricetakeProfitLimitPricetakeProfitOrderTypetakeProfitLimitOrderTypetakeProfitMarketOrderTypetakeProfitTriggerPriceTypetwoWayCondition tpOrdPxReq slOrdPxReqr9sD ricreate_order_requestzokx.create_order_request s[ V$Tl**66: 4f~*%((1[\ &&v}eD ++F4E}U//&)U;**63DfM))&/=Q //&)U;**63DfM**69oN ??6:6#4/__V\: 't3,,V5FX!0!<t+C1Bv|UC  ..t||=PR^`gh'' hG   "v)=F*J^^FHeF8 ,'//3/D/DV/L .2.C.CE.J .5.@.@{.[ +/+<+<[+I%-".tww:z0z#{{.6.>6X$($:$:68$LGDMX%8 "k $ 7 7 F !,GI  !&GI  !&GI  !'.'9'9/5'Q $'?GO $!2GI   1'+'8'8Co'p$'/&tww2a(abb)-)@)@I])^ &%)%6%6xAf%g"$($4$4Xv$F!$0.?7.J*/@H/L+2=T*4776D,DEE/-5".tww:}0}#~~151H1HQc1dGI.*h6-1 *'3)-)@)@I[)\GI&)-GI&+/+=+=hHZ\mou+v(+70F:AY]dAdlDHNlN*4776L,LMM1IG-. )-):)::Gs)t&)1&tww2i(ijj)-)@)@I_)` &'+'8'8El'm$&*&8&8V[&Y#&20Cw0N,1D1P-4?X*4776F,FGG1/7".tww:C0C#DD3FGK0151H1HQe1fGI.,8-1 *)5+2GK()-)@)@I])^GI&)-GI&-1-?-? L^`qsy-z*-92f` rhrrr&r%r(r'r)r*privatePostTradeOrderAlgoprivatePostTradeOrderz createOrder() self.options["createOrder"] must be either privatePostTradeBatchOrders or privatePostTradeOrder or privatePostTradeOrderAlgoNrrrorp) r3rlr5rpr`r,rJr8r7rrrv parse_order)rgryrorprr>rsrlrrrequestOrdTyperrrrws rirzokx.create_order s> V$++FD$vV!!$,, ?\]))'9= i '^}-LR`duRu{DU|U[_ch[hnrvnEIMSES0F - -F>Y4Y`fkHaH+x!xy y 2 2iG , ,11':H 2 255g>H77@H~~h3tQ+  /f f  rjordersc |jg}tdt|D]}||}|j|d}|j|d}|j|d}|j |d} |j |d} |j |di} |j | |} |j|||| | | } |j| |j|}|j|dg}|j|S) a create a list of trade orders https://www.okx.com/docs-v5/en/#order-book-trading-trade-post-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 ` rryrorprr>rsr) r3rrrpr rvrr5rrr parse_orders)rgr;rsordersRequestsrrawOrderrrorprr> orderParamsextendedParams orderRequestrrs ri create_orderszokx.create_orders# s q#f+& 0AayH''(;H##Hf5D##Hf5D__Xx8FOOHg6E..8R@K![[f=N44XtT6SXZhiL  ! !, / 033NC.~~h3  &&rjrJc|j|}d|di} d} |dk(s|dk(s|dk(s|dk(s |dk(s|dk(rd } |j|d d } | | r| | d <n| | d <n | r|| d <n|| d<|j|dd} |j|d} |j |dd}|j|dd}|j|d}|j |dd}|j|d}|j|d}|du}|du}| r| |t |j dz| P| t |j dz|j|| | d<|dk(rdn|j|| | d<|| d<||t |j dz|j||| d<|dk(rdn|j||| d<|| d<nX| 6|j|| | d<|dk(rdn|j|| | d<|| d<|6|j||| d<|dk(rdn|j||| d<|| d<|rl|j|d} |j|d } |j |d!}|j|| | d<|dk(rdn|j|| | d<|| d<|rx|j|d}|j|d }|j |d!}|d"k(r|nd#| d$<|j||| d<|dk(rdn|j||| d<|| d<||j||| d%<| s||j||| d&<|j|gd'}|j| |S)(NrrJr&r%r(r'r)r*Trr algoClOrdIdalgoIdrqrFnewSlTriggerPx newSlOrdPxnewSlTriggerPxTyper:rGnewTpTriggerPx newTpOrdPxnewTpTriggerPxTyperrz\ editOrder() requires a stopLossPrice or takeProfitPrice parameter for editing an algo orderzF editOrder() requires a newSlOrdPx parameter for editing an algo orderrlrzF editOrder() requires a newTpOrdPx parameter for editing an algo orderrDr>rorS condition newTpOrdKindnewSznewPx)rrrGrFrrr) rlr_r r rpr2rJrr rqr)rgrJryrorprr>rsrlr isAlgoOrderrr&rFr+r,rGr1rrrr stopLossTypetakeProfitTypes riedit_order_requestzokx.edit_order_requestT s{V$ fTl  I 4=#8dFW>W]aej]jptyBqBHLPVHVK**69oN  $)6 &%2 "$&!#% #00JZ[ = #'#3#3FRTZ%["??6:6__V\: #4/'t3 $,3I3Q ,J"JKK#/ ($TWW/w%wxx,0,C,CFL`,a()151AH_H_`fhuHv %0H,-%1"*$TWW/w%wxx,0,C,CFLb,c()151AH_H_`fhwHx %0J,-#/,0,C,CFL`,a()151AH_H_`fhuHv %0H,-%1,0,C,CFLb,c()151AH_H_`fhwHx %0J,-'+x'P$ $' B #//&A ,0,C,CFL`,a()1=1IPTPgPghnp}P~ %0H,- )-^)T&"&//*g"F!%!1!1*f!E=Kw=V.]h',0,C,CFLb,c()1?81KRVRiRijpsBSC %0J,-  #77GGG  #'#:#:65#I 6$JK{{7F++rjc |j|j|}|j|||||||} d} |dk(s|dk(s|dk(s|dk(s |dk(s|dk(rd} d} | r"|j|j | |} n!|j |j | |} |j | d g} |j| d i} |j| |}||d <||d <|S) a edit a trade order https://www.okx.com/docs-v5/en/#order-book-trading-trade-post-amend-order https://www.okx.com/docs-v5/en/#order-book-trading-algo-trading-post-amend-algo-order :param str id: order id :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 the currency 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 str [params.clientOrderId]: client order id, uses id if not passed :param float [params.stopLossPrice]: stop loss trigger price :param float [params.newSlOrdPx]: the stop loss order price, set to stopLossPrice if the type is market :param str [params.newSlTriggerPxType]: 'last', 'index' or 'mark' used to specify the stop loss trigger price type, default is 'last' :param float [params.takeProfitPrice]: take profit trigger price :param float [params.newTpOrdPx]: the take profit order price, set to takeProfitPrice if the type is market :param str [params.newTpTriggerPxType]: 'last', 'index' or 'mark' used to specify the take profit trigger price type, default is 'last' :param dict [params.stopLoss]: *stopLoss object in params* containing the triggerPrice at which the attached stop loss order will be triggered :param float [params.stopLoss.triggerPrice]: stop loss trigger price :param float [params.stopLoss.price]: used for stop loss limit orders, not used for stop loss market price orders :param str [params.stopLoss.type]: 'market' or 'limit' used to specify the stop loss price type :param dict [params.takeProfit]: *takeProfit object in params* containing the triggerPrice at which the attached take profit order will be triggered :param float [params.takeProfit.triggerPrice]: take profit trigger price :param float [params.takeProfit.price]: used for take profit limit orders, not used for take profit market price orders :param str [params.takeProfit.type]: 'market' or 'limit' used to specify the take profit price type :param str [params.newTpOrdKind]: 'condition' or 'limit', the default is 'condition' :returns dict: an `order structure ` Nr&r%r(r'r)r*Trrrorp) r3rlrTprivatePostTradeAmendAlgosrprivatePostTradeAmendOrderrrvr9)rgrJryrorprr>rsrlrrQrrrrws ri edit_orderzokx.edit_order s@ V$))"fdD&%QWX I 4=#8dFW>W]aej]jptyBqBHLPVHVK 66t{{7F7STH66t{{7F7STH ~~h3tQ+  /f f  rjc>|t|jdz|j|dd}|j|dd}|s|r&|j |g||}|j |dS|j |j|}d|di}|j|d d } | | |d <n||d <|j|d d g} |j|j|| } |j | d g} |j| d} |j| |S) a cancels an open order https://www.okx.com/docs-v5/en/#order-book-trading-trade-post-cancel-order https://www.okx.com/docs-v5/en/#order-book-trading-algo-trading-post-cancel-algo-order :param str id: order id :param str symbol: unified symbol of the market the order was made in :param dict [params]: extra parameters specific to the exchange API endpoint :param boolean [params.trigger]: True if trigger orders :param boolean [params.trailing]: set to True if you want to cancel a trailing order :returns dict: An `order structure ` z) cancelOrder() requires a symbol argumentstopr&rKFrrrJrrrqr)r1rJr r cancel_ordersr r3rlr_rqprivatePostTradeCancelOrderrrvr9)rgrJryrsr&rK orderInnerrlrrrrrrws ri cancel_orderzokx.cancel_order s/ >#DGG.Y$YZ Z##FFI>>>&*e< h++RD&&AJ??:q1 1 V$ fTl  **69oN  $!.GI !GG  &9o">?33DKK4OPx4tQ'v..rjcL|!t|tr|jdS|S)zg @ignore :param string[]|str ids: order ids :returns str[]: list of order ids ,) isinstancestrr)rgidss ri parse_idsz okx.parse_ids s% OC!599S> !Jrjc&|t|jdz|j|j|}g}|j |j di}|j |dd}|j |d|}|j|j|dd} |j|j |d} |j|d d } |j|d d } | s| rd }| |j|}| 4tdt| D]} |j| | |ddtdt|D];} | s| r|j|| |dd"|j|| |dd=n4tdt| D]} |j|d| | dd}|d k(r|j|}n|j|}|j|dg}|j!||dd|S)a cancel multiple orders https://www.okx.com/docs-v5/en/#order-book-trading-trade-post-cancel-multiple-orders https://www.okx.com/docs-v5/en/#order-book-trading-algo-trading-post-cancel-algo-order :param str[] ids: order ids :param str symbol: unified market symbol :param dict [params]: extra parameters specific to the exchange API endpoint :param boolean [params.trigger]: whether the order is a stop/trigger order :param boolean [params.trailing]: set to True if you want to cancel trailing orders :returns dict: an list of `order structures ` Nz* cancelOrders() requires a symbol argumentr`rr"rrrFrZr&rKFprivatePostTradeCancelAlgosrrJ)rFr)rqr)rrr)r1rJr3rlr r`rprdr rrrrrfr"rr=)rgrcryrsrlrr` defaultMethodrclientOrderIdsalgoIdsr&rKrr ordersDatas rir[zokx.cancel_orders s0 >#DGG.Z$Z[ [ V$//$,,C(((<_` !!&(MB(9(9&)_(]^..!BC##FFI>>>&*e< h2F  !..%C"q#g,/ANN")!*"(,$ 1c#h' wNN"%a&"(,$ NN!$Q"(,$ 1c.12 $Tl-a0    2 277@H==gFH<^^Hfb9   VT4HHrjc|jg}|j|jdi}|j|dd}|j|d|}|j |dd}|j |dd}|xs|} | rd}t d t|D]{} || } |j| d } |j| d d } |j| d }|j|}d}| rd}n| d }d|d i}| | n| ||<|j|}d}|dk(r|j|}n|j|}|j|dg}|j|ddd|S)a5 cancel multiple orders for multiple symbols https://www.okx.com/docs-v5/en/#order-book-trading-trade-post-cancel-multiple-orders https://www.okx.com/docs-v5/en/#order-book-trading-algo-trading-post-cancel-algo-order :param CancellationRequest[] orders: each order should contain the parameters required by cancelOrder namely id and symbol, example [{"id": "a", "symbol": "BTC/USDT"}, {"id": "b", "symbol": "ETH/USDT"}] :param dict [params]: extra parameters specific to the exchange API endpoint :param boolean [params.trigger]: whether the order is a stop/trigger order :param boolean [params.trailing]: set to True if you want to cancel trailing orders :returns dict: an list of `order structures ` r`rr"rZr&rKFrfrrJrrryrqrFNrr)r3rvr`rp safe_bool_2rrrr_rlrrfr"rr=)rgr;rsrr`rgrr&rKisStopOrTrailingrrwrJrryrlidKey requestItemrrjs ricancel_orders_for_symbolszokx.cancel_orders_for_symbolso s ..~rB(((<_` !!&(MB""669=>>&*e<".h 2Fq#f+& (A1IE!!%.B ..uiQM%%eX6F[[(FE *!&,!K4A3LSUK  NN; ' (  2 277@H==gFH<^^Hfb9   T4vFFrjtimeoutc|jd|dkDr|j|dz ndi}|j|j||}|S)au dead man's switch, cancel all orders after the given timeout https://www.okx.com/docs-v5/en/#order-book-trading-trade-post-cancel-all-after :param number timeout: time in milliseconds, 0 represents cancel the timer :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: the api result timeOutrr)r3 parse_to_intprivatePostTradeCancelAllAfterr)rgrqrsrrs ricancel_all_orders_afterzokx.cancel_all_orders_after sW  Wq[t((48q 66t{{7F7STrjrc:ddddddd}|j|||S)NrrIclosed)r order_failedlivepartially_filledfilled effectiverprgrstatusess riparse_order_statuszokx.parse_order_status s2"& &!  &&99rjrwc H|j|d}|;|dk7r6|j|j|d|j|dd|dS|j|dd}|j|d}|j|d }|j|d }|j|d }|j|d } d} d} | d k(rd} d} n| dk(rd} d} n | dk(rd} d} |j|d} |j | |}|j | |d} |j|d}|j|dd}|j|d}|j |j|d}|j|d}d}d}|j|jdd}|j|d|}|j|d}|dk(r"| d k(r|d!k(r|d"k(r|j|d#}n|j|d#}d}|Ltj|}|j|d$}|j|}|j||d%}|j|d}|t|d&krd}|j|d'd(}|j|d)d*}|j|d+}d,} | |d-k(} |jid.|d/|d0|d1|d2|j|d3|d4|d5| d6| d7| d8| d |d9|d:|d;|d<|j|d=d>gd?||||d||d| d@|S)ANsCode0rqrrejected)rJrrrrFcTimerfillTimerprrTrSrr@rr?rr| accFillSzrnordPxavgPxrrrrrnrrlr/rr2rrrsrrrrrrFtruerrJrrrlastTradeTimestamplastUpdateTimestampryrorIrr>rFrGrDr moveTriggerPxrN)rrr| remainingrrtradesr)rp safe_orderr_rrrrr`rEryrrfrrr safe_number_n)!rgrwrlscoderJrrrrprorrIrryr|r>rNrr|rrr rrnrr}r~rrrFrG reduceOnlyRawrs! rir9zokx.parse_order s*T  0  ESL??&&ug6!%!1!1%!C$ $    x 9%%eW5 "//w?!..ujAv.y1 ; HD U]KD U]KD##E84!!(F3!!(FC8!!%5""5$8""5'2(()9)9%)IJ((6 ((xL !!%=A##E:6 EM 0x67IPVZePe##E40D%%eT2F  $#..}=M ,,UH=M"55mDO))-8+C(( :  %C ,>,B M**5-K ,,UM9M(( =   !'61J E "  ]     Y/  !"4   "#6  f  D  ;    D  U  ]   D..u{O6TU! " w# $$3 4 5 rjc|t|jdz|j|j|}d|di}|j |dd}|j |j di}|j|dd }|j|d|} |j|d d } | rd } |||d <n||d<n |||d<n||d<|j|gd} d} | d k(r"|j|j|| } n!|j|j|| } |j | dg} |j| d}|j||S)a fetch an order by the id https://www.okx.com/docs-v5/en/#order-book-trading-trade-get-order-details https://www.okx.com/docs-v5/en/#order-book-trading-algo-trading-get-algo-order-details :param str id: the order id :param str symbol: unified market symbol :param dict [params]: extra and exchange specific parameters :param boolean [params.trigger]: True if fetching trigger orders :returns: `an order structure ` Nz( fetchOrder() requires a symbol argumentrrJrrrrr rZr&privateGetTradeOrderAlgorErFrq)rrrrZr&rr)r1rJr3rlr_r r`rpr rqrrr rvr9)rgrJryrsrlrrr`rgrr&rrrrws ri fetch_orderzokx.fetch_ordersz >#DGG.X$XY Y V$ fTl  **69oN //$,, bA((( /F()6 &$&!(%2 "#%  &"[\ / /44T[[%5PQH00We1LMHBx4tQ'v..rjc<|jd}|j|dd\}}|r|jd||||Si}d}||j|}|d|d<|||d<|j |j di}|j |j di} |j |d d } |j |d | } |j |d } |j|d d } |j|dd}|s| s| | vrd} |rd|d <n | r| d |d <|j|gd}d}| dk(r"|j|j||}n!|j|j||}|j|dg}|j||||S)a fetch all unfilled currently open orders https://www.okx.com/docs-v5/en/#order-book-trading-trade-get-order-list https://www.okx.com/docs-v5/en/#order-book-trading-algo-trading-get-algo-order-list :param str symbol: unified market symbol :param int [since]: the earliest time in ms to fetch open orders for :param int [limit]: the maximum number of open orders structures to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :param bool [params.trigger]: True if fetching trigger or conditional orders :param str [params.ordType]: "conditional", "oco", "trigger", "move_order_stop", "iceberg", or "twap" :param str [params.algoId]: Algo ID "'433845797218942976'" :param boolean [params.paginate]: default False, when True will automatically paginate by calling self endpoint multiple times. See in the docs all the [availble parameters](https://github.com/ccxt/ccxt/wiki/Manual#pagination-params) :param boolean [params.trailing]: set to True if you want to fetch trailing orders :returns Order[]: a list of `order structures ` FrrNrJrrSr5rr!rrZr&rK privateGetTradeOrdersAlgoPendingr(rrZr&rKr)r3r4fetch_paginated_call_dynamicrlr r`rpr rrqrrr!rr=)rgryrrSrsrrrlr`r5rgrrr&rKrrrs rifetch_open_orderszokx.fetch_open_orders:s$ 88ART^_& 445FPUW\^de e    [[(F &t GH   $GG //$,,0A2F7GL(((>>&*e< w7n#<7F !2GI  '/!*GI  &"KL 7 7<` NrJrr{rnrSrrr5rr#rrZr&rKF privateGetTradeOrdersAlgoHistoryr(rFz fetchCanceledOrders() requires an "ordType" string parameter, "conditional", "oco", "trigger", "move_order_stop", "iceberg", or "twap"beginrrrr)r3rlrrrxr r`rpr rrqr1rJrrrr#rr=)rgryrrSrsrrlrorr`r5rgrrr&rKrFrsendrrs rifetch_canceled_orderszokx.fetch_canceled_orderssd$     [[(F &t GH 889NPVX^_ e"==dC   $GG %//$,,0ErJ7GL(((>>&*e< 7F!2GI  N27F%%fh7F!$*!684?+DGG7@-@AA #( %%eW5E !& %'3yy IJ 7 7<d|d <n8|||d<|j| d}|||d<|j| dg} d|d<|j| gd}d}| dk(r"|j|j||}nH| dk(r"|j|j||}n!|j!|j||}|j#|dg}|j%||||S)a fetches information on multiple closed orders made by the user https://www.okx.com/docs-v5/en/#order-book-trading-trade-get-order-history-last-7-days https://www.okx.com/docs-v5/en/#order-book-trading-algo-trading-get-algo-order-history https://www.okx.com/docs-v5/en/#order-book-trading-trade-get-order-history-last-3-months :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]: True if fetching trigger or conditional orders :param str [params.ordType]: "conditional", "oco", "trigger", "move_order_stop", "iceberg", or "twap" :param str [params.algoId]: Algo ID "'433845797218942976'" :param int [params.until]: timestamp in ms to fetch orders for :param boolean [params.paginate]: default False, when True will automatically paginate by calling self endpoint multiple times. See in the docs all the [availble parameters](https://github.com/ccxt/ccxt/wiki/Manual#pagination-params) :param str [params.method]: method to be used, either 'privateGetTradeOrdersHistory', 'privateGetTradeOrdersHistoryArchive' or 'privateGetTradeOrdersAlgoHistory' default is 'privateGetTradeOrdersHistory' :param boolean [params.trailing]: set to True if you want to fetch trailing orders :returns Order[]: a list of `order structures ` Fr}rNrJrrnrSr5rr#rrZr&rKrr}rr(rrrr|r#privateGetTradeOrdersHistoryArchiver)r3r4rrlrrrxrvr`rprlrrrqrrrr#rr=)rgryrrSrsrrrlrorr`r5rgrrr&rKrrrrs rifetch_closed_orderszokx.fetch_closed_orderss* 88ATV`a& 445H&RWY^`fg g    [[(F &t GH 889LfV\] e"==dC   $GG ../BBG 6FK(((>&*e< w7n#<7F*GG  !2GI  %. " #( %%eW5E !& %'3'GG yy IJ 7 7<` FrrNrJrrrrnrSr) r3r4rrlhandle_until_optionrrrxprivateGetTradeFillsHistoryrrr) rgryrrSrsrrrlrorrrs rifetch_my_tradeszokx.fetch_my_trades5s/ 88R\]& 44_feUZ\bc c   [[(F &t GH   $GG 225'6J88&RXY e"==dC   EM$GG 33DKK4OP4~~h3  vueUCCrjc Rd|i}|j||||j||S)a? fetch all the trades made from a single order https://www.okx.com/docs-v5/en/#order-book-trading-trade-get-transaction-details-last-3-months :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 :returns dict[]: a list of `trade structures ` rq)rr)rgrJryrrSrsrs rifetch_order_tradeszokx.fetch_order_tradesys4 R ##FE5$++gv:VWWrjrc|jd}|j|dd\}}|r|jd||||S|j|jdi}|j |d}|j |d|}|j |d}i}d} |jd|\} }| |j |d} |dk7r| | |d<|jdd|\} } | |j| |d<|||d <d} ||j|} | d |d <|jd ||\}}d} |d k(r"|j|j|| } nH|dk(r"|j|j|| } n!|j|j|| } |j!| dg}|j#|| ||S)a fetch the history of changes, actions done by the user or operations that altered balance of the user https://www.okx.com/docs-v5/en/#rest-api-account-get-bills-details-last-7-days https://www.okx.com/docs-v5/en/#rest-api-account-get-bills-details-last-3-months https://www.okx.com/docs-v5/en/#rest-api-funding-asset-bills-details :param str [code]: unified currency code, default is None :param int [since]: timestamp in ms of the earliest ledger entry, default is None :param int [limit]: max number of ledger entries to return, default is None :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.marginMode]: 'cross' or 'isolated' :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 `ledger structure ` FrrrNmgnModeprivateGetAssetBillsrnrSrJr rprivateGetAccountBillsArchiver)r3r4rrvr`rprqhandle_margin_mode_and_paramsrrrxrrrrrrr parse_ledger)rgrrrSrsrr`rrrCrorrrrs ri fetch_ledgerzokx.fetch_ledgers" 88PZ[& 44]D%QVX^_ _..}bA!!'84!!&(F;68,   !?? vV F  ))&)>rjc Ddddddddddddd }|j|||S)Nrrjrebater) rr345r+7891011r~)rgrors riparse_ledger_entry_typezokx.parse_ledger_entry_typesA  tT22rjitemrcv|j|d}|j||}|j||}|j|d}|j|d}d}|'|j t j ||d}|j|d}|j|dd} |j||j|d||j|d|j|dd|j|j|d || |j|d d|j|d d |d |S)Nr rrrsrr|billIdrqrobalChgrr)rrJrrr referenceIdreferenceAccountrorryrrrrr) rprrrrfrEryrsafe_ledger_entryrrr) rgrrr%rrr|rrrys riparse_ledger_entryzokx.parse_ledger_entrysTJ%%dE2 &&z8<%%j(;%%dD1 ((u5   $))'*<*<]*KL C##D(3!!(D#6%%""42" Y/++D': $001A1A$1OP&&tX6%%dE2' ! rjc*|j|d}|j|gd}|%|j|di}|j|d}|j|d}|j||}|d}|j|d}|j|di} |j | d } |j| |} |d k(r|j | d d } |j| d } |j | |} |j|||| ||d S)Naddr)rpmtIdmemoaddrExcommentr rr rrJz USDT-PolygonzUSDT-Polygon-Bridger)rrraddressr)rp safe_string_nr rindex_byr r check_address)rgdepositAddressrrrrr%rr r networksById networkDatarr,s riparse_deposit_addresszokx.parse_deposit_addressUs0:"">6:  1IJ ;__^XrBF""695C%%ne< %%j(;  9??8Z<}}Xt4 oolE: T N "++L:OQ_`K""; :--gt<  7#""   rjc2|j|j|}d|di}|j|j||}|j |dg}|j |dd}|j ||dgd}|j|dS) a fetch a dictionary of addresses for a currency, indexed by network https://www.okx.com/docs-v5/en/#funding-account-rest-api-get-deposit-address :param str code: unified currency code of the currency for the deposit address :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a dictionary of `address structures ` indexed by the network r rJrselectedTrFr)r3rprivateGetAssetDepositAddressrr filter_byparse_deposit_addressesr) rgrrsrrrrfilteredparseds ri"fetch_deposit_addresses_by_networkz&okx.fetch_deposit_addresses_by_networks ==& 8D> 55dkk'66RS,~~h3>>$ D9--h&9I8JER}}VY//rjc|j|j|d}|j|d}|j|}|j ||}|j ||}|7|j ||}|!t|jdz|zdz|z|S|j ||}||vr||St|j}|j|d} |j || S)a fetch the deposit address for a currency associated with self account https://www.okx.com/docs-v5/en/#funding-account-rest-api-get-deposit-address :param str code: unified currency code :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.network]: the network name for the deposit address :returns dict: an `address structure ` rz# fetchDepositAddress() cannot find z deposit address for r) r3rprqrrrrvr7rJrr) rgrrs rawNetworkrrr codeNetworkrrs rifetch_deposit_addresszokx.fetch_deposit_addresss  %%fi8 69-&&t,))*d;::4H  ^^Hg6F~$TWW/T%TW^%^ax%x{%AAM--dD9 ( "K( (HMMO$  q)~~h..rjrc|j||\}}|j||j|j|}|t |dkDr|dz|z}|d|d|j |d}|j |d}|^|j|jdi} |j | |j|}|ddz|z|d <|j|d}|j |d } | |j} |j|j| |_ |j|d|j|i} |j | d } | t|j d z|j | |d <|j|d g} |j#|j%|| }|j'|d g}|j|d}|j)||S) a make a withdrawal https://www.okx.com/docs-v5/en/#funding-account-rest-api-withdrawal :param str code: unified currency code :param float amount: the amount to withdraw :param str address: the address to withdraw to :param str tag: :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `transaction structure ` rrrJr)r toAddrdestamtrrr|r ru withdraw() requires a "fee" string parameter, network transaction fee must be ≥ 0. Withdrawals to OKCoin or OKX are fee-free, please set "0". Withdrawing to external digital asset address requires network transaction fee.r)handle_withdraw_tag_and_paramsrr3rrrrprvr`upperrqr.rc currenciesrr1rJprivatePostAssetWithdrawalrrparse_transaction)rgrrrrrsrrrrrr targetNetworkrrr transactions rirz okx.withdraws99#vF V 7# ==& O#c(Q,mc)GD>((0   ""695  ~~dllJCH&&x'JG'~3g=GG YYvy1Fvu- ;..0J"..t KDO NN8J+?AXAXY`AacefM""=%8C{'3U)UVV..s3 &5'*224;;w3NO~~h3nnT1- %%k8<` FrrNrJr rrrrSrr) r3r4rrrPrprivateGetAssetDepositHistoryrrparse_transactions rgrrrSrsrrrrrs rifetch_depositszokx.fetch_deposits7s 88R\]& 44_dESXZ`a a   }}T*H%d^GEN   #EAIq 1GH   $GG 227GVL55dkk'66RSN~~h3&&tXueVLLrjc|jd|i}d}||j|}|d|d<|j|j||}|j |d}|j |di}|j ||S)a fetch data on a currency deposit via the deposit id https://www.okx.com/docs-v5/en/#rest-api-funding-get-deposit-history :param str id: deposit id :param str code: filter by currency code :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `transaction structure ` depIdNrJr rr)r3rrrr rvr) rgrJrrsrrrrrs ri fetch_depositzokx.fetch_deposits  R   }}T*H%d^GEN55dkk'66RSx0..q"-%%gx88rjc|jd}|j|dd\}}|r|jd||||Si}d}||j|}|d|d<|t |dz d|d <|||d <|j d ||\}}|j |j||}|j|d g} |j| ||||S) ad fetch all withdrawals made from an account https://www.okx.com/docs-v5/en/#rest-api-funding-get-withdrawal-history :param str code: unified currency code :param int [since]: the earliest time in ms to fetch withdrawals for :param int [limit]: the maximum number of withdrawals structures to retrieve :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 [availble parameters](https://github.com/ccxt/ccxt/wiki/Manual#pagination-params) :returns dict[]: a list of `transaction structures ` FrrNrJr rrrrSrr) r3r4rrrPr privateGetAssetWithdrawalHistoryrrrrs rifetch_withdrawalszokx.fetch_withdrawalss  88ASU_`& 445GuV[]cd d   }}T*H%d^GEN   #EAIq 1GH   $GG 227GVL88Wf9UV>~~h3&&tXueVLLrjc|jd|i}d}||j|}|d|d<|j|j||}|j |dg}|j |di}|j |S)a fetch data on a currency withdrawal via the withdrawal id https://www.okx.com/docs-v5/en/#rest-api-funding-get-withdrawal-history :param str id: withdrawal id :param str code: unified currency code of the currency withdrawn, default is None :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `transaction structure ` wdIdNrJr rr)r3rrrrrvr) rgrJrrsrrrr withdrawals rifetch_withdrawalzokx.fetch_withdrawals  B   }}T*H%d^GEN88Wf9UV,~~h3^^D!R0 %%j11rjciddddddddddd d d dd dd ddddddddddddddddd}|j|||S)Nz-3pendingz-2rrfailedrrrrrrrr+rrrr121516r~rs riparse_transaction_statuszokx.parse_transaction_statuss0 ) *  (                       )  ) )! " )# &&&99rjrcd}d}|j|d}|j|d}|j|d}|}|j|dd} |j|d| } |d}|}n|j|d}d }|j|d } |j| } |j|d } |j |j|d } |j|d }|j |d}d}|d k(rd}n|j|d}id|d|d| d| ddd|d|d|ddd| d| d| d|ddd|d|d |j |dd| |d!d"S)#Nrfromtorrrrrrr rrtxIdrrrrrJrrr addressFrom addressTortagFromtagTorrortxidrr)rr)internalrr)rpr_rrrrr)rgrrrorJ withdrawalIdrrrrr%rrrrrfeeCosts rirzokx.parse_transaction;s'P '' V< &&{F; $$[$7 "";v>"";?  #DB!!+w7BD%%k59 &&z2!!+u5..t/?/? W/UV V4%%k48  9 G&&{E:G K "    f  t  ;     w  t  U  5  f  D  t  D ! "  Y/# $ )  rjc||jd}|jd|\}}||j|dd}|dk7r|dk7rt|jdz|j |}|d|d}|j |j||}|j|d g}|j||S) a fetch the set leverage for a market https://www.okx.com/docs-v5/en/#rest-api-account-get-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' :returns dict: a `leverage structure ` NrrrisolatedzV fetchLeverage() requires a marginMode parameter that must be either cross or isolatedrJrrr) r3rrpr2rJrlprivateGetAccountLeverageInforrparse_leverage)rgryrsrCrlrrrs rifetch_leveragezokx.fetch_leverages  !??QWX F  ))&)WEJ ' ! j(@TWW'A AV$Tl! 55dkk'66RS~~h3""400rjrLcd}d}d}d}tdt|D]}||}|j|d}|j|d}|j|d} | dk(r|j |d}V| dk(r|j |d}n|j |d}|j |d}||j |||||dS) Nrrrrrrr)rryrC longLeverage shortLeverage)rrrrprr) rgrLrlrrCrrrentryrs rirzokx.parse_leverages   q#h-( BAQKE//yAJ''x8H11%CLv%#00@ ( $ 1 1% A #00@ $ 1 1% A  B&&x8$(*   rjc`|j|j|}|jd||\}}d|di}||j||d<|j |j ||}|j |dg}|j|d} | y|j| |S)a fetch data on a single open contract trade position https://www.okx.com/docs-v5/en/#rest-api-account-get-positions :param str symbol: unified market symbol of the market the position is held in, default is None :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.instType]: MARGIN, SWAP, FUTURES, OPTION :returns dict: a `position structure ` rrrJNrnrr) r3rlrrrxrrrrvparse_position) rgryrsrlrorrrrpositions rifetch_positionzokx.fetch_positions V$88&RXY e fTl   "&"A"A$"GGJ 224;;w3NO^~~h3>>$*  ""8V44rjc|ji}|jg}tdt|D],}||}|j|}|j |d.t|}|dkDrdj ||d<|j |jdi} |j| dd} d} | d k(r"|j|j||} n!|j|j||} |j| d g} g} tdt| D]%}| j |j| |'|j| d |j|d S) a https://www.okx.com/docs-v5/en/#rest-api-account-get-positions https://www.okx.com/docs-v5/en/#trading-account-rest-api-get-positions-history history fetch all open positions :param str[]|None symbols: list of unified market symbols :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.instType]: MARGIN, SWAP, FUTURES, OPTION :returns dict[]: a list of `position structure ` NrrJr`rrrr!privateGetAccountPositionsHistoryrryF)r3rrrlrrrvr`rprrrrrfilter_by_array_positionsr])rgr[rsr marketIdsrrrlmarketIdsLengthfetchPositionsOptionsrr positionsrs rifetch_positionszokx.fetch_positions$ss    I1c'l+ / U+  . /")nO"$'HHY$7! $t||=Mr R!!"7C_` 8 8==dkk'SY>Z[H66t{{7F7STH^NN8VR8 q#i.) =A MM$--il; < =--fh@S@ST[@\^cddrjc(|j|g|S)a https://www.okx.com/docs-v5/en/#rest-api-account-get-positions fetch all open positions for specific symbol :param str symbol: unified market symbol :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.instType]: MARGIN(if needed) :returns dict[]: a list of `position structure ` )r!rgryrss rifetch_positions_for_symbolzokx.fetch_positions_for_symbolzs##VHf55rjrc|j|d}|j||dd}|d}|j|d}tj|}|j |dd}|dk7}|j |} |drK|dk(r1|j|d } |j | } | |d | k(rd nd }|N|j|d}n;|9|dk(r4tj|d rd }ntj|d rd }nd}|j|d} |j| } |j|d}|j|d}|dr*tjtj|| |}|j |}|j|d}d}|j |dd}|j|d}|j|d}d}d}|dk(r)|j|d}tj||}n-|dk(r(tjd|}|j|d}|j|d}|j |}tj||}|'|j tj||d}n|tj||}d}|j tjtj||dd}|j|d}|j|d}|j tj|d }|j|d!} |j tj||d}!|jid"|d#|j|d$d|d%|d&|d'|d(|j |d)|j |d*|j|d*d+|d,| d| d-|j |d.|j|d/d0|d1|d2| |j!| |j|d3|||j ||j ||j ||j ||!ddd4 S)5Nrrryposr directionnetrXposCcyrrrrrrO notionalUsdr[rr openAvgPxuplrrimrr rmmrrz0.00005liqPxuplRatiorrrrJposIdr!rCliquidationPrice entryPrice unrealizedPnl realizedPnlrM contractsrS lastPrice closeAvgPxrprJrr) rrmaintenanceMarginmaintenanceMarginPercentage collateral initialMargininitialMarginPercentagerL marginRatiorFrG)rprrE string_absr_rfrr string_ltrrrr string_addr safe_positionr)"rgrrlrryr& contractsAbsrprJr6r)parsedCurrencyrcontractSizeStringmarkPriceStringnotionalStringr!rCinitialMarginStringentryPriceStringunrealizedPnlStringleverageStringr=collateralStringmaintenanceMarginStringr9!maintenanceMarginPercentageStringrounderr:r2percentageStringrMrr>s" rirzokx.parse_positions6F##Hh7!!(FD*E!x/))#. !!(I{C%%l3 ( u}))(H=!%!8!8!@!-&,Vn&F6WD|''+>5=((c2% **34&#''? !22<@**8X>))(MB ) $//0B0B,>?VXf,g) " *&*&7&78J8JK^`npq8r&s # (")"4"45Ln"] &*&7&78J8J7K]K]^BILJLOQR9S'T#++Hg>++HjA&&w'9'9:JE'RS %%h8 ''(:(:;RTdfg(hi !!# H# $""8W5#  f#   # * #  0 #  $++,<=#  T../BC#  4++HmD#  *#  #  L#  **?;#  ))(LA#  D# f!# " ## $ Y/#'#4#4Xw#G!2+F++,<=!../BC'+'8'89P'Q)).9&!#9#   rj fromAccount toAccountc|j|j|}|j|jdi}|j |||}|j |||} |d|j ||d|| d} |dk(r7d| d<| | d<|j |d d | d <|j |d d | d <n;| dk(r6d | d<|| d<|j |d d | d <|j |d d | d <|j |j| |} |j| d g} |j| di} |j| |S)a transfer currency internally between wallets on the same account https://www.okx.com/docs-v5/en/#rest-api-funding-funds-transfer :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 ` r6rJr)r rrorrmasterrrosubAcctrr+rrrr) r3rrvr`rpcurrency_to_precisionprivatePostAssetTransferrrparse_transfer)rgrrrQrRrsrr6fromIdtoIdrrr rawTransfers rirz okx.transfer%sp ==& 6FK!!.+{K 9ED>--dF;   X !GFO!%GI "..vvsCGFO ,,VT3?GDM X !GFO!'GI "..vvsCGFO ,,VT3?GDM00Wf1MN ~~h3nnT1b1 "";99rjrc^|j|dd}|j|d}|j||}|j|d}|j|d}|j|d}|j |j di} |j |d} |j|d } | $|jtj| }||| |j| |||j| ||j| ||j|j|d d S) NtransIdrr rrrr7rr2r) rrJrrrrrQrRr) r_rprrrvr`rrfrEr?rparse_transfer_status) rgrrrJr%rr fromAccountId toAccountIdr7r balanceChanges rirXzokx.parse_transfer`s.j  )X >%%h6 &&z8<!!(E2((6: &&x6 ~~dllNBG %%h5 ((48  $&&w'9'9-'HIF" Y/++L-H)), D001A1A(G1TU  rjc0ddi}|j|||S)Nsuccessrr~rs rir^zokx.parse_transfer_statuss% t &&99rjc|jd|i}|j|j||}|j|dg}|j |d}|j |S)Nr]rr)r3privateGetAssetTransferStaterrrvrX)rgrJrrsrrrrs rifetch_transferzokx.fetch_transfersl  r 44T[[&5QR*~~h3>>$*""8,,rjc|jd}ddi}||j|}|d|d<|||d<|||d<|j|j||}|j |dg}|j |||||S) aU fetch a history of internal transfers made on an account https://www.okx.com/docs-v5/en/#trading-account-rest-api-get-bills-details-last-3-months :param str code: unified currency code of the currency transferred :param int [since]: the earliest time in ms to fetch transfers for :param int [limit]: the maximum number of transfers structures to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict[]: a list of `transfer structures ` NrorrJr rrSr)r3rrrrparse_transfers) rgrrrSrsrrr transferss rifetch_transferszokx.fetch_transferss  C   }}T*H%d^GEN  $GG   $GG 55dkk'66RSBNN8VR8 ##IxvNNrjr GETct|t}d|jzdz|j||z}|j ||j |} |j |jdd|z} |dk(r| r| d|j| zz } n|dk(r|j|dk(r|d k(s |d k(s|d k(r|j|jd d } t|trUtdt|D]<} || } |j| d}|| |jz| d<| | d<| || <>n/|j|d}|| |jz|d<| |d<|j|j!}|j"|j$|d}||z|z}|dk(r!| r>d|j| z}| |z } ||z }n|s| r|j'| }||z }d|d<|j)|j+||j+|j,t.j0d}||d<| |||dS)Nz/api/r}rrr ?r POSTr rrr9r4rrr)z OK-ACCESS-KEYzOK-ACCESS-PASSPHRASEzOK-ACCESS-TIMESTAMPrkzapplication/jsonz Content-Typebase64zOK-ACCESS-SIGN)rrbodyheaders)rarrPimplode_paramsrqextract_paramsimplode_hostnamer urlencoderrpr`rrrrrrrjsonhmacencoderhashlibsha256)rgpathrrrsrqrpisArrayrrrr9rrrrauthurlencodedQuery signatures risignzokx.sign sbVT*DLL(3.1D1DT61RR &$"5"5d";<##DIIe$4V$<=G (?sT^^E222 I   + + -T-A%ATM_E_cgkxcx++DLL*FXYfd+"1c&k2. &q (,(8(8 (J (0/7$++-/GE),+3E%L(-F1I .%)$4$4VY$GM$,,4t{{},Dy)(0u  TZZ\2I!%(, '0Gv%/D&)DNN5,A&AO?*CO+De99U+DDLD*<' $++d"3T[[5Mw~~_ghI(1G$ %fdwOOrjc4|j|d}|j|d}|j||}|j|d}|j|d}|j|d}|j|d} t j | |} id|d|ddddd |j d d dd dd dd|j|dd|d|j|d|d|d|j|ddddddd|j| iS)NnextFundingTimernextFundingRaterrryrSrT interestRaterestimatedSettlePricerrrfundingTimestampfundingDatetimenextFundingTimestampnextFundingDatetimepreviousFundingRatepreviousFundingTimestamppreviousFundingDatetimeinterval) rrprrrE string_subrfrparse_funding_interval) rgrrlnextFundingRateTimestamprryrrfundingTimeStringnextFundingTimeStringmillisecondsIntervals riparse_funding_ratezokx.parse_funding_rate@s:$(#4#4X?P#Q ##Hh7!!(F3**85FG''-@  ,,X}E $ 0 0;L M&112GIZ[ H f    $  D--c2  #D       4++HmD     t||K8    #$<  "4<<0H#I  "4 '! " &t# $ 334HI%  rjc8dddddd}|j|||S)Nrrr16h24h)360000014400000288000005760000086400000r~)rgr intervalss rirzokx.parse_funding_interval|s/   8X>>rjc&|j||S)av fetch the current funding rate interval https://www.okx.com/docs-v5/en/#public-data-rest-api-get-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 ` )fetch_funding_rater#s rifetch_funding_intervalzokx.fetch_funding_intervals&&vv66rjc>|j|j|}|dst|jdzd|di}|j |j ||}|j |dg}|j|di}|j||S)am fetch the current funding rate https://www.okx.com/docs-v5/en/#public-data-rest-api-get-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 ` rYz2 fetchFundingRate() is only valid for swap marketsrrJrr) r3rlr,rJpublicGetPublicFundingRaterrrvr)rgryrsrlrrrrs rirzokx.fetch_funding_rates V$f~*^ ^_ _ fTl 224;;w3OP"~~h3tQ+&&uf55rjc b|jddi}|t||d<d}|;|j|}|d}|dr |drd|d<|d |d <n d |d<|d |d <|jd ||\}}|dk(r|j ||d<|j |j ||} |j| dg} g} tdt| D]} | | } |j| d}|j| d}|j|}|j| d }|j|}| j| |d|||j||j| d|j!| dd|j#| d}|j%||||S)aY fetch the history of funding payments paid and received on self account https://www.okx.com/docs-v5/en/#trading-account-rest-api-get-bills-details-last-3-months :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 ` rorNrSryrrZctTyperr r[rrrYrnrrrrrr)rryrrrrJrr)r3rbrlrrrxrrrrrrrprrrrrrr)rgryrrSrsrrlrorrrrrrrr marketInnerr%rrs rifetch_funding_historyzokx.fetch_funding_historys  C K X  "5zGG   [[(FH%Fj!(#(0GH%%+I%6GEN(1GH%%+H%5GEN889NPVX^_ e 6>"&"A"A$"GGJ 55dkk'56QR2~~h3q#d)$ AGE))%6I%%eX6F**62K))%7J**:6D MM%h/& LL3&&uh7**5(;   fk200NNrjc8|t|jdz|dks|dkDrt|jdz|j|j |}d}|j d|\}}||j |dd}|dk7r|d k7rt|jd z|||d d }|j |d d}|d k(r,|dk7r"|dk7r|dk7rt|jdz||d <|j|j||}|S)a< set the level of leverage for a market https://www.okx.com/docs-v5/en/#rest-api-account-set-leverage :param float leverage: the rate of leverage :param str symbol: unified market symbol :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.marginMode]: 'cross' or 'isolated' :param str [params.posSide]: 'long' or 'short' or 'net' for isolated margin long/short mode on futures and swap markets, default is 'net' :returns dict: response from the exchange Nz) setLeverage() requires a symbol argumentr}z3 setLeverage() leverage should be between 1 and 125rrrr zT setLeverage() requires a marginMode parameter that must be either cross or isolatedrJrrrrr(rrzR setLeverage() requires the posSide argument to be either "long", "short" or "net") r1rJr2r3rlrrpprivatePostAccountSetLeverager) rgrLryrsrlrCrrrs ri set_leveragezokx.set_leveragePsE >#DGG.Y$YZ Z qLhnTWW'\\] ] V$ !?? vV F  ))&)WEJ ' ! j(@TWW'}}~ ~!Tl  ""69e<  #& W%7Gu#DGG.[$[\ \ %%' ' ! j(@TWW'eef f V$##FGZ@ MuqyeckTWW'eef f6J<0!Tl  55dkk'66RSrjc|j|j|}|j|dg}g}tdt |D]%}|j |j ||'|S)a[ fetch the borrow interest rates of all currencies https://www.okx.com/docs-v5/en/#trading-account-rest-api-get-interest-rate :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a list of `borrow rate structures ` rr)r3privateGetAccountInterestRaterrrrparse_borrow_rate)rgrsrrrrs rifetch_cross_borrow_rateszokx.fetch_cross_borrow_ratesss 55f=~~h3q#d)$ :A LL//Q8 9 : rjc|j|j|}d|di}|j|j||}|j |dg}|j |di}|j |S)a fetch the rate of interest to borrow a currency for margin trading https://www.okx.com/docs-v5/en/#trading-account-rest-api-get-interest-rate :param str code: unified currency code :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `borrow rate structure ` r rJrr)r3rrrrrvr)rgrrsrrrrrs rifetch_cross_borrow_ratezokx.fetch_cross_borrow_rates ==& 8D> 55dkk'66RS~~h3~~dAr*%%d++rjc|j|d}|j|d}|j||j|ddd||j ||dS)Nr rrri\&)rrperiodrrr)rprrrr)rgrrr rs rirzokx.parse_borrow_rate4sgtU+%%dD1 //4&&t^VD" Y/   rjci}tdt|D]m}||}|j|j|d}||j ||s>||vrg||<|j |} ||} | j | ot|j} tdt| D]!}| |}|j|||||||<#|S)Nrr ) rrrrpin_arrayrrrrfilter_by_currency_since_limit) rgrcodesrrSborrowRateHistoriesrrrborrowRateStructureborrrowRateCoders riparse_borrow_rate_historieszokx.parse_borrow_rate_historiesHs%'q#h-( ` indexed by the market symbol rrSr)r3)publicGetFinanceSavingsLendingRateHistoryrrr)rgrrrSrsrrrs rifetch_borrow_rate_historieszokx.fetch_borrow_rate_historiesds     %GH   $GG AA$++gW]B^_~~h3//eUEJJrjc|j|j|}d|di}|||d<|||d<|j|j||}|j |dg}|j ||||S)a retrieves a history of a currencies borrow interest rate at specific time slots https://www.okx.com/docs-v5/en/#financial-product-savings-get-public-borrow-history-public :param str code: unified currency code :param int [since]: timestamp for the earliest borrow rate :param int [limit]: the maximum number of `borrow rate structures ` to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict[]: an array of `borrow rate structures ` r rJrrSr)r3rrrrparse_borrow_rate_history) rgrrrSrsrrrrs rifetch_borrow_rate_historyzokx.fetch_borrow_rate_historys ==& 8D>    %GH   $GG AA$++gW]B^_~~h3--dD%GGrjc|j|j|}|j|dd}|j|dg}|d|||d}|j |j ||}|j |dg} |j| di} |j|d} |j |j| |d| d k(rd iSd iS) Nrr(rJ)rrrorrrrrrrr) r3rlrprq'privatePostAccountPositionMarginBalancerrrvparse_margin_modification) rgryrrorsrlrrrrr errorCodes rimodify_margin_helperzokx.modify_margin_helpers V$""69e<6I;/Tl   ?? GU[@\]~~h3tQ+$$Xv6 {{499%H yC/dK   6>K   rjrc |j|dd}|j|d}d}|dk(rtj|drdnd}n|}tj|}|j|d}|j ||}|d r|d n|d } |j |d } ||d |d|j|| dd| |j| d S)Nr posBalChgror+raddreducerr[rrrryr ) rryrorCrrrrrr) r_rprErr?rrrfr) rgrrl amountRawtypeRawrorrresponseMarketrrs rirzokx.parse_margin_modifications`&&tUK@ ""40 c>#--i=58DD##I.##D(3))(F;)7 )B~f%W^H_%%dD1 $X.$''/" Y/  rjc*|j||d|S)a remove margin from a position https://www.okx.com/docs-v5/en/#trading-account-rest-api-increase-decrease-margin :param str symbol: unified market symbol :param float amount: the amount of margin to remove :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `margin structure ` rrrgryrrss ri reduce_marginzokx.reduce_margin!s((6JJrjc*|j||d|S)a add margin https://www.okx.com/docs-v5/en/#trading-account-rest-api-increase-decrease-margin :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 ` rrrs ri add_marginzokx.add_margin.s((GGrjc|j|j|}|drdn|j|d}|j|dd}|s |dk7rt |j dz|zd}|j d|\}}||j|d d }|||d }|dk(r|d |d <|j|j||}|j|dg} |j| |S)a  retrieve information on the maximum leverage, and maintenance margin for trades of varying trade sizes for a single market https://www.okx.com/docs-v5/en/#rest-api-public-data-get-position-tiers :param str symbol: unified market symbol :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.marginMode]: 'cross' or 'isolated' :returns dict: a `leverage tiers structure ` rWr0rorrz< fetchMarketLeverageTiers() cannot fetch leverage tiers for Nrrr)rnrrrJrr) r3rlrxrpr2rJrpublicGetPublicPositionTiersrrparse_market_leverage_tiers) rgryrsrlrorrCrrrs rifetch_market_leverage_tierszokx.fetch_market_leverage_tiers;s V$!&>xt/N/NvV\~/^vf~u5x +i!ilr!rss !??@Z\bc F  ))&(GDJ   8  &t GH 44T[[&5QR,~~h3//f==rjc fg}tdt|D]}||}|j|d}|j|j |d|j |||d|j |d|j |d|j |d|j |d|d |S) zs @ignore :param dict info: Exchange response for 1 market :param dict market: CCXT market rrtierrrmaxSzr.maxLever)rryr minNotional maxNotionalmaintenanceMarginRaterr)rrrprrrr)rgrrltiersrrrs rirzokx.parse_market_leverage_tiersqs0q#d)$ A7D''h7H LL))$7**8V<"7O#//g>#//g>)-)9)9$)F#//jA    rjc|jd}|jd|\}}||j|dd}d|i}d}||j|} | d|d<||dz |d<|||d <||j |}|d|d <|j |j ||} |j| d g} |j| } |j| |||S) a fetch the interest owed by the user for borrowing currency for margin trading https://www.okx.com/docs-v5/en/#rest-api-account-get-interest-accrued-data :param str code: the unified currency code for the currency of the interest :param str symbol: the market symbol of an isolated margin market, if None, the interest for cross margin markets is returned :param int [since]: timestamp in ms of the earliest time to receive interest records for :param int [limit]: the number of `borrow interest structures ` to retrieve :param dict [params]: exchange specific parameters :param int [params.type]: Loan type 1 - VIP loans 2 - Market loans *Default is Market loans* :param str [params.marginMode]: 'cross' or 'isolated' :returns dict[]: An list of `borrow interest structures ` NrxrrrJr rrrSrr) r3rrprrl privateGetAccountInterestAccruedrrparse_borrow_interestsr) rgrryrrSrsrCrrlrrrinterests rifetch_borrow_interestzokx.fetch_borrow_interests  !??@UW]^ F  ))&)WEJ z   }}T*H%d^GEN   % GH   $GG   [[(F &t GH 88Wf9UV(~~h3..t4228T5%PPrjrc |j|d}||j||}|j|d}||j|d|j|j|d|j |d|j |d|j |d|j|d||j |d S) Nrrryr rrliabr) rryrrramountBorrowedrCrr)rprrrrr)rgrrlrrs riparse_borrow_interestzokx.parse_borrow_interests!!$1  %%ff5F%%dD1 &&vx8//0@0@u0MN((z: ,,T>B"..tV<**4;" Y/  rjc(|j|j|}|d|j||dd}|j|j ||}|j |dg}|j |di}|j||S)a create a loan to borrow margin(need to be VIP 5 and above) https://www.okx.com/docs-v5/en/#trading-account-rest-api-vip-loans-borrow-and-repay :param str code: unified currency code of the currency to borrow :param float amount: the amount to borrow :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `margin loan structure ` rJborrow)r rrprr)r3rrVprivatePostAccountBorrowRepayrrrvparse_margin_loan) rgrrrsrrrrloans riborrow_cross_marginzokx.borrow_cross_margins ==&D>--dF;  55dkk'66RS ~~h3~~dAr*%%dH55rjc|j|j|dd}|j|d}|t|jdz|j |}|d|j ||d|d}|j|j||}|j|dg}|j|di} |j| |S)a repay borrowed margin and interest https://www.okx.com/docs-v5/en/#trading-account-rest-api-vip-loans-borrow-and-repay :param str code: unified currency code of the currency to repay :param float amount: the amount to repay :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.id]: the order ID of borrowing, it is necessary while repaying :returns dict: a `margin loan structure ` rJrqz, repayCrossMargin() requires an id parameterrepay)r rrprqrr) r3r_rqr1rJrrVrrrrvr) rgrrrsrJrrrrrs rirepay_cross_marginzokx.repay_cross_margin s    g 664( :#DGG.\$\] ]==&D>--dF;   55dkk'66RS ~~h3~~dAr*%%dH55rjcz|j|d}d|j|||j|dddd|dS)Nr r)rJrrryrrr)rprr)rgrrr%s rirzokx.parse_margin_loan6sO%%dE2 // HE&&tU3  rjct|j|j|}|dst|jdz|j |d}|j |dd}|||dd}|j |j||}|j|dg}|j|d |S) aj Retrieves the open interest of a currency https://www.okx.com/docs-v5/en/#rest-api-public-data-get-open-interest :param str symbol: Unified CCXT market symbol :param dict [params]: exchange specific parameters :returns dict} an open interest structure{@link https://docs.ccxt.com/#/?id=open-interest-structure: rz3 fetchOpenInterest() supports contract markets onlyrorrrJ)rnrrrr) r3rlr2rJrxrppublicGetPublicOpenInterestrrparse_open_interest) rgryrsrlrorrrrs rifetch_open_interestzokx.fetch_open_interestMs V$j!TWW'\\] ]..vf~>vf~u5Tl  33DKK4PQ ~~h3''Q88rjrc|j|jdi}|j|di}|j|||}|dk7r"|dk7r|dk7rt|jdz|j d}d} ||j vs||jvr|j|} | d}n|j|} | d }||d } d} d} |jd| |\} }| d k(r"|j|j| |} nT||| d <|j|d }||| d<|j|d g}|j|j| |} |j!| dg}|j#|d||S)aX Retrieves the open interest history of a currency https://www.okx.com/docs-v5/en/#rest-api-trading-data-get-contracts-open-interest-and-volume https://www.okx.com/docs-v5/en/#rest-api-trading-data-get-options-open-interest-and-volume :param str symbol: Unified CCXT currency code or unified symbol :param str timeframe: "5m", "1h", or "1d" for option only "1d" or "8h" :param int [since]: The time in ms of the earliest record to retrieve unix timestamp :param int [limit]: Not used by okx, but parsed internally by CCXT :param dict [params]: Exchange specific parameters :param int [params.until]: The time in ms of the latest record to retrieve unix timestamp :returns: An array of `open interest structures ` rrrrrzF fetchOpenInterestHistory cannot only use the 5m, 1h, and 1d timeframeNrrJ)r rr[rrrr)rvr`rpr2rJr3rrrlrrr*publicGetRubikStatOptionOpenInterestVolumerrrq-publicGetRubikStatContractsOpenInterestVolumerparse_open_interests_history)rgryrrrSrsr`rr%rlrrrorrrs rifetch_open_interest_historyzokx.fetch_open_interest_historyus../I2N^^G\2> $$ZIF  d!2yD7HTWW'oop p   dll "$2D2D(D[[(F)J}}V,H!$J 99:TV\^de f 8 FFt{{SZ\bGcdH #( %%fg6E !&6G95II$++V]_eJfgH~~h300tUEJJrjc x|j|d}|j||}|j|d}|j|d|}d}d}d}d} |j|jd} t |t rO| dk(r%|j |d}|j |d}n[|j |d} |j |d}n6|j |d}|j |d }|j |d } |j|j||||| ||j||d |S) Nrrrrr[rroiCcyoioiUsd)ryrQrRopenInterestAmountopenInterestValuerrr) rprrr`rarrsafe_open_interestrr) rgrrlrJtimerrQrRrrros rirzokx.parse_open_interestsW*  h 1!!"f-  40%%h48   !  m< h %x%)%5%5h%B"!--h: $($4$4Xq$A!"..x; ))(G` r`r r)r3 currency_idsrrrrparse_deposit_withdraw_fees)rgrrsrrcrrs rifetch_deposit_withdraw_feeszokx.fetch_deposit_withdraw_feess}   ##E*C XXc]GEN11$++gv2NOX~~h///e< &,7,C%$(  "&' #55iF .,F#D)*5kB1 8 $$7$<$<$>?q#234 wA'*D}}T*H(,(Q(QRefjRkmu(v  % w#"rjc,|t|jdz|j|j|}d}|j d||\}}|dk7r|dk7rt |jdz|j ||ddz|d zd }||d z |d <|||d <|j|j||}|j|dg} |j| |} |j| d} |j| |d||S)a fetches historical settlement records https://www.okx.com/docs-v5/en/#rest-api-public-data-get-delivery-exercise-history :param str symbol: unified market symbol to fetch the settlement history for :param int [since]: timestamp in ms :param int [limit]: number of records :param dict [params]: exchange specific params :returns dict[]: a list of `settlement history objects ` Nz4 fetchSettlementHistory() requires a symbol argumentrrZr[zC fetchSettlementHistory() supports futures and options markets onlyrr|r)rnrrrrSrrry) r1rJr3rlrrr;rx&publicGetPublicDeliveryExerciseHistoryrrparse_settlementsrr) rgryrrSrsrlrorrr settlementsrs rifetch_settlement_historyzokx.fetch_settlement_historyjs= >#DGG.d$de e V$99:RTZ\bc f 8  0tww)nno o77=(#c)F9,==    % GH   $GG >>t{{7TZ?[\&~~h3,,T6: k;7009I5RWXXrjcv|j|d}||j|||j|ddddS)NinsIdrn)rryr>rr)rprr)rg settlementrlrs riparse_settlementzokx.parse_settlementsI##J8&&x8%%j$7   rjc Vg}tdt|D]}||}|j|d}|j|dg}tdt|D]J}|j |||} |j |j | ||j|dL|S)Nrrr)rr)rrrrr3rrr) rgr.rlrrrrrr(r2s rir-zokx.parse_settlementssq#k*+ ANE))%6InnUIr:G1c'l+ !2271:vF  dkk*!* $ Y 77   rjcJ|jd}|jdd|\}}||dk(rd}|dk7r"|dk7r|dk7rt|jdzd|j |i}|j |j ||}|j|d g}|d S) a fetches the market ids of underlying assets for a specific contract market type https://www.okx.com/docs-v5/en/#public-data-rest-api-get-underlying :param dict [params]: exchange specific params :param str [params.type]: the contract market type, 'option', 'swap' or 'future', the default is 'option' :returns dict[]: a list of `underlying assets ` NrrWr[rYrZz7 fetchUnderlyingAssets() supports contract markets onlyrnrr)r3rrr;rJrxpublicGetPublicUnderlyingrr)rgrsrrr underlyingss rifetch_underlying_assetszokx.fetch_underlying_assetss  !??@WY]_ef F  J&$8!J ( "v)=JRZDZtww)bbc c 77 C 11$++gv2NOnnXvr: 1~rjc|j|j|}|d}|jd}|dd|dd|j|dd}|j |j ||}|j |dg}td t|D]2} || } |j| d } | |k(s |j| |cSy ) a fetches an option contracts greeks, financial metrics used to measure the factors that affect the price of an options contract https://www.okx.com/docs-v5/en/#public-data-rest-api-get-option-market-data :param str symbol: unified symbol of the market to fetch greeks for :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `greeks structure ` rJr|rrrr)rrrrrrN) r3rlrrppublicGetPublicOptSummaryrrrr parse_greeks) rgryrsrlrrrrrrr entryMarketIds ri fetch_greekszokx.fetch_greekss V$$<nnS) &>%( .6'' Q7  11$++gv2NO<~~h3q#d)$ 8AGE ,,UH=M(((77  8 rjgreeksc|j|d}|j|d}|j||}id|d|d|j|d|j |dd|j |dd|j |dd |j |d d dd dd dd |j |dd|j |dd|j |dddddddddd|dS)NrrryrrdeltagammathetavegarhobidSizeaskSizebidImpliedVolatilitybidVolaskImpliedVolatilityaskVolmarkImpliedVolatilitymarkVolbidPriceaskPricerSr7)underlyingPricer)rrprrr)rgr>rlrrrys rir;zokx.parse_greeks&s}0%%fd3 ##FH5!!(F3 f    Y/  T%%fg6  T%%fg6  T%%fg6   D$$VV4  4  t  t  #D$4$4VX$F  #D$4$4VX$F  $T%5%5fi%H     ! " # $ $'  rjc|j|j|}|j|d}|j|d}d}|jd|d\}}|d|d}||dk(rd |d <n|d k(rd |d <n||d <|||d <||j |} | d|d<|j |j ||} |j| dg} |j| d} |j| |S)aL closes open positions for a market https://www.okx.com/docs-v5/en/#order-book-trading-trade-post-close-positions :param str symbol: Unified CCXT market symbol :param str [side]: 'buy' or 'sell', leave in net mode :param dict [params]: extra parameters specific to the okx api endpoint :param str [params.clientOrderId]: a unique identifier for the order :param str [params.marginMode]: 'cross' or 'isolated', default is 'cross :param str [params.code]: *required in the case of closing cross MARGIN position for Single-currency margin* margin currency EXCHANGE SPECIFIC PARAMETERS :param boolean [params.autoCxl]: whether any pending orders for closing out needs to be automatically canceled when close position via a market order. False or True, the default is False :param str [params.tag]: order tag a combination of case-sensitive alphanumerics, all numbers, or all letters of up to 16 characters :returns dict[]: `A list of position structures ` rrNrcrrJrrrrrrrr rr) r3rlrprrprivatePostTradeClosePositionrrrvr9) rgryrprsrlrrrCrrrrrws riclose_positionzokx.close_positionWs*$ V$((A / !??QWY`a FTl!    %+ "%, "%) "  $!.GI   }}T*H%d^GEN55dkk'66RS$~~h3tQ'v..rjc|j|j|}d|di}|j|j||}|j |dg}|j |di}|j |d|S)a fetches option data that is commonly found in an option chain https://www.okx.com/docs-v5/en/#order-book-trading-market-data-get-ticker :param str symbol: unified market symbol :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: an `option chain structure ` rrJrrN)r3rlrXrrrv parse_option)rgryrsrlrrrr s ri fetch_optionzokx.fetch_options V$ fTl --dkk'6.JK6&"5vq"-  f55rjc|j|j|}|ddzdd}|j|j||}|j |dg}|j |ddS)a" fetches data for an underlying asset that is commonly found in an option chain https://www.okx.com/docs-v5/en/#order-book-trading-market-data-get-tickers :param str code: base currency to fetch an option chain for :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.uly]: the underlying asset, can be obtained from fetchUnderlyingAssets() :returns dict: a list of `option chain structures ` rz-USDr3)rrnrNr)r3rr`rrparse_option_chain)rgrrsrrrrs rifetch_option_chainzokx.fetch_option_chains{ ==&F#f,  ..t{{7F/KL6&"5&&vtX>>rjr c||j|d}|j||}|j|d}id|ddd|dd|d|j|ddd dd |j |d d |j |d ddddd|j |dddddddd|j |dddS)NrrrrryrrimpliedVolatility openInterestrMrArNrEmidPricerSr7r:rOrLrMrQr:rR)rprrrr)rgr rrlrrs rirTzokx.parse_optionsN*##E84!!(F3%%eT2  E   fX&     Y/     D  ((8  ((8      ))%8  t  d  $ $**5+>! " 4#  rjfromCodetoCodec|j|j|j|j|j|dd}|j|j ||}|j |dg}|j |di}|j|d|} |j| } |j|d|} |j| } |j|| | S)aL fetch a quote for converting from one currency to another https://www.okx.com/docs-v5/en/#funding-account-rest-api-estimate-quote :param str fromCode: the currency that you want to sell and convert from :param str toCode: the currency that you want to buy and convert into :param float [amount]: how much you want to trade in units of the from currency :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `conversion structure ` r)rrrfqSzCcyrfqSzrprrrr) r3rr$privatePostAssetConvertEstimateQuoterrrvrprparse_conversion) rgr]r^rrsrrrrfromCurrencyId fromCurrency toCurrencyId toCurrencys rifetch_convert_quotezokx.fetch_convert_quotes ~~'  (**62  <` r)rrrszCcyr2rprrrr) r3rprivatePostAssetConvertTraderrrvrprrc)rgrJr]r^rrsrrrrrdrerfrgs ricreate_convert_tradezokx.create_convert_tradeRs ''/  44T[[&5QR.~~h3a,))&)XF}}^4 '' FC ]]<0 $$V\:FFrjcz|jd|i}|j|j||}|j|dg}|j |di}|j |d}|j |d} d} d} ||j |} | |j | } |j|| | S)a fetch the data for a conversion trade https://www.okx.com/docs-v5/en/#funding-account-rest-api-get-convert-history :param str id: the id of the trade that you want to fetch :param str [code]: the unified currency code of the conversion trade :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `conversion structure ` clTReqIdrrrrN)r3privateGetAssetConvertHistoryrrrvrprrc) rgrJrrsrrrrrdrfrergs rifetch_convert_tradezokx.fetch_convert_trades   55dkk'66RS,~~h3a,))&)<'' ;    %==8L  #|4J$$V\:FFrjc|ji}|jd||\}}|||d<|||d<|j|j||}|j |dg}|j ||dd||S)a fetch the users history of conversion trades https://www.okx.com/docs-v5/en/#funding-account-rest-api-get-convert-history :param str [code]: the unified currency code :param int [since]: the earliest time in ms to fetch conversions for :param int [limit]: the maximum number of conversion structures to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :param int [params.until]: timestamp in ms of the latest conversion to fetch :returns dict[]: a list of `conversion structures ` rrrSrrr)r3rrorrparse_conversions)rgrrrSrsrrrowss rifetch_convert_trade_historyzokx.fetch_convert_trade_historys 227GVL   %GH   $GG 55dkk'66RS,~~h3%%dD)ZPUVVrj conversionrergc z|j|dd}|j|d}|j||}|j|d}|j||}|||j||j |gd||j |dd||j |dd |j |d d dd S) N quoteTimerrr)clQReqIdrlrbaseSz fillBaseSzquoteSz fillQuoteSzcnvtPxrm) rrrrJre fromAmountrgtoAmountr>r)rrprrrr) rgrurergrfromCoinr]rr^s rirczokx.parse_conversionsj'' KF ##J :**8\B   j* 5((Z8" Y/$$Z1ST$,,Z<P **:y-P'' HhG  rjcv|j|j|}i}|j|dg}tdt |D]j}||}|j |d}|j |}|||dddddddd|j|d|j|ddddddddddd ||<l|S) a6 fetches all available currencies that can be converted https://www.okx.com/docs-v5/en/#funding-account-rest-api-get-convert-currencies :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: an associative dictionary of currencies rrr NrrPr)rrr) rrJrrrorKrrrrrrr)r3 privateGetAssetConvertCurrenciesrrrrprr) rgrsrrrrrrJrs rifetch_convert_currencieszokx.fetch_convert_currencies,s 88@~~h3q#d)$ AGE!!%/B**2.D  ! $//u=#//u= $#! $#   5F4L  @ rjhttpCodereasonrrrqrpc |sy|j|d} | dk7r| dk7r|jdz|z} |j|dg} tdt | D]k} | | }|j|d}|j|d}|j |j d || |j|j d || m|j |j d | | t| y) Nrrr rrrsMsgrr) rprJrrrthrow_exactly_matched_exceptionrthrow_broadly_matched_exceptionr,)rgrrrrrqrprrequestHeaders requestBodyrfeedbackrrerrorrmessages ri handle_errorszokx.handle_errorshs*&1 CKdckww}t+H>>(FB7D1c$i( bQ ,,UG< **5&944T__W5MyZbc44T__W5MwX`a  b  0 01I4QY Z) )rjc|j|j|d}|t|jdz|dk(}|rdnd}|r |rd}nt |jdz|z|d d } |j |d } |j |d }||| d <||| d <| | | d<d} |j} | dz } | dz }||| kDr"|j|j| |} n?||kDr"|j|j| |} nt |jdz|j| d}|j|}|j||||S)aF fetches the history of margin added or reduced from contract isolated positions https://www.okx.com/docs-v5/en/#trading-account-rest-api-get-bills-details-last-7-days https://www.okx.com/docs-v5/en/#trading-account-rest-api-get-bills-details-last-3-months :param str [symbol]: not used by okx fetchMarginAdjustmentHistory :param str [type]: "add" or "reduce" :param int [since]: the earliest time in ms to fetch margin adjustment history for :param int [limit]: the maximum number of entries to retrieve :param dict params: extra parameters specific to the exchange api endpoint :param boolean [params.auto]: True if fetching auto margin increases :returns dict[]: a list of `margin structures ` autoNz8 fetchMarginAdjustmentHistory() requires a type argumentr160161162z* cannot fetch margin adjustments for type r )subTyperrrrSendTimei $lXzS fetchMarginAdjustmentHistory() cannot fetch margin adjustments older than 3 monthsr)r3rr1rJr2rrqrrrrrparse_margin_modificationsr)rgryrorrSrsrisAddrrrrr oneWeekAgothreeMonthsAgor modificationss rifetch_margin_adjustment_historyz#okx.fetch_margin_adjustment_historys ~~ff- <#DGG.h$hi i  %e  +W!WZ^!^__! !!&'267+  #(GK  $GG   !&GI !9_ z) Muz1224;;w3OPH ^ #99$++gv:VWHTWW'||} }V~~h/77= 00uUUrjc|j|j|d}|j|d}|j|gd}|d}d|i}|,t |}|dk(r|j |d} | d|d <|||d <|||d<|j |j||} |j| d } |j| ||} |j| ||S) u~ fetches historical positions https://www.okx.com/docs-v5/en/#trading-account-rest-api-get-positions-history :param str [symbols]: unified market symbols :param int [since]: timestamp in ms of the earliest position to fetch :param int [limit]: the maximum amount of records to fetch, default=100, max=100 :param dict params: extra parameters specific to the exchange api endpoint :param str [params.marginMode]: "cross" or "isolated" EXCHANGE SPECIFIC PARAMETERS :param str [params.instType]: margin, swap, futures or option :param str [params.type]: the type of latest close position 1: close position partially, 2：close all, 3：liquidation, 4：partial liquidation; 5：adl, is it is the latest type if there are several types for the same position :param str [params.posId]: position id, there is attribute expiration, the posid will be expired if it is more than 30 days after the last full close position, then position will use new posid :param str [params.before]: timestamp in ms of the earliest position to fetch based on the last update time of the position :param str [params.after]: timestamp in ms of the latest position to fetch based on the last update time of the position :returns dict[]: a list of `position structures ` rCrn)rrCrnrrSrrrJrrr) r3rpsafe_string_upperrqrrlrrrparse_positionsfilter_by_since_limit) rgr[rrSrsrCrnr symbolsLengthrlrrr s rifetch_positions_historyzokx.fetch_positions_historys ( %%fl; ))&*=6#FG =E U   LM!WQZ0$*4L!  !!+GI   "*GJ 99$++gv:VWD~~h/((w? )))UEBBrjrc |j|j|}d|di}|j|dd}|j|d}|||d<|||d<|||d<|||d<|j |j ||} |j | dg} g} td t| D];} | | } | j|j| d |j| d d =|j| |S) a  fetches the long short ratio history for a unified market symbol https://www.okx.com/docs-v5/en/#trading-statistics-rest-api-get-contract-long-short-ratio :param str symbol: unified symbol of the market to fetch the long short ratio for :param str [timeframe]: the period for the ratio :param int [since]: the earliest time in ms to fetch ratios for :param int [limit]: the maximum number of long short ratio structures to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :param int [params.until]: timestamp in ms of the latest ratio to fetch :returns dict[]: an array of `long short ratio structures ` rrJrrrrrSrrr)rlongShortRatio) r3rlr_rq8publicGetRubikStatContractsLongShortAccountRatioContractrrrrrrpparse_long_short_ratio_history)rgryrrrSrsrlrrrrrrrs rifetch_long_short_ratio_historyz"okx.fetch_long_short_ratio_history7 s5 V$ fTl ""67E:67+  "GEN  )GH   $GG   $GG PPQUQ\Q\]dflQmn~~h3q#d)$ AGE MM!--eQ7"&"2"25!"<   2266BBrjc |j|d}d}||d}||||j|d|j|ddS)Nrryr)rryrrrr)rrr)rgrrlrrys riparse_long_short_ratiozokx.parse_long_short_ratioj s\%%dK8   H%F" Y/"..t5EF   rj)NNNN)N)NN)__name__ __module__ __qualname__rrerbrrrrxrr!r)rrrrr+rrrrdictrrr r.rr6r#rVrZr"r$rdrgrir&rrrrrrrrrr'rrrrfloatrrrrrr5rrrCrTrXr^rdr[rrprvrrr9rrrrrrrrrr rrrrrr(rrrrrrrrrrrr r!r$rr*rrXr^rfrjrr%rrrrrrrboolrrr rr rrrrrrrrrrrrrrrrrrrr rrrrrr/r3r-r8rr=r;rRrrUrrXrTr rhrlrprtrcrintrrrrrr __classcell__)rhs@rirGrG'sU #U n(OS[]lphhVhuxh;; 3; zUCUURUUjmUzIU#%4l!#.s..%'*4=*XD$&$v,*N 4N FN `2450n')|Z||:>b5?s5?35?Y5?nH4HH6HT02,03,0f,0\04B54W54754n46BsB&BB4844w4:XXvXXt6:UWG=3G=sG=#G=\`af\gG=R  4 426DW[df]H#]Hc]HQT]Hkoptku]H~8<$]ajl@Y@YC@YWZ@YD8 )2 ) T 6 EX 057-5-5;N-5^$&{@({@zRT``5`*SUaaEa*os{}b,3b,ib,yb,Z_b,hkb,Hgksu939i9y9RW9`c9v@B/'D$6/'bFJQU^`J,SJ,X`drv@B?S?#?Y?i?Y\?lo?B37r&/s&/C&/P 04BYIYIvSUJG5H0IJGX<>s: : :DDvDDL26bO/cO/3O/b/3TXacZ=Z=3Z=cZ=hlmrhsZ=x37TX\egm=Cm=sm=RUm=^154VZcen=#n=Sn=PSn=jnotjun=`-1tRV_aBDcBDBDCBDH9=4^bkmXSX#XSXX[X,(,$TZ\p?p?Cp?sp?aefqarp?d3 BtBxB;BH] h] R`] ~DF(0s(0$~J^(0T79/#/^/<DHPR9=S9=%9=#9=Wb9=v*.Dt\^KM3KMcKMKMcghsctKMZ26b99390-1tRV_aCMcCMCMCCMfjkvfwCMJ59+23+2c+2Z+:s+:Z[ T[ X[ Q\[ z24'1S'1'1R t V x 224H5SH5T26bTewTeT(^Tel>@ 6 6\ t\ V\ |[]9:S9:%9:c9:c9:an9:vJ tJ xJ =J X:C:C: 37r--C-m->+/TPT]_:OC:Os:O#:Odhivdw:Ox&eBSW1Pf: 6: [: x?:< 7S 7 768$6$6K$6L37TX\egVOCVOsVORUVOp9=R4S4#4l15R # @=AcB>B"-#-s-^/15E:9;,C,,B  (#8154VZce'KS'KPS'KRAESW`b(Hc(H#(HS(HTFH 3 L^ BG dG FG N`G R@B KC K KFX K=? H He HCU H?A4>#4>T,EW4>l&&$|J\&P15DW[jnwy8Q#8Qc8QQT8Qdg8QCDRS8Qt $  . "DF$6$6U$6L<>*6s*6X  .79&9#&9PBFTXgktv>K#>Kc>Kad>K@2F2hJtJ<@<=<=|9#v6:[_hj2Ys2Y#2YUX2Yh "4.0"H02737f7r/ 4/ / 6/ b=A</S</ </PU</|02,63,6f,6\46-?s-?+-?^* $* (* 6* ]c* XMQY[2GC2G2Gc2G`j2GhW[ce3Gs3Gc3G33GPS3Gjt3Gj8D_clnJCwJCcJCY\JCswyAtBJCX<@RVeix|FH1CS1CC1C_b1Cru1CMQR`Ma1Cf  4    >  rjrG)Lccxt.base.exchangerccxt.abstract.okxrryccxt.base.typesrrrrr r r r r rrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*typingr+ccxt.base.errorsr,r-r.r/r0r1r2r3r4r5r6r7r8r9r:r;r<r=r>r?r@rArBrCccxt.base.decimal_to_precisionrDccxt.base.preciserErGrjrirs ()ZZZZZZZZZZ*0-.-.'&.4.+)*0))+.1*)+*4%OA (KOA rj