ei `ddlmZddlmZddlZddlmZmZmZm Z m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZm 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,m/Z/ddl,m0Z0ddl1m2Z2GddeeZ3dS))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_modevs3 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.marketzs < *? ?@@ @  4<)?)? ,,s++K'' Q77H"&..?TVX"Y"Y ..."&"2"23F"Q"Q((a88 33ODDsJUR  ,,< 22[$''..v666r(cddi}||||}||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 ` rrspecialStatusesNok maintenancetime)statusupdatedetaurlr)publicPostInfoextendr1 safe_integer)r%paramsrequestresponser?s r' fetch_statuszhyperliquid.fetch_statuss $ &&t{{7F'C'CDD !!(,=>>%~ddM((6::    r(cddi}||||}||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 rrr>)rCrDrE)r%rFrGrHs r' fetch_timezhyperliquid.fetch_timesL $ &&t{{7F'C'CDD  6222r(c|dr|ddi}||||}||dg}i|jd<i}t dt|D]m}|||i}| |d}| |d} | | } | |jd|<| || | | | |d |d d d d d d d d d d d d 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 FrspotMetatokensrrrr3 weiDecimalsNcryptominr)amountr) r2r3code precisionractivedepositrnetworksfeerlimitsfullNamezUnit Ur)check_required_credentialsinitialize_clientrCrD safe_listrrangelenr2r1r3safe_currency_structureparse_precision startswithr0)r%rFrGrHrNresultidatar2r3rTr[ isWrappedparts nameWithoutUjbaseCodes r'fetch_currencieszhyperliquid.fetch_currenciessX  * *5 1 1 %  " " $ $ $ J &&t{{7F'C'CDD (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(cV||jdi}||d}g}tdt |D]}||}|dkr)|||9|dkr)|||h|dkr(||||}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?r) r2rr`rarbappendfetch_swap_marketsfetch_spot_marketsfetch_hip3_markets array_concat) r%rFrr rawPromisesrg marketTypepromisesrfs r' fetch_marketszhyperliquid.fetch_marketss4..~rBBw00 q#e**%% D DAqJV##""4#:#:6#B#BCCCCv%%""4#:#:6#B#BCCCCv%%""4#:#:6#B#BCCCq#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 ddi}||||}||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|rr~rr)rCrDr2r`rarbrpr) r%rFrGrHrr~rrfrgrhs r'rqzhyperliquid.fetch_swap_marketss & &&t{{7F'C'CDD@~~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(cddi}||||}||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|dd d|$d|d|dd dd d ddd dd d d!d"d!d#d!d$dd!d d ||d d d d d ||||||#d%d d d&d d d&d d d&|d'd d&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 rspotMetaAndAssetCtxsrrr~rNrr3r?rrNrr.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{{7F'C'CDDZxB//!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(c,||ddduo||ddu}d}|d|\}}d}|dd|\}}d}|d|\}}d}|d|||\}}||d}|dks|o|du}|rdnd |d } ||| |} | | 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_balances"++FFIFFdRNX\XfXfgmpEYFYFJNYN  "88PP V99.$PVWW f !??PVWW F#'#:#:>;Xegm#n#n &vu--6>6&6ISD[17R,,>R  &&t{{7F'C'CDDH>>(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 |||}d|dr|dn|dd}||||}||dg}||dg||dgd }||d } |||d | d d ddS)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 rrAr6r2rrlevelsrr)bidsasksr>r,rrpxsz) load_marketsr4rCrDr`rEparse_order_book) r%r,rrFr4rGrHrhrfrs r'fetch_order_bookzhyperliquid.fetch_order_books V$$*0.JF:&&fTl  &&t{{7F'C'CDD.~~h"55NN4B//NN4B//  %%h77 $$VVH-=y&RXZ^`deeer(symbolsc|||}g}||d}||d}d}||ddd\}}|Y||d}|A||}|||ddrd}|r,||d}||}nM|d kr| |}n1|d kr| |}n| |}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 ` rFrrNrrTr?rAr,)r market_symbolsr1omithandle_option_and_paramsr4rr2rsrrrqrxrarb parse_tickerfilter_by_array_tickers) r%r rFrHrr firstSymbolr4rfrgrtickerr,s r' fetch_tickerszhyperliquid.fetch_tickerss %%g..//66**44V^VUZ[[ f  **7A66K&[11>>$.."@"@&II D  2YYvv..F..v66HH V^^..v66HH V^^..v66HH))&11Hq#h--(( $ $Aa[F&>D&&tV44F%%fh77F#F6NN++FHgFFFr(c ddi}||||}||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|rr~r)rCrDr2r`rarbrpparse_funding_rates) r%r rFrGrHrr~rrfrgrhs r'fetch_funding_rateszhyperliquid.fetch_funding_ratess & &&t{{7F'C'CDD@~~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%rr4r3r0bidAsks r'rzhyperliquid.parse_tickerIs //))$//!!(F33 44X&!--fkBB%%fg66$$VW55##FA..##FA..++FK@@ ! !     r(r timeframesincecd|||}||d|}|du}|} |C|?||dz} ||| |zdz}|dkrd}d}nd}||dg}d|dr|d n|d ||j||||d d } | | | |} | | ||| ||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 untilNrrFrrAr6r2)rr* startTimeendTime)rreq) r r4rEr/parse_timeframerrr1rrCrD parse_ohlcvs) r%r,r>r?rrFr4rAuseTail originalSincetimeframeInMillisecondsrGrHs r' fetch_ohlcvzhyperliquid.fetch_ohlcvjs] V$$!!&'43D3D3F3FGG4- = *.*>*>y*I*ID*P'(?%(G"(LMM199E6G9--$.4VnNz**&, ,,T_iSS"   &&t{{7F'C'CDD"  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(cd}|d|\}}|d}|||}d|i}| d|d<||d<nd|d<||d}||d}|||d <||||} || |||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 ` NrruserFillsByTimerrC userFillsrArDrr r4rErrCrD parse_trades r%r,r?rrFrr4rGrArHs r' fetch_tradeszhyperliquid.fetch_tradess" "88OO V   [[((F K   /GFO#(GK )GFO!!&'2267++  !&GI &&t{{7F'C'CDD*  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 secp256k1rersrR)rnrorR)ecdsar)r%rhr signatures r' sign_hashzhyperliquid.sign_hashsfJJtCDDz:cdd+;[$OO  #& #&"in--   r(cd||||ddS)Nrl)rsrj)r%rirs r' sign_messagezhyperliquid.sign_messages-~~d//88*STT:JKKKr(Tc|rdnd}||dS)Nba)source connectionId)r%rh isTestnetrys r'construct_phantom_agentz#hyperliquid.construct_phantom_agents%",    r(cL||}||}|}|d||zz }||dz }n |dz }||z }| |dz }|d||zz }|||ddS)N000000001rfbinary)packbbinary_to_base16 int_to_base16rhbase16_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)NrFri9rrchainIdr3verifyingContractr6Agentrystringr3rrzbytes32)rrrr}r1eth_encode_structured_datarur)r%rr vaultAdressrrhr| phantomAgentrrdomain messageTypesmsgrrs 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)r1rrrur)r%rrirrrrrrs r'sign_user_signed_actionz#hyperliquid.sign_user_signed_actionTsl&&t|]CC 0!,    --flGLL%%c4?;; r(cVdddddddddddddgi}|||S) NzHyperliquidTransaction:UsdSendhyperliquidChainrr destinationrSr>uint64rr%rirs r'build_usd_send_sigzhyperliquid.build_usd_send_sigasU ,+X>>&99!84422 / ++L'BBBr(cVdddddddddddd dgi}|||S) Nz'HyperliquidTransaction:UsdClassTransferrrrrStoPerpboolrrrrs r'build_usd_class_send_sigz$hyperliquid.build_usd_class_send_siglsU 5+X>>!844!622 (33 8 ++L'BBBr(cVdddddddddddddgi}|||S) NzHyperliquidTransaction:WithdrawrrrrrSr>rrrs r'build_withdraw_sigzhyperliquid.build_withdraw_sigwsU -+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(cZ||jddrdSd|jd<d||jddd}|}|||}|||d}d} ||}|S#t $r }d}Yd}~nd}~wwxYw|S) NrefSetFT setReferrerrefCCXT1)rrTrrrr)rrr1r/rprivatePostExchange Exception)r%rrrrrGrHes r'set_refzhyperliquid.set_refs >>$,% 8 8 4!% X!$$T\5'BB  !!##''66 "    //88HO   HHHHHH s;B B(B##B(rrc|}||jdd}|rdnd|||d}||}|dd|d|d |d d }|||dd }||S) NrFTestnetMainnet)rrrrr0x66eeerrapproveBuilderFee)rsignatureChainIdrrrrrrrrr)r/rrrr) r%rrr isSandboxModepayloadsigrrGs r'approve_builder_feezhyperliquid.approve_builder_fees!!##t|]EJJ -: I $    0099 '(: ; )!,/y)'      ''000r(c |||dddign#t$r }Yd}~dSd}~wwxYwdS)NrZFT)handle_builder_fee_approvalrrr)r%rs r'r_zhyperliquid.initialize_clientst   - - / /AXAXYgimotvxAyAy z z z   55555 ts?A AAc|||jdd}|sdS||jdd}|rdS ||jdd}||jdd}|||d|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  $ $Wj 9 9 915DL- . . / / /).DL & & & & & & /tsAB B9% B44B9Fmethodrc@d}||}n|d|\}}d}|||d\}}||r[d|d}d} ||||}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 ..t{{7F/K/KLL    #+.@"@ 2EDL. /#V,,s )A33 B =BB rcd}|d|\}}|}||jdd}||dd}||d}|rdnd|||d }||}|d d |d |d ||d} | ||dd} || S)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)rr/rrr1rrr) r%rrFrrrrrrrrGs r'set_user_abstractionz hyperliquid.set_user_abstractions  "889MvVV V!!##t|]EJJ 0DEE66**-: I &    --g66 '(: ; )"=1FO      ''000r(r+cd}|d|\}}|}||jdd}||dd}||d}|rdnd|||d }||}|d d |d |d ||d} | ||dd} || S)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)rr/rrr1rrr) r%r+rFrrrrrrrrGs r'enable_user_dex_abstractionz'hyperliquid.enable_user_dex_abstractionHs  "889SU[\\ V!!##t|]EJJ 0DEE66**-: I     11':: '(: ; )y)FO      ''000r(c|}d|i}d|d}|||}||d<||d<||||}|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)rrrrrr/rrrD)r%rrFrrGrrrrHs r'set_agent_abstractionz!hyperliquid.set_agent_abstractionus!!## U *&  ''66 "( ++DKK,H,HIIr(rsiderSc ||d||||||\}}||g|} | 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|##UG\::ayr(durationct||||}|}|dk}d} ||dd} ||d}||dd\} }|| } ttj |dz dz } | |d || ||||d d| | d } d | d } | | || }| ||d}| ||d}| |d<||d}|||d<||d}||}||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 ` BUYN randomizeFrQrrrr reduceOnly)rxrwrornmrM twapOrder)rtwaprrrHrhr?runningtwapIdr?oid)r r_r4r/rrrformat_vault_addressrr-r.rr_rrErr2r1 parse_order)r%r,rrSrrFr4risBuyrr durationMinsorderObj orderActionrrrGrrH responseObjrhr?rorderIds r'create_twap_orderzhyperliquid.create_twap_orders\     V$$!!## NN6;>> 6;//#<> 4:ho&:;;<< ""6(#344))&&99 e<<      '' ULII !"    #YYv~66F&2GN #((@@  #&2GN #YYv~66F++G44nnXz2>> ~~k6266h33..B77""7H559W E EvNNNr(rc|||||}||}||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 ` rHrhstatusesrwaitingForTriggerr?N) r r_create_orders_requestrr2r`rarbrp parse_orders) r%rrFrGrHrrhrordersToBeParsedrgrs r'rzhyperliquid.create_orderss     ,,VV<<++G44$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) rrrr rrr rrr rrxrwprornrMrQ)r4upperrr1rsafe_string_lower capitalizer"r2r- string_mul string_add string_subrcr_rr)r%r,rrrSrrFr4rrrrdefaultTimeInForcer r rrr isTriggerrrr 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 ` rrFrrFrrNTzV createOrders() all orders must have clientOrderId if at least one has a clientOrderId rrrrrr rrr nar,rrrSrstopLoss takeProfitrr rrrgrouping normalTpsl positionTpslrr4z3 only support grouping normalTpsl and positionTpsl.)r%r&r'r]rsellbuy)rr)rrrQrr)rrr'rrrfeeIntr)rwfr)r^r1rrarbr2rr"r2rr/r4safe_string_upper safe_valuer! safe_string_nrpr'rDrrrrrEr)&r%rrFrhasClientOrderIdrgrawOrder orderParamsrrorderReqr'r0r4r,rrrSrrr%r& hasStopLoss hasTakeProfit mainOrderObjstopLossOrderTriggerPricestopLossOrderTypestopLossOrderLimitPricetakeProfitOrderTriggerPricetakeProfitOrderTypetakeProfitOrderLimitPricetriggerOrderSiderrrwalletrrrGs& r'rz!hyperliquid.create_orders_requestSsF '')))**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--- ---- #<>    >>$,(` rFr)rrcancel_twap_order cancel_ordersr2)r%r2r,rFrs r' cancel_orderzhyperliquid.cancel_orderst >>&&% 0 0 >YYvv..F))"ff== =##RD&&99~~fa(((r(idsc6||t|jdz||||||}||}||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%rDr,rFrGrH innerResponserhrrrgr?s r'rBzhyperliquid.cancel_orderss) ''))) >#DG.Z$Z[[ [     ,,S&&AA++G44x<< ~~mV44>>$ 33q#h--((  Aa[F MM$// ++     r(c2||t|jdz||}d}||dd\}}||}d||d||d}|}| |||}|||d} || |d}|| d<| |d } | | | d <| |d }| | } | | 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)rrxrMrrrHrhr?r)r r"r2r4rrrparse_to_numericr/rrrErr2r1r)r%r2r,rFr4rrrrrrGrrHrrhr?s r'rAzhyperliquid.cancel_twap_order s  >#DG.]$]^^ ^V$$ #<>  ""6(#344&&r**   !!##''|DD "    #YYv~66F&2GN #((@@  #&2GN #YYv~66F++G44nnXz2>> ~~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 rrrr]rcancelsrN cancelByCloidrr)assetcloidcancel)rxrNrPrJrsubAccountAddressrrr) r4 safe_value_2rr/rM isinstancelistrarbrphandle_option_and_params_2rr)r%rDr,rFr4rrrG cancelReq cancelActionrrgrrrs r'rGz!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(c:||||}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|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 ` rr]rOFrrNTr2r,zB cancelOrdersForSymbols() requires a symbol argument in each orderzI cancelOrdersForSymbols() all orders must have either id or clientOrderIdrRrxrSrNrrQrTrrPrKrrUrrrr)r^r r_r/rarbr1r"r2r#r4rMrprYrrrrrH)r%rrFrrGrZr[rQrgrrr2r,assetKeyidKeyr4 cancelObjrrrrHs r'cancel_orders_for_symbolsz%hyperliquid.cancel_orders_for_symbolso 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 #++G44 23344r(timeoutc|||||ddg}|}d|i}d||zd}d}||ddd \}}||}||||}||d <||d <|||d}||d<||}|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 rrrscheduleCancel)rr>NrHrrUrrr) r^r r_rr/rYrrr) r%rarFrrGr[rrrrHs r'cancel_all_orders_afterz#hyperliquid.cancel_all_orders_after s4 '')))     6O[#ABB!!## U  %GO   #>>vG]_mpC D D f00>> '' e\JJ ((   #YYv~66F&2GN #++G44r(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)/NFrrFrrTzT editOrders() all orders must have clientOrderId if at least one has a clientOrderIdr#r2r,rrrrrSrrrr r r r r rr rrr) rr rrrrrr rrrrrrrrrrrrQ)rr batchModify)rmodifiesrWrr)r^rarbr2rr"r2rr1r4r.rrrrrr-rrrrcr_rrpr/rrr)(r%rrFr1rgr2r3rrgr2r0r4r,rrrrrSrrrrr r rrrrrrrrr r4 modifyReqr modifyActionrrrrGs( 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 ||t|jdz||||||||\}} ||g| } | 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_orderJ sz,  :#DG.T$TUU U"??FDRVX^`egmnn|!!5'<88ayr(c\|||||}||}||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 ` rHrhr)r r_rjrr2r`r)r%rrFrGrHresponseObject dataObjectrs r'rlzhyperliquid.edit_ordersg s     **66::++G44H*bAA^^NFB?? >>*j"==  ***r(r3 description initialUsdc|||}d|i}|t j||d}d||||d}|||} ||d<| |d<|| ||} | 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 r1000000 createVault)rr3rqrrrrrr) r^r r/rr-rrrrrD) r%r3rqrrrFrrGusdrrrrHs r' create_vaultzhyperliquid.create_vault s ''))) !!## U  243H3H3T3TV_ ` `aa!&   ''66 "( ++DKK,H,HIIr(c >||t|jdz||}d|dd}|||d<n)|dn|}||dzdzd zz |d<||d }||d }|||d <||||} 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 argumentfundingHistoryr6rrCirrrArDrr>r!)rr,r!rrr)r r"r2r4r/rErrCrDrarbrpr,rrsort_byfilter_by_symbol_since_limit)r%r,r?rrFr4rGrrArHrfrgrrsorteds 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{{7F'C'CDDq#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(cpd}|d|\}}d}||ddd\}}|||d}d}|1||}||} | | |d<||||} 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,r?rrFrrrGr4rrHorderWithStatusrgr extendOrders r'fetch_open_orderszhyperliquid.fetch_open_orders sc  "889JFSS V66v?PRZ\pqq     [[((F33F;;G"!(&&t{{7F'C'CDDq#h--(( D DAQKEKx008,2 L)  " "4;;uk#B#B C C C C  &%GGGr(c|||dd|}||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,r?rrFr closedOrderss r'fetch_closed_orderszhyperliquid.fetch_closed_orders9 sd ""64v>>++FHxj%PP 00vueTTTr(c|||dd|}||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_ordersH sd ""64v>>++FHzlERR 00vueTTTr(c|||dd|}||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_ordersW sj ""64v>>++FH>`>`>`bghh 00vueTTTr(cd}|d|\}}|d}d|d}|1||}||}|||d<||||} 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 r4rrCrDrarbr2r1rErXvaluesr)r%r,r?rrFrr4rGrrHdeduplicatedByOidrgr2rrexistingTimestampcurrentTimestamp deduplicateds r'rzhyperliquid.fetch_ordersf s "88OO V &    [[((F33F;;G"!(&&t{{7F'C'CDD*#%q#h--(( : :A{HNN8W55E} ""5%00C000-5%c**(,(9(9:KC:PRc(d(d%'+'8'8CT'U'U$'39J9RVfizVzVz19)#.-446677   vueDDDr(c d}|d|\}}|d}|||}||d}d|d}|||d}||d<n/t |dk}|r|n|||d<||||} | | 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 r4r1rrbrMrCrDr2r) r%r2r,rFrr4rrGisClientOrderIdrHrhs r' fetch_orderzhyperliquid.fetch_order s "88vNN V   [[((F((AA !    $YYv77F*GENN!"ggmO#2QRR8M8Mb8Q8QGEN&&t{{7F'C'CDD8~~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)+NerrorrrF)rrestingfilledrrr2r,rr?rrAr*r+origSztotalSzrrALOrrrrSrlastTradeTimestamplastUpdateTimestamprrrr r rrlimitPxrrrrSravgPx)averager remainingr?rYtrades)r1rH safe_dict_nr2r+r;rErrr.rparse_order_typerrrr-rparse_order_status)r%rr4rrrrr0r,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(cd}|d|\}}|d}|||}d|i}| d|d<||d<nd|d<||d}||d}|||d <||||} || |||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 ` NrzrrVrrCrWrArDrXrZs r'fetch_my_tradeszhyperliquid.fetch_my_trades s "88&QQ V   [[((F K   /GFO#(GK )GFO!!&'2267++  !&GI &&t{{7F'C'CDD,  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>rrrr,tidrrr*r+rYcrossedrrrrfeeToken)rcurrencyrate) rrrr,r2rrr takerOrMakerrrSrrY) rEr1r+r;rr-r safe_trader)r%rr4rrrSrr0r,r2rrYrrrs r' parse_tradezhyperliquid.parse_trade s&%%eV44   --!!%..v..))$//!!(D11!   eU + +v..  "ckk66Due,, .. 22  &-:777L%%e\::  !$S*55C" Y//%%eU33( ,,UJ??  $ % r(c^||g|}||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 ` r)fetch_positionsr2)r%r,rF positionss r'fetch_positionzhyperliquid.fetch_position s1((&6:: ~~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 |d}|d|\}}||}d|d}|d|}|||d<||||}||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%r rFrrGrrHrhrfrgs r'rzhyperliquid.fetch_positions* s#  "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%rr4rrr0r,r r isIsolatedrawSizesizerrawUnrealizedPnlabsRawUnrealizedPnlrrrs r'rzhyperliquid.parse_positionv 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(rc|t|jdz|||}||d}|t|jdz||d}|dk}|}||dg}d|||d} d} ||d d d \} }| +| d r| d d } | | || } | || d} | | | d <| | } | 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 parameterrcrossupdateLeveragerrRisCrossr rrrUrer]r) r"r2r r4rErr/rrYrerrr)r%rr,rFr4r rRrr updateActionrrrrGrHs r'set_margin_modezhyperliquid.set_margin_mode s >#DG.[$[\\ \ V$$$$VZ88  #DG.^$^__ _!!&"233(!!##6J<00$    #>>vXfh{|| f  #&&t,, >+33D"== '' e\JJ ""    #&2GN #++G44r(r c^|t|jdz|||}||dd}|dk}||d}|}||d}d|||d} d} ||dd d \} }| | } | | || } | || d } | ||d }| | d <| | } | 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 argumentrrrrrrrrUr) r"r2r r4r1rr/rrYrrr)r%r r,rFr4rrrRrrrrrrGrHs r' set_leveragezhyperliquid.set_leverage s\ >#DG.Y$YZZ Z V$$%%flGDD (!!&"233!!##6<00$    #>>v}Vdfyzz f00>> '' e\JJ ""    #YYv~66F&2GN #++G44r(c2|||d|S)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 ` addmodify_margin_helperr%r,rSrFs r' add_marginzhyperliquid.add_margin's((GGGr(c2|||d|S)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 ` reducerrs r' reduce_marginzhyperliquid.reduce_margin6s((6JJJr(c|||}||d}|tj|||d}|dkr| }|}d|d|d} d} ||ddd \} }|| } | | || } | || d } | | | d<| | } | | | |d | | d iS) NrrtrupdateIsolatedMarginT)rrRrntli modifyMarginrrUrrTr?)r r4rr-rr_r/rYrrrrDparse_margin_modificationr1)r%r,rSrrFr4rRrrrrrrrGrHs r'rz hyperliquid.modify_margin_helperEsz V$$!!&"233   w1$2J2J6SY2Z2Z\eff g g 8  B!!##*    #>>v~Wegz{{ f00>> '' e\JJ ""    #&2GN #++G44{{499(FKK D$$Xx88N    r(rhc l||d|dddd||ddddd S)Nrr) rr,rrrSrrTr?rr)r,r1)r%rhr4s r'r z%hyperliquid.parse_margin_modificationlsQ&&tV44$$$VX66   r( fromAccount toAccountc8||||jd}|}||gdr||gdst |jdz||}| |dd} | | | } |dz| z}|dkp|d k} |rd nd || |d } | | } | d dd|| |d|| d} | | }|Sd}d}|dkr|}d}n |dkr|}nt |jdz| |||dkr|t!j||d}d|||d}|||}|||d}| |}||S||}d|||||d}|||}|||d}| |}||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 ` r)r?rAperpz. transfer() only support spot <> swap transferrrUNz subaccount:rrArr)rrSrrrrusdClassTransfer)rrrrSrrrFmainTz4 transfer() only support main <> subaccount transferrrtsubAccountTransfer)rsubAccountUser isDepositrvsubAccountSpotTransfer)rrrtokenrS)r^r rrr/in_arrayr'r2rrrrr check_addressrrr-rrparse_transferr,)r%rTrSrrrFrr strAmountrrtransferPayload transferSigtransferRequesttransferResponserrUrvrrrGrHr,s r'rzhyperliquid.transfers8 ''))) t|]CC !!## ==&>&>&> ? ? $==,D,D,DEE _"47-]#]^^^--f55I--fnFYZZL'#88FF %6E 6)CyF/BF1>$MIII#  %%O 77HHK)88J(K(1.'$" ( % %O $77HH # #   & ) II & +  tw)__`` ` ,--- <4::<<611##G$6t7L7LV7T7TV_$`$`aaC,"3& F %%fe44C  G //88H&&x00 0[[&&F0"3&//77 F%%fe44C  G //88H&&x00 0r(rrc |ddddddddd S)Nr<) rr2rrrrSrrr?r{)r%rrs r'rzhyperliquid.parse_transfers.    r(tagc|||||1|}|dkrt |jdzd}||dd\}}||}||d}| }i}d} |!dd|zd|d }| ||} ne| |j d d} | rd nd |t||d } || } | dd|t||dd}||| d} || } || 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 vaultTransferreF)rrrrvrrr)rrrSr>rr withdraw3)rrrrSr>rr)r^r rrr'r2rrrr/rrrstrrrparse_transaction)r%rTrSrr#rFrrrrrrrGrHs r'rzhyperliquid.withdraws '')))  7###  ::<> 6>22!!##  #' $| 3" F %%fe44CC NN4<NNM1>$MIII&f++ G ))'22C$+,>$?$-&f++# F   ++G44%%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>deltarYrrrrinternalTransferrr2txidrhrrnetworkr addressTor addressFromrr#tagTotagFromrSusdcrr?r@)commentinternalrY)rEr2r1rr) r%r)rrr+rYfeeCostr6rs r'r(zhyperliquid.parse_transaction0s%%k6:: {GR88##E511  "Cv..   22H K $  D$$[&99     Y//  t   t  ))%??  4++E6::  4  T  t  D  d&&uf55   d&&{H==! " t# $ )    r(cl|d}|d|\}}||}d|d}||||}||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_feecs  "889JFSS VV$$  &&t{{7F'C'CDDJ"--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(cb|d}|d|\}}d|d}|||d<||d}|||d<||dg}||||}||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 ` NrquserNonFundingLedgerUpdatesrrCrArD)r rrErrCrD parse_ledger) r%rTr?rrFrrGrArHs r' fetch_ledgerzhyperliquid.fetch_ledgers  "88OO V1    #(GK !!&'22  !&GI YYvy11F&&t{{7F'C'CDD  4>>>r(itemc(||d}||di}d}||d}|d|d}||d}||d}||||ddd||d ||d||d|||||ddd|d |S) Nr>r+rYrr,rr4rhr)rr2 directionrreferenceAccount referenceIdrrrSrrbeforeafterr?rY)rEr2r1safe_ledger_entryparse_ledger_entry_typer$r) r%rDrrr+rYr7rrSs 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'rLz#hyperliquid.parse_ledger_entry_types. *$.   D$777r(c8|d}|d|\}}d|d}|||d<||d}|5|t|jdz||d<||dg}||||}||} 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 ` NfetchDepositsWithdrawalsrArrCrAz0 fetchDeposits requires since while until is setrDrrr vaultDepositr+vaultrerWF)r rrEr"r2rrCrDextract_type_from_deltarrrarbr2rprparse_transactions)r%rTr?rrFrrGrArHrecordsrdepositsrgrecordr+s r'fetch_depositszhyperliquid.fetch_deposits$s  "889SU[\\ V1    #(GK !!&'22  }'2d(deee!&GI YYvy11F&&t{{7F'C'CDD..x88 #<>   #1c'll++ 0 0 &>^33 NN67;;EW~ )<<< ///  0++GVi[%PPH&&xueDDDr(c|d}|d|\}}d|d}|||d<||d}|||d<||dg}||||}||} 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 ` NrRrArrCrArDrrr vaultWithdrawr+rTrerF)r rrErrCrDrUrrrarbr2rprrV)r%rTr?rrFrrGrArHrWr withdrawalsrgrYr+s r'fetch_withdrawalszhyperliquid.fetch_withdrawals]s  "889SU[\\ V1    #(GK !!&'22  !&GI YYvy11F&&t{{7F'C'CDD..x88 #<>   #1c'll++ 3 3 &>_44 NN67;;EW~ )<<<#**6222  3..w eTTK&&{D%GGGr(c|||}|}|||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: )r rrqparse_open_interests)r%r rF swapMarketss r'fetch_open_interestsz hyperliquid.fetch_open_interestssP %%g..--// ((g>>>r(c||}|||g|}||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 ` )r,r rb)r%r,rFoiss r'fetch_open_interestzhyperliquid.fetch_open_interestsHV$$ ''&996{r(c ||di}||d}d}|||}|||||dddd|d|S)Nrr3 openInterest)r,openInterestAmountopenInterestValuerrr)r2r1r+safe_open_interestr,r)r%interestr4rr0s r'parse_open_interestzhyperliquid.parse_open_interests&>>(FB77&11  --d33H&&&&x00"&"2"28^"L"L!% ( (   r(c|d}|||}d}|d|\}}|dd}|||d<||d}||d}|||d<||||} || |||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)rrrCrArD)r r4rrErrCrD parse_incomes) r%r,r?rrFr4rrGrArHs r'fetch_funding_historyz!hyperliquid.fetch_funding_historys   [[((F "889NPVWW V!    #(GK !!&'2267++  !&GI &&t{{7F'C'CDD"!!(FE5AAAr(c ||d}||d}||d}||d}d}|||}|||}||d}||dd} ||d} ||d | ||||||| d S) Nrhr>r+rr4rrr!r,)rr,rTrrr2rSr)r1rEr2r+r;rrr$) r%incomer4r2rr+rr0rSrTrs r' parse_incomezhyperliquid.parse_incomes  ff - -%%ff55 vw//v..  --d33H!!(F33!!%00&99}55X&" Y//''//   r(weightc|}d|i}d|d}|||}||d<||d<||||}|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)rrtrrrr)r%rtrFrrGrrrrHs r'reserve_request_weightz"hyperliquid.reserve_request_weights!!## U +  ''66 "( ++DKK,H,HIIr(c<|}d|i}d|d}||d}|||d}||d<|||d|}||d<||d<||||}|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)rr3rNrrr)r/rErrrrD) r%r3rFrrGrrrrrHs r'create_sub_accountzhyperliquid.create_sub_account4s!!## U '  ((@@  #YYv~66F&2GN #''t\JJ "( ++DKK,H,HIIr(cg}tdt|D]0}||}|dd|d<||1|S)Nrr+r)rarbrp)r%rhrWrgrYs r'rUz#hyperliquid.extract_type_from_deltaNs[q#d))$$ # #A!WF#G_V4F6N NN6 " " " "r(cd|dS|dr|ddS|S)Nrer])rer)r%rs r'rz hyperliquid.format_vault_addressVs; ?4   d # # -??4,, ,r(rFcd}|||dd\}}|}|||d|\}}| |dkr||gS|j|jdkr |j|gSt|jdz|zdz)NrrUrr]rzF() requires a user parameter inside 'params' or the wallet address set)rYrrr"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.rrB@rz /USDC:USDC)r2rr1findrr3)r%rhi3TokensBynamehip3Dictr8rTs r'r+zhyperliquid.coin_to_market_idhs <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?rriresponsePayloadrhrrg errorStatuserrorMsgfeedbacknonEmptyMessages r' handle_errorszhyperliquid.handle_errorsxs 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)r/)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)NrQrrUr,)r,rrrSrrFr2)r4rYr) 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 rxrsrqfloatrrrdictrrrrr rr rrrrrrr1rrrXrKrTrr[r_rcrjrsrur}robjectrrrrrrrrrrr_rrrrrrrrr rrrrrr!rrCrBrArGrr`rdrjrmrlrrwr}rrrrrrrrrrrrrrrrrrrrr rrrr rrrrrrr(rr=r<r rCrMrLrZr^rbrerlrprsrwrzrUrrr+rrrr __classcell__)r&s@r'r/r/sOX #X X X X X X t ..... 7S 7_ 7 7 7 7 7 7#%    0!# 3 3 3 3')LLZLLLL\$&$v,6)+DDtF|DDDDL)+7*7*tF|7*7*7*7*r(1u(1u(1[`(1(1(1(1T)+kktF|kkkkZf 4f Ff f f f PAcAcAAAA $&a)a)(a)a)a)a)F:>b.f.fs.f3.fY.f.f.f.f`04B-G-GW-G7-G-G-G-G^6:"797977979797979r/ / v/ / / / / b46B9=4^bkm8]8]#8]#8]S8]X[8]rvw{r|8]8]8]8]t   4    06:UW8A8A38As8A#8A8A8A8At}}}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. 13 1C 1 1 1 1D >BQV_a#-#-#-s#-#-#-#-J=?.1.1.1.1.1.1`AC+1+14+1+1+1+1Z>@*gksu3iyRW`c6fhFOFOFO9FOeFOW\FOlqFOFOFOFOP@B)9)9D$6)9)9)9)9Vmqy{9939i9y9Z]9fi9999v46hh$hhhhT37r))s)C)))),;?r--c-C----^8&&s&&&&P24iiiiVTXfjsuS#SS`c:>@4+4+$|"44+4+4+4+lQS$$$3$C$$$$L8<$]ajl5O5O5OC5OWZ5O5O5O5On/3TXac5H5H5H35Hc5Hhlmrhs5H5H5H5Hn154VZce U U# US UPS Ujnotju U U U U37TX\eg U UC Us URU Ulpqvlw U U U U>BPTcgpr U Us U# U]` Uw{}BxC U U U U*.Dt\^?E?E3?Ec?E?Ecghmcn?E?E?E?EB26b=.=.c=.3=.=.=.=.~WWWvWWWWWr:::::":::-1tRV_a7A7Ac7A7AC7A7A7A7Ar888v88888t24 0 0S 0 0 0 0sW$26bJPJPwJPT(^JPJPJPJPXJ J tJ VJ J J J X>B"33#3s3333j9=R..S.#....`=? H H He HCU H H H H@B K KC K KFX K K K KFH% % 3% L^% % % % N  d F N`    &[]a1a1Sa1%a1ca1ca1ana1a1a1a1F  t x =    KOWY<0<0S<0%<0#<0C<0^i<0<0<0<0|1 1 T1 X1 Q\1 1 1 1 f57949494;N94949494v, , T, 6, EX, , , , \(,$TZ\&?&?&?C&?s&?aefqar&?&?&?&?P''t'x';''''R888*.Dt\^7E7E37Ec7E7E7E7E7Er-1tRV_a5H5Hc5H5HC5Hfjkvfw5H5H5H5Hn7;2 ? ?G ? ? ? ?79  #    FB37TX\eg+B+BC+Bs+BRU+B+B+B+BZ# # 6# # # # J:<S*46s4,.C I IT I I I Irs ('''''111111 KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK******......''''''......))))))******))))))......000000999999======444444%%%%%%nF%nF%nF%nF%nF%(KnF%nF%nF%nF%nF%r(