eiF hddlmZddlmZddlZddlZddlmZmZm Z m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZm Z m!Z!ddl"m#Z#ddl$m%Z%ddl$m&Z&ddl$m'Z'dd l$m(Z(dd l$m)Z)dd l$m*Z*dd l$m+Z+dd l$m,Z,ddl-m.Z.ddl-m/Z/ddl-m0Z0ddl-m1Z1ddl2m3Z3GddeeZ4dS))Exchange) ImplicitAPIN)AnyBalances CurrenciesCurrencyInt LedgerEntryMarginModificationMarketNumOrder OrderBook OrderRequestCancellationRequest OrderSide OrderTypePositionStrStringsTickerTickers FundingRate FundingRatesTradeTradingFeeInterface TransactionMarketInterface TransferEntry)List) ExchangeError)ArgumentsRequired) BadRequest)InsufficientFunds) InvalidOrder) OrderNotFound) NotSupported)RateLimitExceeded)ROUND)DECIMAL_PLACES)SIGNIFICANT_DIGITS) TICK_SIZE)Precisec eZdZdeffd ZfdZdedeffd ZifdZ ifdZ ifde fdZ ifde efd Zifde efd Zifde efd Zd ed edefdZifde efdZdedefdZdedefdZifdefdZdifdededefdZdifdedefdZdifdede fdZ!ddede"fdZ#ddedede$fdZ%dddifded ed!edede e&f d"Z'ddede&fd#Z(ddifde)d!edefd$Z*d%Z+dedefd&Z,d'Z-d(Z.d)Z/dd+Z0dd,Z1dde2fd-Z3d.Z4d/Z5d0Z6d1Z7d2Z8d3Z9d4Z:d5Z;d6ed7efd8Zdd;ifdZ?ifd?efd@Z@ifdAeAfdBZBifd?efdCZCdifdedDeDdEeEdFed eFf dGZGifdedEeEdFedHedeHf dIZIifdJe eJfdKZKdifdedDeDdEeEdFed e)f dLZLifdefdMZMdifdNede)fdOZNdifdPe ede)fdQZOdifdNede)fdRZPdifdPe ede)defdSZQifdJe eRfdTZSifdUefdVZTifdWZUddifdNededDedEedFeFd eFf dXZVifdJe eJfdYZWifdZed[ed\eXfd]ZYdddifde)d!edefd^ZZd_Z[dddifde)d!edede eHfd`Z\dddifde)d!edede eHfdaZ]dddifde)d!edede eHfdbZ^dddifde)d!edede eHfdcZ_dddifde)d!edede eHfddZ`difdNede)fdeZaddfededeHfdgZbdhe)fdiZcdjZddddifde)d!edefdkZeddlededeffdmZgifdefdnZhddoedefdpZidifdede ejfdqZkddredefdsZldifdtede)fduZmdifdveXde)fdwZnifdedFedeofdxZpifdedFedeofdyZqifdedeofdzZrdd{ededeofd|ZsifdedFed}ed~edetf dZuddedevdetfdZwdifdedFed=ede)dexf dZyddedevdexfdZzifdede{fdZ|ddedede{fdZ}dddifde)d!edede e~fdZddedevde~fdZdZdddifde)d!edefdZdddifde)d!edede exfdZdifdefdZifdefdZddefdZdddifde)d!edefdZddefdZifdeFdefdZifdZefdZgfdZdd=e)fdZdoedefdZde)fdZdeXdededd d?d d@ddAddBddCd idDddEddFddGddHddId dJddKddLd dMd dNd dOddPd dQd dRd dSd dTd idUddVd dWddXd dYddZdd[d d\d:d]d d^d d_d d`d daddbddcddddded d ddd d d dd d df dgdhdidjdkdldmdndodpdqdrdsdtdudvdwdxdydzd{d{d|d}d}d|d~dddddddddddddddddiidddiid|d|d|dd|d|ddddddd d ddiidt dt dt dt dt dt dt dt dtdt dt dt dt dt dt dt dt ttdddtiddd dddgdddddddddddddd gddgdddd ddddddddddd d d dœd dd ddÜddddddddĜddiddddd dȜdddd dɜddddd dʜddddddd d˜dddddddd d̜ddidϜ ddidd d ddҜdӜddiddid՜ddiddid՜d֜dd؜S)Nidr/name Hyperliquid countriesversionv1 rateLimit2 certifiedTprodexhasCORSspotmarginFswapfutureoption addMarginborrowCrossMarginborrowIsolatedMargincancelAllOrderscancelAllOrdersAfter cancelOrder cancelOrderscancelOrdersForSymbolscloseAllPositions closePositioncreateMarketBuyOrderWithCostcreateMarketOrderWithCostcreateMarketSellOrderWithCost createOrder createOrders$createOrderWithTakeProfitAndStopLosscreateReduceOnlyOrdercreateStopOrdercreateTriggerOrder editOrder editOrders fetchAccounts fetchBalancefetchBorrowInterestfetchBorrowRateHistoriesfetchBorrowRateHistoryfetchCanceledAndClosedOrdersfetchCanceledOrdersfetchClosedOrdersfetchCrossBorrowRatefetchCrossBorrowRatesfetchCurrenciesfetchDepositAddressfetchDepositAddresses fetchDepositsfetchDepositWithdrawFeeemulatedfetchDepositWithdrawFeesfetchFundingHistoryfetchFundingRatefetchFundingRateHistoryfetchFundingRatesfetchIndexOHLCVfetchIsolatedBorrowRatefetchIsolatedBorrowRates fetchLedger fetchLeveragefetchLeverageTiersfetchLiquidationsfetchMarginModefetchMarketLeverageTiers fetchMarketsfetchMarkOHLCVfetchMyLiquidations fetchMyTrades fetchOHLCVfetchOpenInterestfetchOpenInterestHistoryfetchOpenInterestsfetchOpenOrders fetchOrderfetchOrderBook fetchOrdersfetchOrderTrades fetchPositionfetchPositionModefetchPositionsfetchPositionsRiskfetchPremiumIndexOHLCV fetchStatus fetchTicker fetchTickers fetchTime fetchTradesfetchTradingFeefetchTradingFees fetchTransferfetchTransfersfetchWithdrawalfetchWithdrawals) reduceMarginrepayCrossMarginrepayIsolatedMarginsandbox setLeverage setMarginModesetPositionModetransferwithdraw timeframes1m3m5m15m30m1h2h4h8h12h1d3d1w1M)rrrrrrrrrrrrrrhostnamezhyperliquid.xyzurlszQhttps://github.com/ccxt/ccxt/assets/43336371/b371bc6c-4a8c-489f-87f4-20a913dd8d4bzhttps://api.{hostname})publicprivatez#https://api.hyperliquid-testnet.xyzzhttps://hyperliquid.xyzzBhttps://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/apiz+E?_@)%A_B/C_D&tE___F$TG_H'I_J(K_L"4M_N&uO_P(Q_R S_T*:U_V+EW_X&tY_Z#E[_\*4]_^$T__`"5a_b*5c_d+Ee_ftg___h i_j%ek_l$Um_n"4o_p+Eq_rs_t!%u_v&uw_x y_zd{_|$T}_~+E_@%dA_B"4C_DdE_F!$G_HtI___J#EK_L M_N$UO_P!$Q_R%eS_T)%U_VtW_XzY_Z[_\T]_^t__`"4a_b#Ec_d e_f!%g_h"5i_j#Dk__l!%$)',#!%#(  }___WF R SWF r )sWF t k67 DD1[V:uWF R $&*++,67/0:;2323'' ! ! ""A#SWF @ !..y99!..y99 "..x88!..x88  AWF T "!%" $$UWF ` ;\:L:;LA,  F|  TUa +L? KM*<-lXYe+L67H:;L >?P!"YZf#$LY9J'aWF R YSWF T! &$"#'&8:P%QK #!!'%#!###! ( (655!#!#!!-@ $&+(-,0,1).+0).(-).11 -1$(%) 7 7$(#("&#( (( #($)$)+027/4#(;$$@t%',!%$(%)*. &&',#($)*. ##',!%#($)*. ((',!%$(%)#($)*.$$',!%$(,0%)#($)*. * * #WNN`y ))-+/6:$$":":  ":":  GkkX"%m WF WF WF W W W cltt||||jd<dS)Nr)r"r/set_sandbox_moder)r%enabledr&s r'r*zhyperliquid.set_sandbox_modews3 k4  11':::&- ]###r(symbolc|jt|jdz|||jvr|d}||d}||jdi}||vr]|||}||d}||dz|z}||jvr |j|Stt| |S)Nz markets not loaded/rrr) marketsr!r2split safe_string safe_dictrsafe_currency_coder"r/market) r%r, symbolPartsbaseNamerunifiedBaseNamequote newSymbolr&s r'r4zhyperliquid.market{s < *? ?@@ @  4<)?)? ,,s++K'' Q77H"&..?TVX"Y"Y ..."&"2"23F"Q"Q((a88 33ODDsJUR  ,,< 22[$''..v666r(cKddi}||||d{V}||d}|dnd||ddd|dS) a  the latest known information on the availability of the exchange API :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a `status structure ` rrNspecialStatusesok maintenancetime)statusupdatedetaurlr)publicPostInfoextendr1 safe_integer)r%paramsrequestresponser?s r' fetch_statuszhyperliquid.fetch_statuss $ ,,T[[&-I-IJJJJJJJJ !!(,=>>%~ddM((6::    r(cKddi}||||d{V}||dS)a fetches the current integer timestamp in milliseconds from the exchange server :param dict [params]: extra parameters specific to the exchange API endpoint :returns int: the current integer timestamp in milliseconds from the exchange server rrNr>)rCrDrE)r%rFrGrHs r' fetch_timezhyperliquid.fetch_timesb $ ,,T[[&-I-IJJJJJJJJ  6222r(c,K|dr|d{Vddi}||||d{V}||dg}i|jd<i}t dt|D]m}|||i}| |d}| |d } | | } | |jd|<| || | | | |d |dddddd ddd ddd d d || <| |d} | | | do| d} | rg| d} d}t dt| D] }|| |z}| |}||jd| <o|S)aX fetches all available currencies on an exchange https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-metadata :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: an associative dictionary of currencies FNrspotMetatokensrrrr3 weiDecimalscryptominr)amountr) r2r3code precisionractivedepositrnetworksfeerlimitsfullNamezUnit Ur)check_required_credentialsinitialize_clientrCrD safe_listrrangelenr2r1r3safe_currency_structureparse_precision startswithr0)r%rFrGrHrNresultidatar2r3rTr[ isWrappedparts nameWithoutUjbaseCodes r'fetch_currencieszhyperliquid.fetch_currenciess  * *5 1 1 +((** * * * * * * * J ,,T[[&-I-IJJJJJJJJ (B77/1 +,q#f++&&( I( IA>>&!R00D!!$00B##D&11D**400D7;DL/ 0 477!11$2B2B42W2WXX    $# $#!!  99F4L0''j99H#(8$//88QT__S=Q=Q I JJsOOE#%L"1c%jj11??'3eAh'> #66|DDH@HDL!67= r(c~K||jdi}||d}g}tdt |D]}||}|dkr)|||9|dkr)|||h|dkr(|||tj |d{V}g}tdt |D]}| |||}|S)a retrieves data on all markets for hyperliquid https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-asset-contexts-includes-mark-price-current-funding-open-interest-etc https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-spot-asset-contexts :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict[]: an array of objects representing market data rwrrrAr?rN) r2rr`rarbappendfetch_swap_marketsfetch_spot_marketsfetch_hip3_marketsasynciogather array_concat) r%rFrr rawPromisesrg marketTypepromisesrfs r' fetch_marketszhyperliquid.fetch_marketssQ..~rBBw00 q#e**%% D DAqJV##""4#:#:6#B#BCCCCv%%""4#:#:6#B#BCCCCv%%""4#:#:6#B#BCCC 5555555q#h--(( < >(Ar22D"..t5FGGO~~dJ;;HxB77IF1c(mm,, $ ${{NN8Q33NN9a44"&!V!4!4X*9&'#V %U #'>>$,@VXZ#[#[ "&666++D&99D*.*:*:;K_*]*]'2ED./#66t<>DL!34T: d####''1C1CF1K1KLLGG@r(c Kddi}||||d{V}||di}||dg}||dg}g}t dt |D]\}||||i|||i} || d<|| ]||S)a retrieves data on all swap markets for hyperliquid https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-asset-contexts-includes-mark-price-current-funding-open-interest-etc :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict[]: an array of objects representing market data rr~Nrrrr)rCrDr2r`rarbrpr) r%rFrGrHrrrrfrgrhs r'rqzhyperliquid.fetch_swap_marketss & ,,T[[&-I-IJJJJJJJJ@~~h2..>>$ B77NN8Q33 q#h--((  A;;xB//y!R00DDN MM$    !!&)))r(ramountPrecision maxDecimalscd}||}|dS|d}tj|drd}d}t ||z ||z }ntj|drtj|drwd}||dd} d} | t| kr0| | dkr$| dz} | t| kr | | dk$| |z}t ||z |}nW||dd} tdt| }t ||z |t| z }| |S) an Helper function to calculate the Hyperliquid DECIMAL_PLACES price precision :param float price: the price to use in the calculation :param int amountPrecision: the amountPrecision to use in the calculation :param int maxDecimals: the maxDecimals to use in the calculation :returns int: The calculated price precision rN.01rr]) number_to_stringr0r- string_eqrR string_gt string_ltr1rbr parse_to_int) r%rrrpricePrecisionpriceStr priceSplittedsignificantDigits integerDigits decimalPart leadingZeros integerParts r'calculate_price_precisionz%hyperliquid.calculate_price_precisions((//  1 s++  Xs + + f ! M !>@QTa@abbNN  x - - f'2CHc2R2R f ! **=!R@@KL3{#3#333+l:SWZ:Z:Z+a/  3{#3#333+l:SWZ:Z:Z*,==N !>OONN**=!R@@K #As;'7'7 8 8  !>@QTWXcTdTd@deeN  000r(cKddi}||||d{V}||di}||dg}||dg}||dg}g}t dt |D]S} ||| i} || d} ||| i} || d } ||jd i}| |d }| |d }|| dg}||d}||d}|||i}|||i}||d }||d }||H||j d i}||||}||||}| |}| |}|dz|z}||d|}||d}t|} | | d}!d}"|!| |!| d}"||"}#|| dz}$id| d|d|d|ddd|$d|d|dddd d dddddd d!d"d!d#d!d$dd!dd||ddddd||||||#d%ddd&ddd&ddd&|d'dd&d(d|| | d)}%|||%U|S)*a\ retrieves data on all spot markets for hyperliquid https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-spot-asset-contexts :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict[]: an array of objects representing market data rspotMetaAndAssetCtxsNrrrrNrr3r?rrrr.spec szDecimalsmidPxr}r2r,baser8settlerr6quoteIdsettleIdTsubTyper@rAFrBrCrVrSrrQ10r rSrr)contractrrrr contractSizeexpiryexpiryDatetimestrike optionTyperUrZcreatedr)rCrDr2r`rarbrEr1r safe_numberrr3intrrr$rdrpsafe_market_structure)&r%rFrGrHfirstsecondrrNr/rgr4r extraData marketNamerrr tokensPos baseTokenPos quoteTokenPos baseTokenInfoquoteTokenInfor6rrmappedBaseName mappedQuoteId mappedBase mappedQuote mappedSymbolinnerBaseTokenInfoamountPrecisionStrrrrpricePrecisionStrrentrys& r'rrzhyperliquid.fetch_spot_marketss  * ,,T[[&-I-IJJJJJJJJZxB//!R00~~eZ44x44q#d))$$` >` >A^^D!R00F%%fg66Evub99I))&&99J>>$)VR88D$$T733E$$T733Evx<>H&&~v>>G7?#'..?TVX"Y"Y !--.A8XVVN ,,-@'7SSM00@@J11-@@K%+k9L!% v}!U!U !%!1!12Dl!S!S !"455O$$Y88EN !%!?!?XY!Z!Z $ 5 5n E E **55=99F4j4,4 4 4 $ 4 & 4H474D44444$44%4 %!4"$#4$" $"&""//0D0DEW0X0XYY!..t/C/CDU/V/VWW $#!! $# $# $0066#$  Iv66g444Ej NN455e<< = = = =r(r4c||d}|dn|}|dn|}||d}||}|dd}||}||d}||} |dz|z} d} d} | r | r| dz| z} ||jd i} || d }|| d }||d }t |}||d d}d}||||d}||}| |d}d}|| }| id|d| d|d|d| d|d|d|d|dd ddddd | ddddd|d | dd||| d!dddd| | || | |d"d| |d#d$ddd$ddd$| d%dd$d&d|d' S)(NrUSDCr3rrrr.TrArrrmarkPxr isDelistedr2r,rr8rr6rrrr?Fr@rBrCrVrrr maxLeveragerQrr) rrrrrrrrrrUrZrr)r1r3rr2rrrrr safe_boolrr$rdrE)r%r4rrrr6rr8rrr,rrArrrrrrrrrrVs r' parse_marketzhyperliquid.parse_markets,#..v7LMM08&&?R1966@S##FF33&&x00||C%%''00!!&(33((22e#  / /#.~~di44  w//  w//!--flCC011  155  !;;E?TUVVN 11.AA^^FL99   !#^F))3+ &3+ f3+  D3+  U 3+ f 3+ f 3+  3+  w3+  3+  F3+  E3+  d3+  D3+  e3+  e3+ f!3+ " #3+ $ --c22"++D,@,@AS,T,TUU**4+?+?@Q+R+RSS  ,,V]CC      ,,T22$e3+ 3+ 3+ 3 3 3 r(rTcp||S||jdi}||||S)Nr)r2rr1)r%rTrs r'update_spot_currency_codez%hyperliquid.update_spot_currency_codes? <K"nnT\;PRTUU 3T4@@@r(cHK||ddduo||ddu}d}|d|\}}d}|dd|\}}d}|d|\}}d}|d|||d{V\}}||d}|dks|o|du}|rdnd |d } ||| |d{V} | | d } | d | i} td t| D]} | | }| ||d}|r| |n|}|}||d}||d}||d<||d<|| |<|| S|| di}d||di}| |dkr|| d|d<n||d|d<| |d}|| d}||d<|||d<||S)a query for balance and get the amount of funds available for trading or funds locked in orders https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-a-users-token-balances https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-users-perpetuals-account-summary :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.user]: user address, will default to self.walletAddress if not provided :param str [params.type]: wallet type, ['spot', 'swap'], defaults to swap :param str [params.marginMode]: 'cross' or 'isolated', for margin trading, uses self.options.defaultMarginMode if not passed, defaults to None/None/None :param str [params.dex]: for hip3 markets, the dex name, eg: 'xyz' :param str [params.subAccountAddress]: sub account user address :param boolean [params.enableUnifiedMargin]: enable unified margin, CCXT tries to auto-detects self value but you can override it :returns dict: a `balance structure ` useraddressNenableUnifiedMarginrZr<r?rrrrbalancesrrcointotalholdused marginSummary accountValueisolated withdrawablefreetotalMarginUsed)rrr> timestampdatetime) safe_string_2rhandle_public_addresshandle_market_type_and_paramshandle_margin_mode_and_paramsis_unified_enabledr1rCrDr`rarbr3raccount safe_balancer2rrEiso8601)r%rF shouldRefresh userAddressrrisUnifiedEnabledr<isSpotrGrHr spotBalancesrgbalance unifiedCoderTrrrrh usdcBalancerfrs r' fetch_balancezhyperliquid.fetch_balancesF"++FFIFFdRNX\XfXfgmpEYFYFJNYN  "88PP V99.$PVWW f !??PVWW F)-)@)@Q\^kms)t)t#t#t#t#t#t#t &vu--6>6&6ISD[17R,,>R  ,,T[[&-I-IJJJJJJJJH>>(J77  "((!3L1c(mm,, - -"1+"55d6F6FwPV6W6WXX FL]t55kBBBR],,..(('::''88#( "&%, T""$$\22 2~~h<< T%%dN;;   "z)A)A"&"2"28^"L"LK  "&"2"249J"K"KK   %%h77 '{!\\)44z  (((r(Nrc K|d{V||}d|dr|dn|dd}||||d{V}||dg}||dg||d gd }||d } |||d | d dddS)a] fetches information on open orders with bid(buy) and ask(sell) prices, volumes and other data https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#l2-book-snapshot :param str symbol: unified symbol of the market to fetch the order book for :param int [limit]: the maximum amount of order book entries to return :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: A dictionary of `order book structures ` indexed by market symbols NrrAr6r2rrlevelsrr)bidsasksr>r,rrpxsz) load_marketsr4rCrDr`rEparse_order_book) r%r,rrFr4rGrHrhrfrs r'fetch_order_bookzhyperliquid.fetch_order_books#!!!!!!!!!V$$*0.JF:&&fTl  ,,T[[&-I-IJJJJJJJJ.~~h"55NN4B//NN4B//  %%h77 $$VVH-=y&RXZ^`deeer(symbolscK|d{V||}g}||d}||d}d}||ddd\}}|Y||d}|A||}|||ddrd}|r2||d}||d{V}n_|d kr| |d{V}n=|d kr| |d{V}n| |d{V}i}tdt|D]C} || }|d} || |} || d } | || <D||d |S) a fetches price tickers for multiple markets, statistical information calculated over the past 24 hours for each market https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-asset-contexts-includes-mark-price-current-funding-open-interest-etc https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/spot#retrieve-spot-asset-contexts :param str[] [symbols]: unified symbols of the markets to fetch the ticker for, all market tickers are returned if not assigned :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.type]: 'spot' or 'swap', by default fetches both :param boolean [params.hip3]: set to True to fetch hip3 markets only :returns dict: a dictionary of `ticker structures ` NrFrrrrTr?rAr,)r market_symbolsr1omithandle_option_and_paramsr4rr2rsrrrqrzrarb parse_tickerfilter_by_array_tickers) r%rrFrHrr firstSymbolr4rfrgrtickerr,s r' fetch_tickerszhyperliquid.fetch_tickerss4!!!!!!!!!%%g..//66**44V^VUZ[[ f  **7A66K&[11>>$.."@"@&II D  8YYvv..F!44V<<<<<<<D&&tV44F%%fh77F#F6NN++FHgFFFr(c Kddi}||||d{V}||di}||dg}||dg}g}t dt |D]W} |||| i||| i} || X|||S)a retrieves data on all swap markets for hyperliquid https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-perpetuals-asset-contexts-includes-mark-price-current-funding-open-interest-etc :param str[] [symbols]: list of unified market symbols :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict[]: an array of objects representing market data rr~Nrrr)rCrDr2r`rarbrpparse_funding_rates) r%rrFrGrHrrrrfrgrhs r'fetch_funding_rateszhyperliquid.fetch_funding_ratess & ,,T[[&-I-IJJJJJJJJ@~~h2..>>$ B77NN8Q33 q#h--((  A;;xB//y!R00D MM$    ''888r(c0||d}||}|||}||d}||d}||d}t t j|dz dz dz dzdzdzdz} id|d |d |d |d dd dddddd|d| d|| ddddddddddddddiS)Nr3fundingroraclePx<rrrr, markPrice indexPrice interestRateestimatedSettlePricerr fundingRatefundingTimestampfundingDatetimenextFundingRatenextFundingTimestampnextFundingDatetimepreviousFundingRatepreviousFundingTimestamppreviousFundingDatetimeintervalr) r1coin_to_market_id safe_symbolrrmathfloor millisecondsr) r%rr4rmarketIdr,rrrr$s r'parse_funding_ratezhyperliquid.parse_funding_rates*f--))$//!!(F33""433!!$11##D*55 4+<+<+>+> ? ?" Dr ID PQQTUUY[[^``cgg D f    (  D  #D       7   0  t||,<==  t  #D  "4  "4 '! " &t# $ %   r(rc||d}||}|||}||d}||ddd||d||d||d||d||d||d |d |S) Nr3 impactPxsr, prevDayPxrrrr dayNtlVlm) r,rr previousClosecloserbidask quoteVolumer)r1r- safe_marketr` safe_tickerr)r%rr4r3r2bidAsks r'rzhyperliquid.parse_tickerJs //))$//!!(F33 44X&!--fkBB%%fg66$$VW55##FA..##FA..++FK@@ ! !     r(r timeframesincecK|d{V||}||d|}|du}|} |C|?||dz} ||| |zdz}|dkrd}d}nd}||dg}d|dr|d n|d ||j||||d d } | | | |d{V} | | ||| ||S) a. fetches historical candlestick data containing the open, high, low, and close price, and the volume of a market https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#candle-snapshot :param str symbol: unified symbol of the market to fetch OHLCV data for :param str timeframe: the length of time each candle represents, support '1m', '15m', '1h', '1d' :param int [since]: timestamp in ms of the earliest candle to fetch :param int [limit]: the maximum amount of candles to fetch :param dict [params]: extra parameters specific to the exchange API endpoint :param int [params.until]: timestamp in ms of the latest candle to fetch :returns int[][]: A list of candles ordered, open, high, low, close, volume NuntilrrFrrAr6r2)rr, startTimeendTime)rreq) r r4rEr1parse_timeframerrr1rrCrD parse_ohlcvs) r%r,r@rArrFr4rCuseTail originalSincetimeframeInMillisecondsrGrHs r' fetch_ohlcvzhyperliquid.fetch_ohlcvks!!!!!!!!!V$$!!&'43D3D3F3FGG4- = *.*>*>y*I*ID*P'(?%(G"(LMM199E6G9--$.4VnNz**&, ,,T_iSS"   ,,T[[&-I-IJJJJJJJJ"  69mUT[\\\r(c ||d||d||d||d||d||dgS)Ntohlcv)rEr)r%ohlcvr4s r' parse_ohlcvzhyperliquid.parse_ohlcvs   eS ) )   UC ( (   UC ( (   UC ( (   UC ( (   UC ( (   r(cKd}|d|\}}|d{Vd}|||}d|i}| d|d<||d<nd|d<||d}||d}|||d <||||d{V} || |||S) a get the list of most recent trades for a particular symbol https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills-by-time :param str symbol: unified market symbol :param int [since]: the earliest time in ms to fetch trades for :param int [limit]: the maximum number of trades structures to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :param int [params.until]: timestamp in ms of the latest trade :param str [params.address]: wallet address that made trades :param str [params.user]: wallet address that made trades :param str [params.subAccountAddress]: sub account user address :returns Trade[]: a list of `trade structures ` NrruserFillsByTimerrE userFillsrCrFrr r4rErrCrD parse_trades r%r,rArrFrr4rGrCrHs r' fetch_tradeszhyperliquid.fetch_tradess!" "88OO V!!!!!!!!!  [[((F K   /GFO#(GK )GFO!!&'2267++  !&GI ,,T[[&-I-IJJJJJJJJ*  65%@@@r(c||}||t|dd|j|jS)NrUrS)r4decimal_to_precisionr)r paddingMode)r%r,rSr4s r'amount_to_precisionzhyperliquid.amount_to_precisionsAV$$(({8KH8UW[Wikok{|||r(c||}||}|dd}tdt |}||t |t|j}|drdnd}|| | |ddz } ||t | t|jS) Nrrrr?rrrUrS) r4rr0rrbr_r)r+r`precision_from_stringr1r*) r%r,rr4rrrrfrsubtractedValues r'price_to_precisionzhyperliquid.price_to_precisionsV$$((//nnS))!, 3{#3#344**5%9JL^`d`pqq!&>0aaq %(B(B4CSCSTZ[fTgiqCrCr(s(ss((Y]Yijjjr(c6d||ddzS)N0xkeccakhex)hash)r%messages r' hash_messagezhyperliquid.hash_messagesdii59999r(c||dd|dddd}d|dzd|dz|d|ddS) N secp256k1rgrsrT)rprqrT)ecdsar)r%rjr signatures r' sign_hashzhyperliquid.sign_hashsfJJtCDDz:cdd+;[$OO  #& #&"in--   r(cd||||ddS)Nrn)rurl)r%rkrs r' sign_messagezhyperliquid.sign_messages-~~d//88*STT:JKKKr(Tc|rdnd}||dS)Nba)source connectionId)r%rj isTestnetr{s r'construct_phantom_agentz#hyperliquid.construct_phantom_agents%",    r(cL||}||}|}|d||zz }||dz }n |dz }||z }| |dz }|d||zz }|||ddS)N000000001rhbinary)packbbinary_to_base16 int_to_base16rjbase16_to_binary)r%action vaultAddressnonce expiresAfter dataBinarydataHexrhs r' action_hashzhyperliquid.action_hashsZZ'' '' 33 $,,U3333   DLDD DLD L D  # DLD Gd00>>> >Dyy..t44hIIIr(c^|||||}||jdd}|||}||jd}d} | d|dd} dd d d d d d gi} || | |} || |j} | S)NrFri9rrchainIdr3verifyingContractr6Agentr{stringr3rr|bytes32)rrrrr1eth_encode_structured_datarwr)r%rr vaultAdressrrjr~ phantomAgentrrdomain messageTypesmsgrts r'sign_l1_actionzhyperliquid.sign_l1_action)s ULIINN4<FF 33D)DD .&&t|]CC !,    !844';; --flLQQ%%c4?;; r(c||jd}d}|d|dd}||||}|||j}|S)NrinHyperliquidSignTransactionrr)r1rrrwr)r%rrkrrrrrts r'sign_user_signed_actionz#hyperliquid.sign_user_signed_actionUsl&&t|]CC 0!,    --flGLL%%c4?;; r(cVdddddddddddddgi}|||S) NzHyperliquidTransaction:UsdSendhyperliquidChainrr destinationrSr>uint64rr%rkrs r'build_usd_send_sigzhyperliquid.build_usd_send_sigbsU ,+X>>&99!84422 / ++L'BBBr(cVdddddddddddd dgi}|||S) Nz'HyperliquidTransaction:UsdClassTransferrrrrStoPerpboolrrrrs r'build_usd_class_send_sigz$hyperliquid.build_usd_class_send_sigmsU 5+X>>!844!622 (33 8 ++L'BBBr(cVdddddddddddddgi}|||S) NzHyperliquidTransaction:WithdrawrrrrrSr>rrrs r'build_withdraw_sigzhyperliquid.build_withdraw_sigxsU -+X>>&99!84422 0 ++L'BBBr(cVddddddddddd d dgi}|||S) Nz)HyperliquidTransaction:UserDexAbstractionrrrrrr+rrrrrs r'build_user_dex_abstraction_sigz*hyperliquid.build_user_dex_abstraction_sigsU 7+X>>33"F33 (33 : ++L'BBBr(cVdddddddddddd dgi}|||S) Nz)HyperliquidTransaction:UserSetAbstractionrrrrr abstractionrrrrs r'build_user_abstraction_sigz&hyperliquid.build_user_abstraction_sigsU 7+X>>33&99 (33 : ++L'BBBr(cVdddddddddddd dgi}|||S) Nz(HyperliquidTransaction:ApproveBuilderFeerrr maxFeeRatebuilderrrrrrs r'build_approve_builder_fee_sigz)hyperliquid.build_approve_builder_fee_sigsU 6+X>>%x88"I66 (33 9 ++L'BBBr(cjK||jddrdSd|jd<d||jddd}|}|||}|||d}d} ||d{V}|S#t $r }d}Yd}~nd}~wwxYw|S) NrefSetFT setReferrerrefCCXT1)rrTrrrt)rrr1r1rprivatePostExchange Exception)r%rrrtrGrHes r'set_refzhyperliquid.set_refs >>$,% 8 8 4!% X!$$T\5'BB  !!##''66 "    !55g>>>>>>>>HO   HHHHHH s=B B0$B++B0rrc K|}||jdd}|rdnd|||d}||}|dd|d|d |d d }|||dd }||d{VS) NrFTestnetMainnet)rrrrr0x66eeerrapproveBuilderFee)rsignatureChainIdrrrrrrrtr)r1rrrr) r%rrr isSandboxModepayloadsigrrGs r'approve_builder_feezhyperliquid.approve_builder_fees!!##t|]EJJ -: I $    0099 '(: ; )!,/y)'      --g666666666r(c K tj|||dddigd{Vn#t $r }Yd}~dSd}~wwxYwdS)NrZFT)rtruhandle_builder_fee_approvalrrr)r%rs r'r_zhyperliquid.initialize_clients .4#C#C#E#Et||~~W[WnWno}@DFKMOXPXP#QR R R R R R R R R   55555 tsAA A+&A+cK||jdd}|sdS||jdd}|rdS ||jdd}||jdd}|||d{Vd|jd<n!#t$r}d|jd<Yd}~nd}~wwxYwdS) NrTFapprovedBuilderFeer*0x6530512A6c89C7cfCEbC3BA7fcD9aDa5f30827a6feeRatez0.01%)rrr1rr)r%buildFeerrrrs r'rz'hyperliquid.handle_builder_fee_approvals>>$, dCC 5!^^DL:NPUVV  4 /&&t|Y@lmmG))$, 7KKJ**7J?? ? ? ? ? ? ? ?15DL- . . / / /).DL & & & & & & /tsAB## C- B<<CFmethodrcPKd}||}n|d|\}}d}|||d\}}||rad|d}d} ||||d{V}n#t$r } d}Yd} ~ nd} ~ wwxYw|dk}||jd<||gS)a[ https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-a-users-abstraction-state returns enableUnifiedMargin so the user can check if unified account is enabled :param str method: the method for which we want to check if unified margin is enabled, self is used to check options for specific methods(e.g. fetchBalance can have a specific option to enable unified margin) @param address @param shouldRefresh :param dict [params]: extra parameters specific to the exchange API endpoint :returns bool: enableUnifiedMargin NrruserAbstractionrz"unifiedAccount")rrrCrDrr) r%rrrrFrrrGrHrs r'rzhyperliquid.is_unified_enableds   !KK"&"<"<=OQW"X"X K"&*&C&CFFTi&j&j#V  &- &)#GH !%!4!4T[[&5Q5Q!R!RRRRRRR    #+.@"@ 2EDL. /#V,,s /A;; BB  BrcKd}|d|\}}|}||jdd}||dd}||d}|rdnd|||d }||}|d d |d |d ||d} | ||dd} || d{VS)a set user abstraction mode https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#set-user-abstraction :param str abstraction: one of the strings ["disabled", "unifiedAccount", "portfolioMargin"], :param dict [params]: :param str [params.type]: 'userSetAbstraction' or 'agentSetAbstraction' default is 'userSetAbstraction' :returns: dictionary response from the exchange NsetUserAbstractionrFruserSetAbstractionrr)rrrrrrrr)rrrrrrr)rr1rrr1rrr) r%rrFrrrrrrrrGs r'set_user_abstractionz hyperliquid.set_user_abstractions  "889MvVV V!!##t|]EJJ 0DEE66**-: I &    --g66 '(: ; )"=1FO      --g666666666r(r+cKd}|d|\}}|}||jdd}||dd}||d}|rdnd|||d }||}|d d |d |d ||d} | ||dd} || d{VS)a If set, actions on HIP-3 perps will automatically transfer collateral from validator-operated USDC perps balance for HIP-3 DEXs where USDC is the collateral token, and spot otherwise @param enabled @param params :param str [params.type]: 'userDexAbstraction' or 'agentEnableDexAbstraction' default is 'userDexAbstraction' :returns: dictionary response from the exchange NenableUserDexAbstractionrFruserDexAbstractionrr)rrr+rrrr+r)rrr+rrrr)rr1rrr1rrr) r%r+rFrrrrrrrrGs r'enable_user_dex_abstractionz'hyperliquid.enable_user_dex_abstractionIs! "889SU[\\ V!!##t|]EJJ 0DEE66**-: I     11':: '(: ; )y)FO      --g666666666r(cK|}d|i}d|d}|||}||d<||d<||||d{V}|S)a set agent abstraction mode :param str abstraction: one of the strings ["i", "u", "p"] where "i" is "disabled", "u" is "unifiedAccount", and "p" is "portfolioMargin" :param dict [params]: :returns: dictionary response from the exchange ragentSetAbstraction)rrrrtNr1rrrD)r%rrFrrGrrtrHs r'set_agent_abstractionz!hyperliquid.set_agent_abstractionvs!!## U *&  ''66 "( 11$++gv2N2NOOOOOOOOr(rsiderSc K|d{V|d||||||\}}||g|d{V} | dS)af create a trade order https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#place-an-order :param str symbol: unified symbol of the market to create an order in :param str type: 'market' or 'limit' :param str side: 'buy' or 'sell' :param float amount: how much of currency you want to trade in units of base currency :param float [price]: the price at which the order is to be fulfilled, in units of the quote currency, ignored in market orders :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.timeInForce]: 'Gtc', 'Ioc', 'Alo' :param bool [params.postOnly]: True or False whether the order is post-only :param bool [params.reduceOnly]: True or False whether the order is reduce-only :param float [params.triggerPrice]: The price at which a trigger order is triggered at :param str [params.clientOrderId]: client order id,(optional 128 bit hex string e.g. 0x1234567890abcdef1234567890abcdef) :param str [params.slippage]: the slippage for market order :param str [params.vaultAddress]: the vault address for order :param str [params.subAccountAddress]: sub account user address :returns dict: an `order structure ` Nr)r parse_create_edit_order_args create_orders) r%r,rrrSrrForder globalParamsorderss r' create_orderzhyperliquid.create_orders,!!!!!!!!!"??fdTXZ`bgiopp|))5'<@@@@@@@@ayr(durationcK|d{V|d{V||}|}|dk}d} ||dd} ||d}||dd\} }|| } ttj |dz dz } | |d || ||||d d| | d } d | d } | | || }| ||d}| ||d}| |d<||d}|||d<||d}||d{V}||di}||di}||di}||di}||d}|d|d|S)a create a trade order that is executed TWAP order over a specified duration. :param str symbol: unified symbol of the market to create an order in :param str side: 'buy' or 'sell' :param float amount: how much of currency you want to trade in units of base currency :param int duration: the duration of the TWAP order in milliseconds :param dict [params]: extra parameters specific to the exchange API endpoint :param bool [params.randomize]: whether to randomize the time intervals of the TWAP order slices(default is False, meaning equal intervals) :param bool [params.reduceOnly]: True or False whether the order is reduce-only :param int [params.expiresAfter]: time in ms after which the twap order expires :param str [params.vaultAddress]: the vault address for order :returns dict: an `order structure ` NBUY randomizeFrQrrrr reduceOnly)rzryrqrpmrO twapOrder)rtwaprrrHrhr?runningtwapIdr?oid)r r_r4r1rrrformat_vault_addressrr/r0rrarrErr2r1 parse_order)r%r,rrSrrFr4risBuyrr durationMinsorderObj orderActionrtrGrrH responseObjrhr?rorderIds r'create_twap_orderzhyperliquid.create_twap_orders!!!!!!!!!$$&&&&&&&&&V$$!!## NN6;>> 6;//#<> 4:ho&:;;<< ""6(#344))&&99 e<<      '' ULII !"    #YYv~66F&2GN #((@@  #&2GN #YYv~66F11'::::::::nnXz2>> ~~k6266h33..B77""7H559W E EvNNNr(rc@K|d{V|d{V|||}||d{V}||di}||di}||dg}g}t dt|D]=} || } | dkr|d| i(|| >| |dS)a create a list of trade orders https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#place-an-order :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 ` NrHrhstatusesrwaitingForTriggerr?) r r_create_orders_requestrr2r`rarbrp parse_orders) r%rrFrGrHrrhrordersToBeParsedrgrs r'rzhyperliquid.create_orderssO!!!!!!!!!$$&&&&&&&&&,,VV<<11'::::::::$nnXz2>> ~~k6266>>$ B77q#h--(( / /AQKE+++ ''5(9:::: ''....  !14888r(c||}|}|}|dk}|dk} ||dd} ||d} |rdnd} ||dd } | rd } ||d | }||}||d d }||d|}||d}|p|}d}|r|t|jdz| r(tj |tj d| n'tj |tj d| }| ||}n| ||}|||}||dd }i}|rAd }|| ||}d}n| ||}|||rdndd|d<nd|i|d<||gd}||d| ||||d}| | |d<|S)NMARKETr clientOrderId client_idslippageiocgtcpostOnlyFalor r stopPricerrzy market orders require price to calculate the max slippage price. Default slippage can be set in options(default is 5%).rrTtpslisMarket triggerPxtpslrtifr) rr rrrrr r rr rrzryprqrprOrS)r4upperrr1rsafe_string_lower capitalizer"r2r- string_mul string_add string_subrerarr)r%r,rrrSrrFr4rrrr defaultTimeInForcer r rrr isTriggerr r r orderTypeisTprs r'create_order_requestz hyperliquid.create_order_requestsV$$zz||zz||H$**6?KPP ##FJ77'/;UUe>>&*e<<  '!& ,,V]DVWW ook22 ))&.+NN ((,OO **63DEE"5o   8}'3n)noooRW[#E7+=c8+L+LMMM^e^pqvxyKLOQYyZyZ_[_[B((44BB((77B  % %ff 5 5^^FL%@@   D*#66vOO #66v}MM $)!%0D$$Ii {"Ig 6$x$x$xyy""6(#344     $)HSMr(c. |||jd}||d|}d}tdt |D]<}||}||di}||dd}|d }=|rotdt |D]Q}||}||di}||dd}|t|jd zR| |gd }| } g} d } tdt |D]}||}||d } | | } | d }| |d}| |d}||d}||d}||di}||d|}||d<| |d}| |d}|du}|du}| |ddg}|||||||}|s|r||ddg}||dd}||ddg|}||ddg}||dd}||ddg|}||dd} | dkrd}d}d}n3| dkr| |nt#|jdz| |gd}d }|d!krd"}nd#}|rF|||||||||d d$} | | |rF|||||||||d d%} | | | |d}!||d&d'\}!}||!}!d(| | d)}"||jd*dr>||jd+d,}#|#||jd-d.d/|"d+<||"| |!}$|"| |$d0}%|!| |d'}|!|%d'<|%S)1a create a list of trade orders https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#place-an-order :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 :returns dict: an `order structure ` rr FrrFrr NTzV createOrders() all orders must have clientOrderId if at least one has a clientOrderId r rr r rrrrr nar,rrrSrstopLoss takeProfitrrrrrgrouping normalTpsl positionTpslrr4z3 only support grouping normalTpsl and positionTpsl.)r'r(r)r]rsellbuy)rr)rrrQrr)rrr)rrrfeeIntr)ryfr)r^r1rrarbr2rr"r2rr1r4safe_string_upper safe_valuer# safe_string_nrpr'rDrrrrrEr)&r%rrFrhasClientOrderIdrgrawOrder orderParamsrrorderReqr)r2r4r,rrrSrr r'r( hasStopLoss hasTakeProfit mainOrderObjstopLossOrderTriggerPricestopLossOrderTypestopLossOrderLimitPricetakeProfitOrderTriggerPricetakeProfitOrderTypetakeProfitOrderLimitPricetriggerOrderSiderrrwalletrtrGs& r'rz!hyperliquid.create_orders_requestTsF '')))**4<9JKK**6:OO q#f++&& ( (AayH..8R@@K ..{O[YYM(#'  P1c&kk** P P!!9"nnXxDD $ 2 2;Q\ ] ]  (+DG7O-OPPP)6$j$j$jkk!!##q#f++&&6 .6 .AayH''(;;H[[**FH%F))(F;;D))(F;;D%%h99F$$Xw77E..8R@@K'' ZQQH&.K #{J??HlCCJ#4/K't3M))K*l1KLLK!%!:!:64vW\^i!j!jL$ .m$ .,0,>,>x.ZeIf,g,g)$($4$4Xvw$O$O!*.*<*,>zGUfKgjE-F-F)++K\RR~-- F(0%*2''--OOL1111&tw1f'fggg"ii 5[5[5[\\ #% 5=='-$$',$ .%)%>%>vGZ\lntwPRVR]R]^i+F&*kkRR&&HOOH---.%)%>%>vGXZjlruLNRNYNYZe)B&*ggNN&&HOOH--- ---- #<>    >>$,(` rFNr)rrcancel_twap_order cancel_ordersr2)r%r2r,rFrs r' cancel_orderzhyperliquid.cancel_orders >>&&% 0 0 DYYvv..F//FFCCCCCCCC C))2$????????~~fa(((r(idsc^K||t|jdz|d{V|d{V||||}||d{V}||d}||d}||d}g} tdt|D]5} || } | | | | d6| S)a' cancel multiple orders https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s-by-cloid :param str[] ids: order ids :param str [symbol]: unified market symbol :param dict [params]: extra parameters specific to the exchange API endpoint :param string|str[] [params.clientOrderId]: client order ids,(optional 128 bit hex string e.g. 0x1234567890abcdef1234567890abcdef) :param str [params.vaultAddress]: the vault address :param str [params.subAccountAddress]: sub account user address :returns dict: an list of `order structures ` Nz* cancelOrders() requires a symbol argumentrHrhrrrr?) r^r"r2r r_cancel_orders_requestrr2r`rarbrp safe_order) r%rFr,rFrGrH innerResponserhrrrgr?s r'rDzhyperliquid.cancel_orderssc ''))) >#DG.Z$Z[[ [!!!!!!!!!$$&&&&&&&&&,,S&&AA11'::::::::x<< ~~mV44>>$ 33q#h--((  Aa[F MM$// ++     r(cNK|d{V|t|jdz||}d}||dd\}}||}d||d||d}|}| |||}|||d} || |d}|| d<| |d } | | | d <| |d }| | d{V} | | d i} | | d i} || d }|||d |S)aZ cancels a running twap order https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-a-twap-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 int [params.expiresAfter]: time in ms after which the twap order expires :param str [params.vaultAddress]: the vault address for order :returns dict: An `order structure ` Nz- cancelTwapOrder() requires a symbol argumentcancelTwapOrderr twapCancelr)rrzrOrrrHrhr?r)r r"r2r4rrrparse_to_numericr1rrrErr2r1r)r%r2r,rFr4rrrrtrGrrHrrhr?s r'rCzhyperliquid.cancel_twap_order s!!!!!!!!! >#DG.]$]^^ ^V$$ #<>  ""6(#344&&r**   !!##''|DD "    #YYv~66F&2GN #((@@  #&2GN #YYv~66F11'::::::::nnXz2>> ~~k6266!!$116" = =vFFFr(cT||}||dd}||ddg}|}d|i}g}dgd} ||d} |\t |t s|g}d| d <td t|D] } | | || d !nVd | d <td t|D]3} | | ||| d 4|| d<d} | |ddd\} }| | } | | || } | |d<| |d<| ||d}| |d<|S)a build the request payload for cancelling multiple orders https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s-by-cloid :param str[] ids: order ids :param str symbol: unified market symbol :param dict [params]: :returns dict: the raw request object to be sent to the exchange rr rr]rcancelsrN cancelByCloidrr)assetcloidcancel)rzrPrRrJrsubAccountAddressrrt) r4 safe_value_2rr1rO isinstancelistrarbrphandle_option_and_params_2rr)r%rFr,rFr4rrrG cancelReq cancelActionrrgrrts r'rIz!hyperliquid.cancel_orders_request< sV$$))&/;OO 6O[#ABB!!## U    &&vh'788  $mT22 0!. #2L 1c-0011    #*1-""  $,L 1c#hh''    ..s1v66""#, Y #>>v~Wegz{{ f00>> '' e\JJ ((   #YYv~66F&2GN #r(cbK||d{V|d{V|}d|i}g}dgd}d}t dt |D]}||} || d} | d}|| d } || d } | t|jd z| |rt|jd z|rd nd} |rdnd}| | }i}| |d|| <|r| n| | ||<| ||rdnd|d<||d<d}| |ddd\}}||}||||}||d<||d<|||d}||d<||d{V}|d|igS)a- cancel multiple orders for multiple symbols https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s-by-cloid :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 str [params.vaultAddress]: the vault address :param str [params.subAccountAddress]: sub account user address :returns dict: an list of `order structures ` Nrr]rQFrrTr2r,zB cancelOrdersForSymbols() requires a symbol argument in each orderzI cancelOrdersForSymbols() all orders must have either id or clientOrderIdrTrzrUrPrrSrVrrRrKrrWrrtr)r^r r_r1rarbr1r"r2r#r4rOrpr[rrrrrJ)r%rrFrrGr\r]rSrgrrr2r,assetKeyidKeyr4 cancelObjrrtrHs r'cancel_orders_for_symbolsz%hyperliquid.cancel_orders_for_symbolsp s '')))!!!!!!!!!$$&&&&&&&&&!!## U     q#f++&& ( (A1IE ,,UODDM( $ !!%..B%%eX66F~'2v(vwww~-~ +v!vwww"/8wwSH,5GG#E[[((F I"&"7"7x8H"I"IIh 0=\}}4CXCXY[C\C\Ie    Y ' ' ' '2?MX V"+ Y #>>vG_aorE F F f00>> '' e\JJ ((   #YYv~66F&2GN #11':::::::: 23344r(timeoutc K||d{V|d{V||ddg}|}d|i}d||zd}d}||ddd \}}||}||||}||d <||d <|||d}||d<||d{V}|S) a dead man's switch, cancel all orders after the given timeout :param number timeout: time in milliseconds, 0 represents cancel the timer :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.vaultAddress]: the vault address :param str [params.subAccountAddress]: sub account user address :returns dict: the api result Nrr rscheduleCancel)rr>rHrrWrrt) r^r r_rr1r[rrr) r%rcrFrrGr]rrtrHs r'cancel_all_orders_afterz#hyperliquid.cancel_all_orders_after sn '')))!!!!!!!!!$$&&&&&&&&&6O[#ABB!!## U  %GO   #>>vG]_mpC D D f00>> '' e\JJ ((   #YYv~66F&2GN #11'::::::::r(cr |d}tdt|D]<}||}||di}||dd}|d}=|rotdt|D]Q}||}||di}||dd}|t |jdzR||gd}g}tdt|D].}||}||d } ||d } | | } | d } | |d } | d k}| |d }|dk}||d}||d}||di}||j d}||d|}|rdnd}| |dd}|rd}| |d|}||}||dd}||dd}||d|}||d}|p|}| |dd}||gd}||}|ri|r(t!j|t!jd|n't!j|t!jd|}|| |}n|| |}|| |}i}|rAd} ||| |}d} n|| |}||| rdnd d!|d"<nd#|i|d$<|d%}|| d&|||||d'}!|||!d(<|| |!d)}"||"0|}#d*|d+}$d}%||d,d-\}%}||%}%||$|#|%}&|$|#|&d.}'|%|%|'d-<|'S)/NFrrFrr TzT editOrders() all orders must have clientOrderId if at least one has a clientOrderIdr%r2r,rrrrrSrrr r r r rr rrrrr) r r rrrrr r rrrrrrrrrrrrS)rr batchModify)rmodifiesrWrr)r^rarbr2rr"r2rr1r4r0rrrrrr-rrrrerarrpr1rrr)(r%rrFr3rgr4r5rrir2r2r4r,rrrrrSrrr rr r rrrr rr r r!r"r6 modifyReqr modifyActionrrtrGs( r'edit_orders_requestzhyperliquid.edit_orders_request s ''))) q#f++&& ( (AayH..8R@@K ..{O[YYM(#'  N1c&kk** N N!!9"nnXxDD $ 2 2;Q\ ] ]  (+DG7M-MNNN)6$j$j$jkkq#f++&&E 'E 'AayH!!(D11B''(;;H[[**FH%F))(F;;D(H))(F;;DU]E%%h99F$$Xw77E..8R@@K"..t|=NOOO'' ZQQH+3!?% ~~k:uEEH +%*"00mM_``K//+66K ..{O[YYM--k>;WWL ,,[/<XXM"..{sH,M,MNNN_f_qrtv}wIJMOWwXwX`Y`Y,,VR88,,VR88))&&99B I ".#'#:#:6?#S#SLDD#'#:#:6=#Q#QL (!-%)4DD(( )$$;& '"#" &&vh'788 H( - ((,,!I OOI & & & &!!##!    #<> '' e\JJ ""    #&2GN #r(c K|d{V|t|jdz||||||||\}} ||g| d{V} | dS)aO edit a trade order https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#modify-multiple-orders :param str id: cancel order id :param str symbol: unified symbol of the market to create an order in :param str type: 'market' or 'limit' :param str side: 'buy' or 'sell' :param float amount: how much of currency you want to trade in units of base currency :param float [price]: the price at which the order is to be fulfilled, in units of the quote currency, ignored in market orders :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.timeInForce]: 'Gtc', 'Ioc', 'Alo' :param bool [params.postOnly]: True or False whether the order is post-only :param bool [params.reduceOnly]: True or False whether the order is reduce-only :param float [params.triggerPrice]: The price at which a trigger order is triggered at :param str [params.clientOrderId]: client order id,(optional 128 bit hex string e.g. 0x1234567890abcdef1234567890abcdef) :param str [params.vaultAddress]: the vault address for order :param str [params.subAccountAddress]: sub account user address :returns dict: an `order structure ` Nz$ editOrder() requires an id argumentr)r r"r2r edit_orders) r%r2r,rrrSrrFrrrs r' edit_orderzhyperliquid.edit_orderK s,!!!!!!!!! :#DG.T$TUU U"??FDRVX^`egmnn|''>>>>>>>>ayr(cK|d{V|d{V|||}||d{V}||di}||di}||dg}||S)a edit a list of trade orders https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#modify-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 ` NrHrhr)r r_rlrr2r`r)r%rrFrGrHresponseObject dataObjectrs r'rnzhyperliquid.edit_ordersh s!!!!!!!!!$$&&&&&&&&&**66::11'::::::::H*bAA^^NFB?? >>*j"==  ***r(r3 description initialUsdcK||d{V|}d|i}|t j||d}d||||d}|||} ||d<| |d<|| ||d{V} | S)aF creates a value :param str name: The name of the vault :param str description: The description of the vault :param number initialUsd: The initialUsd of the vault :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: the api result Nr1000000 createVault)rr3rsrtrrrt) r^r r1rr-rrrrrD) r%r3rsrtrFrrGusdrrtrHs r' create_vaultzhyperliquid.create_vault s  '')))!!!!!!!!!!!## U  243H3H3T3TV_ ` `aa!&   ''66 "( 11$++gv2N2NOOOOOOOOr(c ZK|d{V|t|jdz||}d|dd}|||d<n)|dn|}||dzdzd zz |d<||d }||d }|||d <||||d{V} g} td t| D]v} | | } || d } | | | d|| | d| || dw|| d}|||||S)a fetches historical funding rate prices https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-historical-funding-rates :param str symbol: unified symbol of the market to fetch the funding rate history for :param int [since]: timestamp in ms of the earliest funding rate to fetch :param int [limit]: the maximum amount of `funding rate structures ` to fetch :param dict [params]: extra parameters specific to the exchange API endpoint :param int [params.until]: timestamp in ms of the latest funding rate :returns dict[]: a list of `funding rate structures ` Nz5 fetchFundingRateHistory() requires a symbol argumentfundingHistoryr6rrEirrrCrFrr>r#)rr,r#rrr)r r"r2r4r1rErrCrDrarbrpr.rrsort_byfilter_by_symbol_since_limit)r%r,rArrFr4rGrrCrHrfrgrrsorteds r'fetch_funding_rate_historyz&hyperliquid.fetch_funding_rate_history s!!!!!!!!! >#DG.e$eff fV$$$:&    #(GK $}ss5H#'#4#4#6#6B9Kd9R#RGK !!&'2267++  !&GI ,,T[[&-I-IJJJJJJJJq#h--((  AQKE))%88I MM**488#//}EE& LL33     fk2200NNNr(c||dd}|d}t|}|dkr||dSdS)Nr6r]rrr)r1r0rb)r%r4r6part partsLengths r'get_dex_from_hip3_symbolz$hyperliquid.get_dex_from_hip3_symbol sY##FJ;;~~c""$ii ??##D!,, ,tr(cKd}|d|\}}d}||ddd\}}|d{V||d}d}|1||}||} | | |d<||||d{V} g} tdt| D]P} | | } i}| | dd |d <| || |Q| | |||S) a fetch all unfilled currently open orders https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-open-orders :param str symbol: unified market symbol :param int [since]: the earliest time in ms to fetch open orders for :param int [limit]: the maximum number of open orders structures to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.user]: user address, will default to self.walletAddress if not provided :param str [params.method]: 'openOrders' or 'frontendOpenOrders' default is 'frontendOpenOrders' :param str [params.subAccountAddress]: sub account user address :param str [params.dex]: perp dex name. default is None :returns Order[]: a list of `order structures ` NrrfrontendOpenOrdersrr<rr?open ccxtStatus) rrr r4rrCrDrarbr1rpr)r%r,rArrFrrrGr4rrHorderWithStatusrgr extendOrders r'fetch_open_orderszhyperliquid.fetch_open_orders s  "889JFSS V66v?PRZ\pqq!!!!!!!!!    [[((F33F;;G"!(,,T[[&-I-IJJJJJJJJq#h--(( D DAQKEKx008,2 L)  " "4;;uk#B#B C C C C  &%GGGr(cK|d{V||dd|d{V}||ddgd}|||||S)a* fetch all unfilled currently closed orders :param str symbol: unified market symbol :param int [since]: the earliest time in ms to fetch open orders for :param int [limit]: the maximum number of open orders structures to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.user]: user address, will default to self.walletAddress if not provided :returns Order[]: a list of `order structures ` Nr?closedFr  fetch_ordersfilter_by_arrayr}r%r,rArrFr closedOrderss r'fetch_closed_orderszhyperliquid.fetch_closed_orders: s!!!!!!!!!((tVDDDDDDDD++FHxj%PP 00vueTTTr(cK|d{V||dd|d{V}||ddgd}|||||S)a fetch all canceled orders :param str symbol: unified market symbol :param int [since]: the earliest time in ms to fetch open orders for :param int [limit]: the maximum number of open orders structures to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.user]: user address, will default to self.walletAddress if not provided :returns Order[]: a list of `order structures ` Nr?canceledFrrs r'fetch_canceled_ordersz!hyperliquid.fetch_canceled_ordersI s!!!!!!!!!((tVDDDDDDDD++FHzlERR 00vueTTTr(cK|d{V||dd|d{V}||dgdd}|||||S)a$ fetch all closed and canceled orders :param str symbol: unified market symbol :param int [since]: the earliest time in ms to fetch open orders for :param int [limit]: the maximum number of open orders structures to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.user]: user address, will default to self.walletAddress if not provided :returns Order[]: a list of `order structures ` Nr?)rrrejectedFrrs r' fetch_canceled_and_closed_ordersz,hyperliquid.fetch_canceled_and_closed_ordersX s!!!!!!!!!((tVDDDDDDDD++FH>`>`>`bghh 00vueTTTr(cKd}|d|\}}|d{Vd}d|d}|1||}||}|||d<||||d{V} i} t dt| D]} | | } || d} | | } | | d}|K|| vr| | |<F| | |d }| | d }| |||kr| | |<t| }| ||||S) a fetch all orders :param str symbol: unified market symbol :param int [since]: the earliest time in ms to fetch open orders for :param int [limit]: the maximum number of open orders structures to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.user]: user address, will default to self.walletAddress if not provided :param str [params.subAccountAddress]: sub account user address :param str [params.dex]: perp dex name. default is None :returns Order[]: a list of `order structures ` NrhistoricalOrdersrr<rrrstatusTimestamp)rr r4rrCrDrarbr2r1rErZvaluesr)r%r,rArrFrr4rGrrHdeduplicatedByOidrgr4rrexistingTimestampcurrentTimestamp deduplicateds r'rzhyperliquid.fetch_ordersg s "88OO V!!!!!!!!!&    [[((F33F;;G"!(,,T[[&-I-IJJJJJJJJ*#%q#h--(( : :A{HNN8W55E} ""5%00C000-5%c**(,(9(9:KC:PRc(d(d%'+'8'8CT'U'U$'39J9RVfizVzVz19)#.-446677   vueDDDr(c(Kd}|d|\}}|d{Vd}|||}||d}d|d}|||d}||d<n/t |dk}|r|n|||d<||||d{V} | | d} | | |S) a fetches information on an order made by the user https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-order-status-by-oid-or-cloid :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 str [params.clientOrderId]: client order id,(optional 128 bit hex string e.g. 0x1234567890abcdef1234567890abcdef) :param str [params.user]: user address, will default to self.walletAddress if not provided :param str [params.subAccountAddress]: sub account user address :returns dict: An `order structure ` Nrrrrr"r) rr r4r1rrbrOrCrDr2r) r%r2r,rFrr4rrGisClientOrderIdrHrhs r' fetch_orderzhyperliquid.fetch_order sA "88vNN V!!!!!!!!!  [[((F((AA !    $YYv77F*GENN!"ggmO#2QRR8M8Mb8Q8QGEN,,T[[&-I-IJJJJJJJJ8~~h00f---r(rc ||d}|||ddS||gd}||}||di}||d}d}|||}||d||d}n|||}|d}||d } ||d d } ||d g}||d } | | d krdnd} ||dd} ||d} | |d}d}||dk}|id|d||dd||dd | d| | ddd||dd|d| | |dd|d |d!| |d!d | d"||d#d$| |d%r||d&ndd'| d(d||d)||dtj| | | || ddd*|S)+NerrorrrH)rrestingfilledrrr2r,rr?rrAr,r-origSztotalSzr rALOrrrrUrlastTradeTimestamplastUpdateTimestamprrr!r r rrlimitPxrr rrSravgPx)averager remainingr?rYtrades)r1rJ safe_dict_nr2r-r=rErrr0rparse_order_typerrrr-rparse_order_status)r%rr4rrrrr2r,rr?r totalAmountrrr s r'rzhyperliquid.parse_order s@  00  ??$$$   (F(F(FGG =Ex44v..  --d33H   E4 ( ( 0%%h55FF%%h77F!%%e[99 ##E8\BB %,00v..  "ckk66D(()DD $$UD11 $$UE22 ?u H E $""5%00  T--eW==     Y//  !$   "4#4#4U4""(    ??: & & : ??: & & :&&999r(c:ddd}||||S)Nrr4)z stop limitz stop marketr1rs r'rzhyperliquid.parse_order_type s.!#  &&999r(cKd}|d|\}}|d{Vd}|||}d|i}| d|d<||d<nd|d<||d}||d}|||d <||||d{V} || |||S) a- fetch all trades made by the user https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills-by-time :param str symbol: unified market symbol :param int [since]: the earliest time in ms to fetch trades for :param int [limit]: the maximum number of trades structures to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :param int [params.until]: timestamp in ms of the latest trade :param str [params.subAccountAddress]: sub account user address :returns Trade[]: a list of `trade structures ` NrzrrXrrErYrCrFrZr\s r'fetch_my_tradeszhyperliquid.fetch_my_trades s! "88&QQ V!!!!!!!!!  [[((F K   /GFO#(GK )GFO!!&'2267++  !&GI ,,T[[&-I-IJJJJJJJJ,  65%@@@r(tradec||d}||d}||d}||d}||}||d}|d}||d} ||d} | | dkrd nd } ||d } d} ||d } | | rd nd} ||d}|t j| |} ||||||| ||dd| | ||d| ||dddd |S)Nr>r r rr,tidrrr,r-rYcrossedrrrrfeeToken)rcurrencyrate) rrrr,r2rrr takerOrMakerrrSrrY) rEr1r-r=rr-r safe_trader)r%rr4rrrSrr2r,r2rrYrrrs r' parse_tradezhyperliquid.parse_trade s&%%eV44   --!!%..v..))$//!!(D11!   eU + +v..  "ckk66Due,, .. 22  &-:777L%%e\::  !$S*55C" Y//%%eU33( ,,UJ??  $ % r(cnK||g|d{V}||diS)a, fetch data on an open position https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-users-perpetuals-account-summary :param str symbol: unified market symbol of the market the position is held in :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.user]: user address, will default to self.walletAddress if not provided :returns dict: a `position structure ` Nr)fetch_positionsr2)r%r,rF positionss r'fetch_positionzhyperliquid.fetch_position sG..x@@@@@@@@ ~~iB///r( methodNamecr|dSt|}|dkrdSd}td|D]}|1|||}||}5|||}||}||krt |jdz|zdz|S)Nr zH only supports fetching positions for one DEX at a time for HIP3 markets)rbrar4rr'r2)r%rr symbolsLengthrrgr4currentDexNames r'get_dex_from_symbolsz hyperliquid.get_dex_from_symbols s ?4G A  4q-(( P PAWQZ0077??WQZ00!%!>!>v!F!F!W,,&tw}z'AEO(OPPP-r(c<K|d{Vd}|d|\}}||}d|d}|d|}|||d<||||d{V}||dg}g}tdt|D]1} | | || d2| |d|d S) a fetch all open positions https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-users-perpetuals-account-summary :param str[] [symbols]: list of unified market symbols :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.user]: user address, will default to self.walletAddress if not provided :param str [params.subAccountAddress]: sub account user address :param str [params.dex]: perp dex name, eg: XYZ :returns dict[]: a list of `position structure ` Nrrrr<assetPositionsrr,F) r rrrrCrDr`rarbrpparse_positionfilter_by_array_positions) r%rrFrrGrrHrhrfrgs r'rzhyperliquid.fetch_positions+ sK!!!!!!!!! "889I6RR V%%g..(  ++, >A MM$--d1gt<< = = = =--fhOOOr(positionc ||di}||d}||}||d}|d}||di}||d}|dk} ||d} | } d} | -t j| drd nd } t j| } ||d } t j| }||d }d}| rt j|| }n|}t jt j ||d }| id|ddd|ddddd| ddd| d| | ddd| |dddd| |dd| |dd| |d| |dddd| | | |d|| |d S)!Nrrr,r rrszirlongshort unrealizedPnl marginUsed100rr2rrr r contractsr entryPriceentryPxrnotional positionValuevalue collateral initialMarginmaintenanceMargin liquidationPx)initialMarginPercentagemaintenanceMarginPercentagerliquidationPricer percentage) r2r1r-r=r-r string_absrr string_div safe_positionr$r)r%rr4rrr2r,r r isIsolatedrawSizesizerrawUnrealizedPnlabsRawUnrealizedPnlrrrs r'rzhyperliquid.parse_positionw s6xR88v..))$//!!(D11!>>%R88%%h77  J. ""5%00  $.w<<I66'D%d++D++E?CC%01ABB%%e\::   '#.z;KLLMM&M'(:;NPZ([([]bcc !!# H# $#  f#   #  #  #  d#  D#  **400#  D#  $**5)<<#  #  ((@@#  ((7;;#  $++J77# T..}==!# " ## $(,+/!../?@@ $ 0 0 H H$++J77/# # #    r(rcK|t|jdz|d{V||}||d}|t|jdz||d}|dk}|}||dg}d|||d} d} ||d d d \} }| +| d r| d d } | | || } | || d} | | | d <| | d{V} | S)aN set margin mode(symbol) :param str marginMode: margin mode must be either [isolated, cross] :param str symbol: unified market symbol of the market the position is held in, default is None :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.leverage]: the rate of leverage, is required if setting trade mode(symbol) :param str [params.vaultAddress]: the vault address :param str [params.subAccountAddress]: sub account user address :returns dict: response from the exchange Nz+ setMarginMode() requires a symbol argumentr z. setMarginMode() requires a leverage parameterrcrossupdateLeveragerrTisCrossr rrrWrgr]r) r"r2r r4rErr1rr[rerrr)r%rr,rFr4r rTrr updateActionrrtrGrHs r'set_margin_modezhyperliquid.set_margin_mode s >#DG.[$[\\ \!!!!!!!!!V$$$$VZ88  #DG.^$^__ _!!&"233(!!##6J<00$    #>>vXfh{|| f  #&&t,, >+33D"== '' e\JJ ""    #&2GN #11'::::::::r(r czK|t|jdz|d{V||}||dd}|dk}||d}|}||d}d|||d} d} ||dd d \} }| | } | | || } | || d } | ||d }| | d <| | d{V} | S) a set the level of leverage for a market :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]: margin mode must be either [isolated, cross], default is cross :returns dict: response from the exchange Nz) setLeverage() requires a symbol argumentrrrrrrrrWr) r"r2r r4r1rr1rr[rrr)r%r r,rFr4rrrTrrrrtrGrHs r' set_leveragezhyperliquid.set_leverage s >#DG.Y$YZZ Z!!!!!!!!!V$$%%flGDD (!!&"233!!##6<00$    #>>v}Vdfyzz f00>> '' e\JJ ""    #YYv~66F&2GN #11'::::::::r(cBK|||d|d{VS)a* add margin https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#update-isolated-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 :param str [params.vaultAddress]: the vault address :param str [params.subAccountAddress]: sub account user address :returns dict: a `margin structure ` addNmodify_margin_helperr%r,rSrFs r' add_marginzhyperliquid.add_margin(s4..vvufMMMMMMMMMr(cBK|||d|d{VS)aD https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#update-isolated-margin remove margin from a position :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 :param str [params.vaultAddress]: the vault address :param str [params.subAccountAddress]: sub account user address :returns dict: a `margin structure ` reduceNrrs r' reduce_marginzhyperliquid.reduce_margin7s4..vvxPPPPPPPPPr(cK|d{V||}||d}|tj|||d}|dkr| }|}d|d|d} d} ||ddd \} }|| } | | || } | || d } | | | d<| | d{V} | | | |d | | d iS) Nrrvr updateIsolatedMarginT)rrTrntli modifyMarginrrWrrTr?)r r4rr-rrar1r[rrrrDparse_margin_modificationr1)r%r,rSrrFr4rTr rrrrtrGrHs r'rz hyperliquid.modify_margin_helperFs!!!!!!!!!V$$!!&"233   w1$2J2J6SY2Z2Z\eff g g 8  B!!##*    #>>v~Wegz{{ f00>> '' e\JJ ""    #&2GN #11'::::::::{{499(FKK D$$Xx88N    r(rhc l||d|dddd||ddddd S)Nrr) rr,rrrSrrTr?rr)r.r1)r%rhr4s r'rz%hyperliquid.parse_margin_modificationmsQ&&tV44$$$VX66   r( fromAccount toAccountclK||d{V||jd}|}||gdr||gdst |jdz||}| |dd} | | | } |dz| z}|dkp|d k} |rd nd || |d } | | } | d dd|| |d|| d} | | d{V}|Sd}d}|dkr|}d}n |dkr|}nt |jdz| |||dkr|t!j||d}d|||d}|||}|||d}| |d{V}||S||}d|||||d}|||}|||d}| |d{V}||S)a transfer currency internally between wallets on the same account https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#l1-usdc-transfer :param str code: unified currency code :param float amount: amount to transfer :param str fromAccount: account to transfer from *spot, swap* :param str toAccount: account to transfer to *swap, spot or address* :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.vaultAddress]: the vault address for order :returns dict: a `transfer structure ` Nr)r?rAperpz. transfer() only support spot <> swap transferrrWz subaccount:rrArr)rrSrrrrusdClassTransfer)rrrrSrrrFmainTz4 transfer() only support main <> subaccount transferrrvsubAccountTransfer)rsubAccountUser isDepositrxsubAccountSpotTransfer)rrrtokenrS)r^r rrr1in_arrayr'r2rrrrr check_addressrrr-rrparse_transferr,)r%rTrSrrrFrr strAmountrrtransferPayload transferSigtransferRequesttransferResponserrWrxrrrGrHr,s r'rzhyperliquid.transfers '')))!!!!!!!!!t|]CC !!## ==&>&>&> ? ? $==,D,D,DEE _"47-]#]^^^--f55I--fnFYZZL'#88FF %6E 6)CyF/BF1>$MIII#  %%O 77HHK)88J(K(1.'$" ( % %O&*%=%=o%N%NNNNNNN # #   & ) II & +  tw)__`` ` ,--- <4::<<611##G$6t7L7LV7T7TV_$`$`aaC,"3& F %%fe44C  G "55g>>>>>>>>H&&x00 0[[&&F0"3&//77 F%%fe44C  G "55g>>>>>>>>H&&x00 0r(rrc |ddddddddd S)Nr<) rr2rrrrSrrr?r})r%rrs r'rzhyperliquid.parse_transfers.    r(tagc,K||d{V|||1|}|dkrt |jdzd}||dd\}}||}||d}| }i}d} |!dd|zd|d }| ||} ne| |j d d} | rd nd |t||d } || } | dd|t||dd}||| d} || d{V} || S)a make a withdrawal(only support USDC) https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#initiate-a-withdrawal-request https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#deposit-or-withdraw-from-a-vault :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 :param str [params.vaultAddress]: vault address withdraw from :returns dict: a `transaction structure ` Nrz withdraw() only support USDCrr vaultTransferrgF)rrrrxrrr)rrrSr>rr withdraw3)rrrrSr>rr)r^r rrr'r2rrrr1rrrstrrrparse_transaction)r%rTrSrr%rFrrrrrrrGrHs r'rzhyperliquid.withdraws '')))!!!!!!!!! 7###  ::<> 6>22!!##  #' $| 3" F %%fe44CC NN4<NNM1>$MIII&f++ G ))'22C$+,>$?$-&f++# F   11'::::::::%%h///r( transactionc>||d}||di}d}||d}|d|d}d}||d}||dk}id|d dd ||d d |d ||ddddd||dd||dddddddddd||dddd||dddd||dS)Nr>deltarYrrrrinternalTransferrr2txidrjrrnetworkr addressTor addressFromrr%tagTotagFromrSusdcrr?r@)commentinternalrY)rEr2r1rr) r%r+rrr-rYfeeCostr8rs r'r*zhyperliquid.parse_transaction1s%%k6:: {GR88##E511  "Cv..   22H K $  D$$[&99     Y//  t   t  ))%??  4++E6::  4  T  t  D  d&&uf55   d&&{H==! " t# $ )    r(cK|d{Vd}|d|\}}||}d|d}||||d{V}||d||dd}|||S)a fetch the trading fees for a market :param str symbol: unified market symbol :param dict [params]: extra parameters specific to the exchange API endpoint :param str [params.user]: user address, will default to self.walletAddress if not provided :param str [params.subAccountAddress]: sub account user address :returns dict: a `fee structure ` NruserFeesr userCrossRate userAddRate)r<r=)r rr4rCrDr1parse_trading_fee)r%r,rFrr4rGrHrhs r'fetch_trading_feezhyperliquid.fetch_trading_feeds!!!!!!!!! "889JFSS VV$$  ,,T[[&-I-IJJJJJJJJJ"--hHH++HmDD  %%dF333r(rYc|d|}||||d||ddddS)Nr=r<)rr,rrr tierBased)r.r)r%rYr4r,s r'r>zhyperliquid.parse_trading_fees[H!!$//%%c=99%%c?;;    r(c~K|d{Vd}|d|\}}d|d}|||d<||d}|||d<||dg}||||d{V}||d||S)a fetch the history of changes, actions done by the user or operations that altered the balance of the user :param str [code]: unified currency code :param int [since]: timestamp in ms of the earliest ledger entry :param int [limit]: max number of ledger entries to return :param dict [params]: extra parameters specific to the exchange API endpoint :param int [params.until]: timestamp in ms of the latest ledger entry :param str [params.subAccountAddress]: sub account user address :returns dict: a `ledger structure ` NrquserNonFundingLedgerUpdatesrrErCrF)r rrErrCrD parse_ledger) r%rTrArrFrrGrCrHs r' fetch_ledgerzhyperliquid.fetch_ledgers!!!!!!!!! "88OO V1    #(GK !!&'22  !&GI YYvy11F,,T[[&-I-IJJJJJJJJ  4>>>r(itemc(||d}||di}d}||d}|d|d}||d}||d}||||ddd||d ||d||d|||||ddd|d |S) Nr>r-rYrr.rr6rjr)rr2 directionrreferenceAccount referenceIdrrrSrrbeforeafterr?rY)rEr2r1safe_ledger_entryparse_ledger_entry_typer$r) r%rFrrr-rYr9rrSs r'parse_ledger_entryzhyperliquid.parse_ledger_entrys8%%dF33 tWb11##E511  "Cv..!!%00%%""400 $ 0 0 ? ?++D&990066''//" Y//' ' ! r(c:ddd}||||S)Nr)r/accountClassTransferr)r%r ledgerTypes r'rNz#hyperliquid.parse_ledger_entry_types. *$.   D$777r(cTK|d{Vd}|d|\}}d|d}|||d<||d}|5|t|jdz||d<||dg}||||d{V}||} d} | |dd \} }| | } g} | otd t| D]P} | | } | d d kr:| | d }|dd| zkr| | Qn|| d dgd} || d||S)a fetch all deposits made to an account :param str code: unified currency code :param int [since]: the earliest time in ms to fetch deposits for :param int [limit]: the maximum number of deposits structures to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :param int [params.until]: the latest time in ms to fetch withdrawals for :param str [params.subAccountAddress]: sub account user address :param str [params.vaultAddress]: vault address :returns dict[]: a list of `transaction structures ` NfetchDepositsWithdrawalsrCrrErCz0 fetchDeposits requires since while until is setrFrrr vaultDepositr-vaultrgrWF)r rrEr"r2rrCrDextract_type_from_deltarrrarbr2rprparse_transactions)r%rTrArrFrrGrCrHrecordsrdepositsrgrecordr-s r'fetch_depositszhyperliquid.fetch_deposits%s!!!!!!!!! "889SU[\\ V1    #(GK !!&'22  }'2d(deee!&GI YYvy11F,,T[[&-I-IJJJJJJJJ..x88 #<>   #1c'll++ 0 0 &>^33 NN67;;EW~ )<<< ///  0++GVi[%PPH&&xueDDDr(c"K|d{Vd}|d|\}}d|d}|||d<||d}|||d<||dg}||||d{V}||} d} ||dd\} }|| } g} | otd t| D]P} | | } | d d kr:| | d }|d d| zkr| | Qn| | d dgd} || d||S)a fetch all withdrawals made from an account :param str code: unified currency code :param int [since]: the earliest time in ms to fetch withdrawals for :param int [limit]: the maximum number of withdrawals structures to retrieve :param dict [params]: extra parameters specific to the exchange API endpoint :param int [params.until]: the latest time in ms to fetch withdrawals for :param str [params.subAccountAddress]: sub account user address :param str [params.vaultAddress]: vault address :returns dict[]: a list of `transaction structures ` NrTrCrrErCrFrrr vaultWithdrawr-rVrgrF)r rrErrCrDrWrrrarbr2rprrX)r%rTrArrFrrGrCrHrYr withdrawalsrgr[r-s r'fetch_withdrawalszhyperliquid.fetch_withdrawals^s!!!!!!!!! "889SU[\\ V1    #(GK !!&'22  !&GI YYvy11F,,T[[&-I-IJJJJJJJJ..x88 #<>   #1c'll++ 3 3 &>_44 NN67;;EW~ )<<<#**6222  3..w eTTK&&{D%GGGr(cK|d{V||}|d{V}|||S)a$ Retrieves the open interest for a list of symbols :param str[] [symbols]: 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: N)r rrqparse_open_interests)r%rrF swapMarketss r'fetch_open_interestsz hyperliquid.fetch_open_interestssx!!!!!!!!!%%g.. 3355555555 ((g>>>r(cK||}|d{V||g|d{V}||S)a! retrieves the open interest of a contract trading pair :param str symbol: unified CCXT market symbol :param dict [params]: exchange specific parameters :returns dict: an `open interest structure ` N)r,r rd)r%r,rFoiss r'fetch_open_interestzhyperliquid.fetch_open_interestspV$$!!!!!!!!!--vh????????6{r(c ||di}||d}d}|||}|||||dddd|d|S)Nrr3 openInterest)r,openInterestAmountopenInterestValuerrr)r2r1r-safe_open_interestr.r)r%interestr4rr2s r'parse_open_interestzhyperliquid.parse_open_interests&>>(FB77&11  --d33H&&&&x00"&"2"28^"L"L!% ( (   r(cK|d{Vd}|||}d}|d|\}}|dd}|||d<||d}||d}|||d<||||d{V} || |||S)a> fetch the history of funding payments paid and received on self account :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 :param str [params.subAccountAddress]: sub account user address :returns dict: a `funding history structure ` Nrj userFunding)rrrErCrF)r r4rrErrCrD parse_incomes) r%r,rArrFr4rrGrCrHs r'fetch_funding_historyz!hyperliquid.fetch_funding_historys!!!!!!!!!  [[((F "889NPVWW V!    #(GK !!&'2267++  !&GI ,,T[[&-I-IJJJJJJJJ"!!(FE5AAAr(c ||d}||d}||d}||d}d}|||}|||}||d}||dd} ||d} ||d | ||||||| d S) Nrjr>r-rr6rrr#r,)rr,rTrrr2rSr)r1rEr2r-r=rrr$) r%incomer4r2rr-rr2rSrTrs r' parse_incomezhyperliquid.parse_incomes  ff - -%%ff55 vw//v..  --d33H!!(F33!!%00&99}55X&" Y//''//   r(weightcK|}d|i}d|d}|||}||d<||d<||||d{V}|S)a Instead of trading to increase the address based rate limits, self action allows reserving additional actions for 0.0005 USDC per request. The cost is paid from the Perps balance. :param number weight: the weight to reserve, 1 weight = 1 action, 0.0005 USDC per action :param dict [params]: extra parameters specific to the exchange API endpoint :returns dict: a response object rreserveRequestWeight)rrvrrtNr)r%rvrFrrGrrtrHs r'reserve_request_weightz"hyperliquid.reserve_request_weight s!!## U +  ''66 "( 11$++gv2N2NOOOOOOOOr(cLK|}d|i}d|d}||d}|||d}||d<|||d|}||d<||d<||||d{V}|S)aN creates a sub-account under the main account :param str name: the name of the sub-account :param dict [params]: extra parameters specific to the exchange API endpoint :param int [params.expiresAfter]: time in ms after which the sub-account will expire :returns dict: a response object rcreateSubAccount)rr3rNrrt)r1rErrrrD) r%r3rFrrGrrrtrHs r'create_sub_accountzhyperliquid.create_sub_account5s!!## U '  ((@@  #YYv~66F&2GN #''t\JJ "( 11$++gv2N2NOOOOOOOOr(cg}tdt|D]0}||}|dd|d<||1|S)Nrr-r)rarbrp)r%rhrYrgr[s r'rWz#hyperliquid.extract_type_from_deltaOs[q#d))$$ # #A!WF#G_V4F6N NN6 " " " "r(cd|dS|dr|ddS|S)Nrgr])rer)r%rs r'rz hyperliquid.format_vault_addressWs; ?4   d # # -??4,, ,r(rFcd}|||dd\}}|}|||d|\}}| |dkr||gS|j|jdkr |j|gSt|jdz|zdz)NrrWrr]rzF() requires a user parameter inside 'params' or the wallet address set)r[rrr"r2)r%rrFuserAuxrs r'rz!hyperliquid.handle_public_address^s99&*fVijj44VZT[\\ f  42::&> !   *1Cr1I1I&/ /# :>H!HII Ir(rc|dS||jdi}|||rR|||}||dd}||d|}|dz|zdz|zS|ddks|ddkr|S|ddkr|dd }||d zS) Nrr8rrTr.rrD@rz /USDC:USDC)r2rr1findrr3)r%rhi3TokensBynamehip3Dictr8rTs r'r-zhyperliquid.coin_to_market_idis <4..7I2NN >>/4 0 0 4~~ot<>B  $))C..2"5"5K 99S>>B  <<S))D&&t,,|;;r(reasonrBheadersbodyc @|sdS||dd} ||d} d} | dkr||d} n| dkrt|jdz|z| | } n||di} || di}||d g}t d t |D]"}|||d} | n#d|vr1||di}||d}||} |jdz|z}| duo| dk}|rD||jd | || |jd | ||rt|dS) Nr?r]rerrrH unknownOidrrhrrrr) r1r&r2r2r`rarbthrow_exactly_matched_exceptionrthrow_broadly_matched_exceptionr!)r%rTrrBrrrrHrequestHeaders requestBodyr?rrkresponsePayloadrhrrg errorStatuserrorMsgfeedbacknonEmptyMessages r' handle_errorszhyperliquid.handle_errorsys 4!!(Hb99  733 U??&&x<>/62>>D~~dJ;;H1c(mm,,  **8A;@@&E'4"nnT8R@@ ++KAA*&G7S=4'#4/Dgm  ^  0 01I7T\ ] ] ]  0 01I7T\ ] ] ]  *)) )tr(rGETc||jd|dz|z}|dkrddi}||}||||dS)Nrr.POSTz Content-Typezapplication/json)rBrrr)implode_hostnamerjson)r%pathrrrFrrrBs r'signzhyperliquid.signsh##DIe$4S$9::S@4G V   2G99V$$DfdwOOOr(cxd|vr d|vr|d}|d}||vr||S||ddS)Nrrrr)r1)r%rrrrFconfigrrs r'calculate_rate_limiter_costz'hyperliquid.calculate_rate_limiter_costsS   Vv%5%5&>DH%Fv~~d|#vvq111r(c||}d} ||ddd\} }|| } |d}||||||d} i} | | | d<||| d<| | gS)NrQrrWr,)r,rrrSrrFr2)r4r[r) r%r2r,rrrSrrFr4rrrs r'rz(hyperliquid.parse_create_edit_order_argssV$$ #>>v}Vdfyzz f00>> !     #+7L ( >E$K|$$r()N)T)NN)__name__ __module__ __qualname__rr#r*r)rr4rIrKrrnr r rzrsrqfloatrrrdictrrrrr rr rrrrrrr3rrrZrMrVrr]rarerlrurwrrobjectrrrrrrrrrrr_rrrrrrrrr rrrrrr#rrErDrCrIrrbrfrlrornrryrrrrrrrrrrrrrrrrrrrrrr rr rrrrrrrrr*rr?r>r rErOrNr\r`rdrgrnrrruryr|rWrrr-rrrr __classcell__)r&s@r'r/r/sX #X X X X X X t ..... 7S 7_ 7 7 7 7 7 7)+    0') 3 3 3 3-/LL:LLLL\*,V 6/1DDT&\DDDDL/17*7*T&\7*7*7*7*r(1u(1u(1[`(1(1(1(1T/1kkT&\kkkkZf 4f Ff f f f PAcAcAAAA *,a)a)a)a)a)a)F@DB.f.fS.f.fS\.f.f.f.f`6:"-G-G7-G-G-G-G-G^<@797979|79797979r/ / v/ / / / / b46B?CQUdhqs8]8]8]8]38]^a8]x|~ByC8]8]8]8]t   4    0<@d[]8A8A8AS8A8A8A8A8At}}}kkkkkk:::   LLL     J J J J**TZ****X    C C C C C C C C C C C C C C C C C C. 7 7# 7 7 7 7D DHW\eg#-#-s#-S#-#-#-#-JCE.7.7c.7.7.7.7`GI+7+7+7+7+7+7ZDFs*mqy{IYX]fi6lnFOFOcFOFOEFO]bFOrwFOFOFOFOPFH)9)9$|*<)9)9)9)9Vmqy{9939i9y9Z]9fi9999v46hh$hhhhT9=R))S)#)))),AER--tCy-#----^>B"7G7G#7Gs7G7G7G7GrCGr22c2C2VZ2222hY[F5F5d;N6OF5F5F5F5PBD&&S&&&&P24iiiiVZ^lpy{33cSVfi:DF4+4+\(:4+4+4+4+lWY$$s$$#$$$$L>BPTcgpr5O5Os5O#5O]`5O5O5O5On59tZ^gi5H5Hc5H5HTW5Hnrsxny5H5H5H5Hn7;\`ik U U U3 UVY Uptuzp{ U U U U9=4^bkm U U# US UX[ Urvw|r} U U U UDHVZimvx U US UPS Ucf U~BCH~I U U U U04$UYbd?E?E?EC?Es?Eimnsit?E?E?E?EB8JPJPJPJPXJ J tJ VJ J J J XDHPR333S3333j?C2..3.....`CE N Ns NE NI[ N N N NFH Q Q# Qu QL^ Q Q Q QLN% % % Rd% % % % N  d F N`    &aca1a13a1a1Ca1TWa1gta1a1a1a1F  t x =    QU]_<0<03<0<0<0#<0do<0<0<0<0|1 1 T1 X1 Q\1 1 1 1 f;=9494c94AT94949494v, , T, 6, EX, , , , \.2SW`b&?&?s&?#&?S&?gklwgx&?&?&?&?P''t'x';''''R88804$UYbd7E7E7EC7Es7E7E7E7Er37TX\eg5H5HC5Hs5HRU5Hlpq|l}5H5H5H5Hn=A ? ?' ? ? ? ?=?      FB9=4^bkm+B+B#+BS+BX[+B+B+B+BZ# # 6# # # # J@B3d*:<S4,.C I IT I I I Irs 655555111111 KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK******......''''''......))))))******))))))......000000999999======444444%%%%%%nF%nF%nF%nF%nF%(KnF%nF%nF%nF%nF%r(