E#ibLSSKJr SSKJr SSKrSSKJrJrJrJ r J r J r J r J r JrJrJrJrJrJrJrJrJrJrJrJrJrJrJrJrJrJrJ r SSK!J"r" SSK#J$r$ SSK#J%r% SSK#J&r& SS K#J'r' SS K#J(r( SS K#J)r) SS K#J*r* SS K+J,r, SSK+J-r- SSK+J.r. SSK+J/r/ SSK0J1r1 "SS\\5r2g))Exchange) ImplicitAPIN)AnyBalances CurrenciesCurrencyInt LedgerEntryMarginModificationMarketNumOrder OrderBook OrderRequestCancellationRequest OrderSide OrderTypePositionStrStringsTickerTickers FundingRate FundingRatesTradeTradingFeeInterface TransactionMarketInterface TransferEntry)List) ExchangeError)ArgumentsRequired) BadRequest)InsufficientFunds) InvalidOrder) OrderNotFound) NotSupported)ROUND)DECIMAL_PLACES)SIGNIFICANT_DIGITS) TICK_SIZE)Precisec  ^\rSrSrS\4U4SjjrU4SjrS\S\4U4Sjjr SS\ S \ S \ S \ S\4 U4S jjjr 04S\ 4S jjr04S\\ 4Sjjr04S\\ 4Sjjr04S\\ 4SjjrS\S\S\4Sjr04S\\ 4SjjrS \S\ 4Sjr04S\4SjjrS04S\S\S\4SjjrS04S\S\4SjjrS04S\S\ 4Sjjr!SS \ S\"4Sjjr#SS\S \ S\$4Sjjr%S SS04S\S!\S"\S\S\\&4 S#jjr'SS \ S\&4S$jjr(SS04S\ S"\S\4S%jjr)S&r*S\S\4S'jr+S(r,S)r-S*r.SS+jr/S,r0SS\14S-jjr2S.r3S/r4S0r5S1r6S2r7S3r8S4r9S5\S6\4S7jr:S8r;S9r<04S:\=4S;jjr>S04S\S<\?S=\@S>\S\A4 S?jjrB04S@\\C4SAjjrDS04S\S<\?S=\@S>\S\ 4 SBjjrE04S\4SCjjrFS04SD\S\ 4SEjjrGS04SF\\S\ 4SGjjrHS04SF\\S\ S\4SHjjrI04S@\\J4SIjjrK04SJ\4SKjjrL04SLjrMSS04SD\S\S<\S=\S>\AS\A4 SMjjrN04S@\\C4SNjjrO04SO\SP\SQ\P4SRjjrQSSS04S\ S"\S\4SSjjrRSSS04S\ S"\S\S\\S4STjjrTSSS04S\ S"\S\S\\S4SUjjrUSSS04S\ S"\S\S\\S4SVjjrVSSS04S\ S"\S\S\\S4SWjjrWSSS04S\ S"\S\S\\S4SXjjrXS04SD\S\ 4SYjjrYSSZ\S \ S\S4S[jjrZS\\ 4S]jr[S^r\SSS04S\ S"\S\4S_jjr]SS`\S \ S\^4Sajjr_04S\4Sbjjr`S04S\S\\a4ScjjrbSSd\S \ 4SejjrcS04Sf\S\ 4SgjjrdS04Sh\PS\ 4Sijjre04S\S>\S\f4Sjjjrg04S\S>\S\f4Skjjrh04S\S\f4SljjriSSm\S \ S\f4Snjjrj04So\S>\Sp\Sq\S\k4 SrjjrlSSs\St\mS\k4SujjrnS04So\S>\Sv\Sw\ S\o4 SxjjrpSSy\St\mS\o4Szjjrq04S\S\r4S{jjrsSS|\S \ S\r4S}jjrtSSS04So\ S"\S\S\\u4S~jjrvSS\St\mS\u4SjjrwSrxSSS04So\ S"\S\4SjjrySSS04So\ S"\S\S\\o4SjjrzS04S\4Sjjr{04S\4Sjjr|SS \ 4Sjjr}SSS04S\ S"\S\4Sjjr~SS \ 4Sjjr04S\AS\4Sjjr/4SjrSSv\ 4SjjrS\S\4SjrS\ 4SjrSo\PS\S\S\S\S\4 SjrSS0SS4Sjr04SjrS04SD\ S\S<\?S=\@S>\S\A4 SjjrSrU=r$) hyperliquidreturnc>UR[[U]50SS_SS_S/_SS_SS _S S _S S _S S _S0SS_SS _SS_SS _SS _SS_SS _SS_SS_SS_SS _SS _SS _SS _SS_SS_S S_0S!S_S"S_S#S _S$S _S%S _S&S _S'S _S(S _S)S _S*S _S+S_S,S _S-S_S.S_S/S_S0S _S1S _E0S2S _S3S_S4S_S5S _S6S_S7S_S8S _S9S:_S;S_SS _S?S _S@S_SAS_SBS_SCS _E0SDS_SES_SFS_SGS_SHS_SIS _SJS_SKS_SLS _SMS _SNS _SOS_SPS _SQS _SRS _SSS _STS _E0SUS_SVS _SWS_SXS _SYS_SZS_S[S:_S\S _S]S_S^S _S_S _S`S_SaS_SbS_ScS_SdS _SeS _ESSS S S SS S Sf.E_SgShSiSjSkSlSmSnSoSpSqSrSsStSuSv._SwSx_SySzS{S{S|.S}S}S|.S~SSSS._SSSSSSSSSSSS.S.00SSS00S|._SUR S5UR S5S.UR S5UR S5S.S._SSSS S S._S00S[ _S[ _S[ _S[ _S[ _S[ _S[ _S[ _S[_S[ _S[ _S[ _S[ _S[ _S[ _S[ _S._S[_0SSSSSSSSSSSSSSSSS. S/SQ0S.S SSSSSSSSSS.S S S S.S SS SS.SSSSSSSS.SS0SSSSS S.SSSS S.SSSSS S.SSSSSSS S.SSSSSSSS S.SS0S. SS0SS S SS.S.SS0SS0S.SS0SS0S.S.S.E5$)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 fetchTicker fetchTickers fetchTime fetchTradesfetchTradingFeefetchTradingFees fetchTransferfetchTransfersfetchWithdrawalfetchWithdrawals reduceMargin)repayCrossMarginrepayIsolatedMarginsandbox 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^VzW^XY^ZU[^\t]^^"4_^`#Ea^b c^d!%e^f"5g^h#Di^jk^l%*',#!%#(  {^OF P QOF p )qOF r k67 DD1[V:sOF P $&*++,67/0:;2323' ! ""A#QOF ~ !..y9!..y9 "..x8!..x8 OF R "!%" $SOF ^ ;\:L:;LA,  F|  TUa +L? KM*<-lXYe+L67H:;L >?P!_OF J YKOF L! &$#'K#!!'%#!###! (5!': $&+(-,0,1).+0).(-).1 -1$(%) 7$(#("&#( ( #($)$)+027/4#(;$@t%',!%$(%)*. &',#($)*. #',!%#($)*. (',!%$(%)#($)*.$',!%$(,0%)#($)*. * #WN`y ))-+/6:$":":  ":":  GkGOF O O cH>[[U] U5 XRS'g)Nr)rr.set_sandbox_moder)renabledrs rr#hyperliquid.set_sandbox_modems k41':&- ]#r!symbolc>URc[URS-5eXR;aURUnUS(aURUS5nUR UR S05nX4;aXURXC5nURUS5nUR U5S-U-nXpR;aURU$[[U]'U5nU$)Nz markets not loadedr?baseNamerquote/) marketsr!r2 safe_string safe_dictrsafe_currency_coderr.market) rr&r/r(runifiedBaseNamer) newSymbolresrs rr/hyperliquid.marketqs << *? ?@ @ \\ !\\&)Ff~++FJ?&*nnT\\CXZ\&]#2&*&6&67J&UO ,,VW=E $ 7 7 H3 NQV VI LL0#||I66K-f5 r!NmarketIdr/ delimiter marketTypec>UbURbXR;aURUn[U5nUS:XaUS$US:a[URS-U-5eUSnUSnUR US5UR US5:wa[URS-U-5eUR US5n UR UR S05n X;aU$U$[[U]'XX45$) NrrrzB safeMarket() found more than two markets with the same market id rzG safeMarket() found two different market types with the same market id baser) markets_by_idlenr!r2r,r-rrr. safe_market) rr4r/r5r6r+ numMarkets firstMarket secondMarket baseCurrencyrrs rr;hyperliquid.safe_markets(  "".XASAS5S,,X6 \ ?"1:%!A~+DGG6z,z~F-FGG")!*K#*1:L'' V<@P@PQ]_e@ff+DGG6,CK-KLL#'#3#3K#HL*...G\^`*a'#:++&&[$3Hi\\r!cURS5(aUR5 SS0nURURX!55nUR US/5n0n[ S[ U55HcnURXF05nUnURUS5n URU 5n URUU U SUSSSSSSSSS .SSS .S .S . 5XZ'Me U$) a0 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 Frmetauniverserr3Ncryptominr )amountr) r2r3code precisionractivedepositrnetworksfeerlimits) check_required_credentialsinitialize_clientpublicPostInfoextend safe_listranger:r-r,r.safe_currency_structure) rparamsrequestresponserBresultidatar2r3rHs rfetch_currencieshyperliquid.fetch_currenciess   * *5 1 1  " " $ F &&t{{7'CD~~h B7q#d)$A>>$2.DB##D&1D**40D77!    $# $#! 9FL %8 r!cURURS05nURUS5n/n[S[ U55HnX5nUS:Xa"UR UR U55 M/US:Xa"UR URU55 MWUS:XdM_UR URU55 M Un/n[S[ U55HnURXU5nM U$)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) r-rrSrTr:appendfetch_swap_marketsfetch_spot_marketsfetch_hip3_markets array_concat) rrVrr rawPromisesrZr6promisesrYs r fetch_marketshyperliquid.fetch_marketss..~rBw0 q#e*%AJV#""4#:#:6#BCv%""4#:#:6#BCv%""4#:#:6#BC&q#h-(A&&v{;F) r!c URSS05n0n[S[U55HnX$nSUS- S--nXcUS'M /nURURS05nURUS05n UR U S S 5n [U5n X:aLUR U S /5n [U 5S :Xa'[URS -[U 5-S-5eU nOQ[S[U55H8nURX$05nURUS5n URU 5 M: /n[S [U55HFnSURXt5S.nURURURX555 MH Un/n[S [U55HnXtn X=nUUnURUS 05nUR US/5nUR US/5n/n[S [U55HPnURURUU05URUU055nUU-US'URU5 MR URUURU55nM U$)a retrieves data on all hip3 markets for hyperliquid https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals#retrieve-all-perpetual-dexs 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 rperpDexsri'r3rwrr r<rz fetchHip3Markets() Too many DEXes found. Please specify a list of DEXes in the exchange.options["fetchMarkets"]["hip3"]["dex"] parameter to fetch markets from those DEXes only. The limit is set to z DEXes by default.metaAndAssetCtxs)rr<rCbaseId)rQrTr:r-r safe_integerrSr"r2strr,r_rRrc parse_markets)rrV fetchDexesperpDexesOffsetrZr<offsetfetchDexesListrr defaultLimit dexesLength defaultDexesdexNamerdrWrer+rXrBrC assetCtxsrYjr[s rrbhyperliquid.fetch_hip3_marketss(( J*  *!#q#j/*A-Cq1uo-F+1CK ( + ..~rB~~gvr2((w: *o  &>>$r:L< A%'3{){~ABN~O)ORf)fgg!-1c*o.nnZB7**37%%g./ q#n-.A*'':G   t224;;w3OP Q / q#h-(A$'G$-F{H>>(Ar2D~~dJ;HxB7IF1c(m,{{NN8Q3NN9a4"#VX d# -''1C1CF1KLG)^r!c SS0nURURX!55nURUS05nURUS/5nURUS/5n/n[ S[ U55HJnURURXX05URXh055n XS'UR U 5 ML URU5$)av 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 rrlrrCrrm)rQrRr-rSrTr:r_rp) rrVrWrXrBrCryrYrZr[s rr`hyperliquid.fetch_swap_markets^s & &&t{{7'CD@~~h2.>>$ B7NN8Q3 q#h-(A;;xB/yR0DN MM$  )!!&))r!ramountPrecision maxDecimalscSnURU5nUcgURS5n[R"US5(aSnSn[ X2- Xx- 5nO[R "US5(a{[R "US5(a_SnURUSS5n Sn U [U 5::a&XS:XaU S-n U [U 5::a XS:XaMX-n[ X2- U5nOBURUSS5n [S[U 55n[ X2- U[U 5- 5nURU5$)a> 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 r.0rk1r) number_to_stringsplitr, string_eqrF string_gt string_ltr,r:r  parse_to_int) rrr~rpricePrecisionpriceStr priceSplittedsignificantDigits integerDigits decimalPart leadingZeros integerParts rcalculate_price_precision%hyperliquid.calculate_price_precisionsO((/   s+   Xs + + ! M !>@Q@abN   x - -'2C2CHc2R2R ! **=!R@KL3{#33+:SWZ:Z+a/  3{#33+:SWZ:Z*=N !>ON**=!R@K #As;'7 8  !>@QTWXcTd@deN  00r!cSS0nURURX!55nURUS05nURUS/5nURUS/5nURUS/5n/n[ S[ U55GHGn URXi05n UR U S5n URX[05n URU S5n URURS 05nURUS 5nURUS 5nURU S/5nUR US5nUR US5nURUU05nURUU05nURUS5nURUS5nURURS 05nURUUU5nURUUU5nURU5nURU5nUS -U-nURUSU5nURUS5n[U5n URU S5n!Sn"U!bURU!U S5n"URU"5n#URU S-5n$0SU _SU_SU_SU_SS_SU$_SU_SU_SS_SS _S S_SS_SS_S S!_S"S!_S#S!_S$S_S!SSUUSSSSSURUR!U55URUR!U#55S%.SSS&.SSS&.SSS&.URS'5SS&.S(.SURX5S).En%UR#UR%U%55 URU5n&URU5n'UR0U%5n(U&S -U'-n)U)U:wdGMU)U(S'U&U(S'U'U(S'UU(S'UR#UR%U(55 GMJ U$)*a4 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 rspotMetaAndAssetCtxsrrrCtokensrr3r?rrrr*spec szDecimalsmidPxNrjr2r&r8r)settlermr(quoteIdsettleIdTsubTyper@rAFrBrCrJrGrrE10rrGrr)contractrrrr contractSizeexpiryexpiryDatetimestrike optionTyperIrNcreatedr)rQrRr-rSrTr:rnr,r safe_numberrr.intrrrparse_precisionr_safe_market_structure)*rrVrWrXfirstsecondrBrr+rZr/r extraData marketNamerrr tokensPos baseTokenPos quoteTokenPos baseTokenInfoquoteTokenInfor(rrmappedBaseName mappedQuoteId mappedBase mappedQuote mappedSymbolinnerBaseTokenInfoamountPrecisionStrr~rrpricePrecisionStrrmentryr8r)newEntryr&s* rrahyperliquid.fetch_spot_marketss * &&t{{7'CDZxB/!R0~~eZ4x4q#d)$A^^DR0F%%fg6Evb9I))&&9J>>$))VR8D$$T73E$$T73EvxH&&~v>G"&..?TVX"Y !--.A8XVN ,,-@'7SM00@J11-@K%+k9L!% v}!U !%!1!12Dl!S !"45O$$Y8EN !%!?!?XY!Z $ 5 5n E **55=9F4j4,4 4 4 $ 4 & 4H474D44444$44%4 %!4"$#4$" $"&""//0D0DEW0XY!..t/C/CDU/VW $#! $# $# $006#$  I6g4Ej NN455e< =**84D++G4E{{2u-HCZ%'F%%+"#' $)!'/$t99(CDQ%Rr!c0SnURUS5nURU5nURU5nURUS5nSnURU5nURSS5S-U-n Sn Sn U (aU (aU S-U-n URURS05n UR U S 5n UR U S 5nURUS 5n[ U5nUR US S 5nS nUbURUUS5nURU5nURUS5nSnUbU(+nUR0SU_SU _SU_SU_SU_SU_SU_SU_SU_SS_SS_SS_SU _SS_SS_SU_SU _SSU UURS 5SSSSURURU55URURU55S!.SURUS"5S#.SSS#.SSS#.URS$5SS#.S%.SUS&. E5$)'NUSDCr3rm:-r*TrArrrmarkPxr isDelistedr2r&r8r)rr(rrrr?Fr@rBrCrJrrr maxLeveragerErr) rrrrrrrrrrIrNrr)r,r.replacer-rrrrr safe_boolrrrrn)rr/rr(r8r)rmrrr&rrArrrrr~rrrrrJs r parse_markethyperliquid.parse_marketjs*##FF3&&x0''0!!&(3((2c3'#-5 #.~~dii4  w/  w/!--flC01  15  !;;E?TUVN 11.A^^FL9   !#^F))3+ &3+ f3+  D3+  U 3+ f 3+ f 3+  3+  w3+  3+  F3+  E3+  d3+  D3+  e3+  e3+ f!3+ " #3+ $ --c2"++D,@,@AS,TU**4+?+?@Q+RS  ,,V]C      ,,T2$e3+ 3 3 r!c|SnURSU5up!SnURSSU5up1SnURSU5upAUS:HnU(aSOSUS.nURUR Xa55nUR US5nUbSU0n [ S [U55Hhn Xn URURU S 55n UR5n URU S 5nURU S 5nXS 'XS 'XU 'Mj URU 5$URUS05nS URUS50nUbUS:XaURUS5US'OURUS5US 'UUS.nURUS5nUUS'URU5US'URU5$)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.subAccountAddress]: sub account user address :returns dict: a `balance structure ` NrZr?rrruserbalancesrrcointotalholdused marginSummary accountValueisolated withdrawablefreetotalMarginUsed)rrtime timestampdatetime)handle_public_addresshandle_market_type_and_paramshandle_margin_mode_and_paramsrQrRrSrTr:r.r,account safe_balancer-rrniso8601)rrV userAddressrrisSpotrWrXr spotBalancesrZbalancerHrrrr[ usdcBalancerYrs r fetch_balancehyperliquid.fetch_balances "88P 99.$PVW  !??PVW &.17,>R &&t{{7'CDH>>(J7  "((!3L1c(m,"+..t/?/?/PQ,,.((':''8#( "&%,T"-$$\2 2~~h< T%%dN;   "z)A"&"2"28^"LK "&"2"249J"KK  %%h7 '{!\\)4z  ((r!r c |UR5 URU5nSUS(aUSOUSS.nURURXS55nUR US/5nUR US/5UR US/5S .nUR US 5n UR XS U S S SS5$)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 rrAr(r2rrlevelsrr)bidsasksrr&rrpxsz) load_marketsr/rQrRrSrnparse_order_book) rr&r rVr/rWrXr[rYrs rfetch_order_bookhyperliquid.fetch_order_book*s V$*0.F:&fTl &&t{{7'CD.~~h"5NN4B/NN4B/ %%h7 $$VH-=y&RXZ^`deer!symbolscUR5 URU5n/nURUS5nURUS5nUS:XaUR U5nO)US:XaUR U5nOUR U5n0n[S[U55H3nX6nUSnURX5n URU S5n XU 'M5 URUSU5$)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 :returns dict: a dictionary of `ticker structures ` rr?rArrr&) rmarket_symbolsr,omitrar`rfrTr: parse_tickerfilter_by_array_tickers) rrrVrXrrYrZr/rtickerr&s r fetch_tickershyperliquid.fetch_tickersZs %%g./66* 6>..v6H V^..v6H))&1Hq#h-(A[F&>D&&t4F%%fh7F#6N ) ++FHgFFr!c SS0nURURX255nURUS05nURUS/5nURUS/5n/n[ S[ U55HFn URURXi05URXy055n UR U 5 MH URX5$)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 rrlrrCr)rQrRr-rSrTr:r_parse_funding_rates) rrrVrWrXrBrCryrYrZr[s rfetch_funding_rateshyperliquid.fetch_funding_rates|s & &&t{{7'CD@~~h2.>>$ B7NN8Q3 q#h-(A;;xB/yR0D MM$  ) ''88r!cURUS5nURU5nURXB5nURUS5nURUS5nURUS5n[ [ R "UR55S- S- S- 5S-S-S-S-n 0SU_S U_S U_S U_S S_S S_SS_SS_SU_SU _SURU 5_SS_SS_SS_SS_SS_SS_SS0E$)Nr3fundingroraclePx<r rrr& markPrice indexPrice interestRateestimatedSettlePricerr fundingRatefundingTimestampfundingDatetimenextFundingRatenextFundingTimestampnextFundingDatetimepreviousFundingRatepreviousFundingTimestamppreviousFundingDatetimeintervalr) r,coin_to_market_id safe_symbolrrmathfloor millisecondsr) rrr/r8r4r&rrrr s rparse_funding_ratehyperliquid.parse_funding_rates*f-))$/!!(3""43!!$1##D*5 4+<+<+> ?" Dr ID PQTUUY[[^``cgg D f    (  D  #D       7   0  t||,<=  t  #D  "4  "4 '! " &t# $ %  r!rc URUS5nURUSSSURUS5URUS5URUS5URUS5URUS5US. U5$) N impactPxsr& prevDayPxrrr dayNtlVlm) r&rr previousCloseclosebidask quoteVolumer)rS safe_tickerr)rrr/bidAsks rrhyperliquid.parse_tickers  4X&!--fkB%%fg6##FA.##FA.++FK@ !    r!r timeframesincecUR5 URU5nURUSUR55nUSLnUn Uc;Ub6UR U5S-n UR XzU-S-5nUS:aSnSnOSnUR US/5nSUS(aUS OUS URURX"5UUS .S .n URURX55n URXX)XH5$) 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 untilNr rFrrAr(r2)rr startTimeendTime)rreq) rr/rnrparse_timeframesumrr,rrQrR parse_ohlcvs) rr&r)r*r rVr/r,useTail originalSincetimeframeInMillisecondsrWrXs r fetch_ohlcvhyperliquid.fetch_ohlcvs V$!!&'43D3D3FG4- = *.*>*>y*ID*P'%(G"(LM19E6G9-$.4Vnz*&, ,,T__iS"  &&t{{7'CD"  9U\\r!c URUS5URUS5URUS5URUS5URUS5URUS5/$)Ntohlcv)rnr)rohlcvr/s r parse_ohlcvhyperliquid.parse_ohlcv=sn   eS )   UC (   UC (   UC (   UC (   UC (   r!cVSnURSU5upTUR5 URU5nSU0nUb SUS'X'S'OSUS'URUS5nUR US5nUbXS 'UR UR Xt55n URXX#5$) ag 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 ` NrruserFillsByTimerr. userFillsr,r/rrr;rnrrQrR parse_trades rr&r*r rVrr/rWr,rXs r fetch_tradeshyperliquid.fetch_tradesUs" "88O  !!&) K   /GFO#(K )GFO!!&'267+  !&I &&t{{7'CD*  5@@r!cURU5nURU[USSURUR5$)NrIrG)r/decimal_to_precisionr(r paddingMode)rr&rGr/s ramount_to_precisionhyperliquid.amount_to_precisionsAV$(({8KH8UW[WiWikok{k{||r!cURU5nURU5nURS5Sn[S[ U55nUR U[ U[UR5nUS(aSOSnXRURUSS55- n UR U[ U [UR5$) Nrrrkr?rrrIrG) r/rrr r:rLr(r*rMprecision_from_stringr,r)) rr&rr/rrrrYrsubtractedValues rprice_to_precisionhyperliquid.price_to_precisionsV$((/nnS)!, 3{#34**5%9JL^`d`p`pq!&>aq %(B(B4CSCSTZ[fTgiqCr(ss((Y]YiYijjr!c.SURUSS5-$)N0xkeccakhex)hash)rmessages r hash_messagehyperliquid.hash_messagesdii5999r!cURUSSUSSSS5nSUS-SUS-URSUS5S.$) N secp256k1rVrsr?)r`rar?)ecdsar2)rrYr signatures r sign_hashhyperliquid.sign_hashsWJJtCDz:cd+;[$O  #& #&"in-  r!cJURURU5USS5$)Nr^)rer[)rrZrs r sign_messagehyperliquid.sign_messages%~~d//8*ST:JKKr!c"U(aSOSnUUS.$)Nba)source connectionId)rrY isTestnetrms rconstruct_phantom_agent#hyperliquid.construct_phantom_agents"   r!cURU5nURU5nUnUSURU5-- nUcUS- nO US- nXb- nURUR U5SS5$)N000000001rWbinary)packbbinary_to_base16 int_to_base16rYbase16_to_binary)raction vaultAddressnonce dataBinarydataHexr[s r action_hashhyperliquid.action_hashs}ZZ' '' 3 $,,U333   DLD DLD  Dyy..t4hIIr!cBURXU5nURURSS5nURXE5nUR URS5nSnUSUSS.n SS S S .S S S ./0n UR XU5n UR XR5n U $)NrFri9rrchainIdr3verifyingContractr6Agentrmstringr3rrnbytes32)rrrrqr,eth_encode_structured_datarhr) rr|r~ vaultAdressrYrp phantomAgentrrdomain messageTypesmsgrds rsign_l1_actionhyperliquid.sign_l1_actionsU;NN4<<F 33DD .&&t||]C !,   !84'; --fLQ%%c??; r!cURURS5nSnUSUSS.nURXQU5nURX`R5nU$)NrinHyperliquidSignTransactionrr)r,rrrhr)rrrZrrrrrds rsign_user_signed_action#hyperliquid.sign_user_signed_actions^&&t||]C 0!,   --fGL%%c??; r!cLSSSS.SSS.SSS.SSS./0nURX!5$) NzHyperliquidTransaction:UsdSendhyperliquidChainrr destinationrGruint64rrrZrs rbuild_usd_send_sighyperliquid.build_usd_send_sigsD ,+X>&9!842 / ++LBBr!cLSSSS.SSS.SSS.SS S./0nURX!5$) Nz'HyperliquidTransaction:UsdClassTransferrrrrGtoPerpboolr~rrrs rbuild_usd_class_send_sig$hyperliquid.build_usd_class_send_sigsD 5+X>!84!62 (3 8 ++LBBr!cLSSSS.SSS.SSS.SSS./0nURX!5$) NzHyperliquidTransaction:WithdrawrrrrrGrrrrs rbuild_withdraw_sighyperliquid.build_withdraw_sig sD -+X>&9!842 0 ++LBBr!cLSSSS.SSS.SSS.S S S./0nURX!5$) Nz)HyperliquidTransaction:UserDexAbstractionrrrraddressr$rr~rrrs rbuild_user_dex_abstraction_sig*hyperliquid.build_user_dex_abstraction_sigsD 7+X>3"F3 (3 : ++LBBr!cLSSSS.SSS.SSS.SS S./0nURX!5$) Nz(HyperliquidTransaction:ApproveBuilderFeerrr maxFeeRatebuilderrr~rrrs rbuild_approve_builder_fee_sig)hyperliquid.build_approve_builder_fee_sig!sD 6+X>%x8"I6 (3 9 ++LBBr!cTURURSS5(agSURS'SURURSS5S.nUR5nUR X5nUUUS.nSnUR U5nU$![ a nSnSnAU$SnAff=f) NrefSetFT setReferrerrefCCXT1)rrHr|r~rd)rrr,rrprivatePostExchange Exception)rr|r~rdrWrXes rset_refhyperliquid.set_ref,s >>$,,% 8 8!% X!$$T\\5'B !!#''6 "   //8HO H s=B B'B""B'rrcUR5nURURSS5nU(aSOSUUUS.nURU5nUSSUSUS US S .nUUUSS .nUR U5$) NrFTestnetMainnet)rrrr~r0x66eeerrapproveBuilderFee)rsignatureChainIdrrr~rr|r~rdr})rrrrr) rrrr~ isSandboxModepayloadsigr|rWs rapprove_builder_feehyperliquid.approve_builder_feeCs!!#t||]EJ -: $   009 '(: ; )!,/y)'    ''00r!ctUR5UR5/ g![a nSnAgSnAff=f)NFT)handle_builder_fee_approvalrr)rrs rrPhyperliquid.initialize_clientes8   - - / @  s # 77cURURSS5nU(dgURURSS5nU(agURURSS5nURURSS5nURX45 SURS'g![anSURS'SnAgSnAff=f) N builderFeeTFapprovedBuilderFeer*0x6530512A6c89C7cfCEbC3BA7fcD9aDa5f30827a6feeRatez0.01%)rrr,rr)rbuildFeerrrrs rr'hyperliquid.handle_builder_fee_approvalls>>$,, dC!^^DLL:NPUV  /&&t||Y@lmG))$,, 7KJ  $ $W 915DLL- . /).DLL & /s AB'' C 1CC r$cSnURSU5up2UR5nURURSS5nU(aSOSUUUS.nUR U5nUSSUS US US S .nUUUSS .n UR U 5$)NenableUserDexAbstractionrFrr)rrr$r~rrr$ruserDexAbstraction)rrr$rr~rr)rrrrrr) rr$rVrr~rrrr|rWs renable_user_dex_abstraction'hyperliquid.enable_user_dex_abstraction|s "889SU[\ !!#t||]EJ -:    11': '(: ; )y)FO(    ''00r!rsiderGc ~UR5 URSXX4XV5upxURU/U5n U S$)a 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)rparse_create_edit_order_args create_orders) rr&rrrGrrVorder globalParamsorderss r create_orderhyperliquid.create_ordersI, "??fTXbgp##UG\:ayr!rcUR5 UR5 URX5nURU5nUR US05nUR US05nUR US/5n/n[ S[U55H3n Xyn U S:XaURSU 05 M"URU 5 M5 URUS5$)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 ` rXr[statusesrwaitingForTriggerstatusN) rrPcreate_orders_requestrr-rSrTr:r_ parse_orders) rrrVrWrX responseObjr[rordersToBeParsedrZrs rrhyperliquid.create_orderss   ,,V<++G4$nnXz2> ~~k626>>$ B7q#h-(AKE++ ''5(9: ''. )   !1488r!cURU5nUR5nUR5nUS:HnUS:Hn URUSS5n URUS5n U(aSOSn UR USS 5n U (aS n UR US U 5nUR U5nURUS S 5nURUSU5nURUS5nU=(d UnSnU(aUc[URS-5eU (a,[R"U[R"SU 55O+[R"U[R"SU 55nURUU5nOURX5nURX5nUR USS 5n0nU(a?S nUbURUU5nSnOURUU5nUUU(aSOSS.US'OSU0US'URU/SQ5nUR!US5U UUUUS.nU bU US'U$)NMARKETBUY clientOrderId client_idslippageiocgtcpostOnlyFalorr stopPricerrzy market orders require price to calculate the max slippage price. Default slippage can be set in options(default is 5%).r reduceOnlyTtpslisMarket triggerPxtpslrtifr ) rrrrrrrrrrrmrlrkprar`r:r>)r/upper safe_string_2r,rsafe_string_lower capitalizer"r2r, string_mul string_add string_subrSrNrr)rr&rrrGrrVr/risBuyrrdefaultTimeInForcerrrrr isTriggerrrr orderTypeisTporderObjs rcreate_order_request hyperliquid.create_order_requestsxV$zz|zz|H$**6?KP ##FJ7'/Ue>>&*e< !& ,,V]DVW ook2 ))&.+N ((,O **63DE"5o  }'3n)nooRW##E7+=+=c8+LM^e^p^pqvxyKyKLOQYyZ_[B((4B((7B  % %f 5^^FL%@  D*#66vO #66v}M $)!%D$Ii {"Ig 6$xy""6(#34    $)HSMr!cZUR5 URURS5nURUSU5nSn[S[ U55H4nXnUR US05nUR USS5nUcM2S nM6 U(aa[S[ U55HHnXnUR US05nUR USS5nUbM2[URS -5e URU/S Q5nUR5n /n S n [S[ U55GH.nXnURUS 5n URU 5n U S nURUS5nURUS5nURUS5nURUS5nUR US05nURUSU5nUUS'URUS5nURUS5nU=(d UnURUSS/5nURXUUUU5nU RU5 U(dGMUR!USS/5nURUSS5nUR!USS/U5nUR!USS/5nURUSS5nUR!USS/U5nSn URUSS/5nSnUS:XaSnOSnUb:URUUUUUUR#UUS S.55nU RU5 UcGMURUUUUUUR#UUS S.55nU RU5 GM1 Sn UR%US S!5un nUR'U 5n S"U U S#.n!UR)URS$S5(a@UR+URS%S&5n"U"UR-URS'S(5S).U!S%'UR/U!U U 5n#U!U U#S*.n$U bURUS!5nU U$S!'U$$)+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 :returns dict: an `order structure ` rrFrrVrrNTzV createOrders() all orders must have clientOrderId if at least one has a clientOrderId rrrrrrrrrnar&rrrGrstopLoss takeProfitrrr rr normalTpslrrsellbuy)rr)rrrQr}r)rrgroupingrrrfeeInt )rkfr)rOr,rrTr:r-rr"r2rrr/safe_string_upper safe_valuer r_ safe_string_nrRhandle_option_and_paramsformat_vault_addressrrrnr)%rrrVrhasClientOrderIdrZrawOrder orderParamsrr~orderReqrr4r/r&rrrGrrrrr mainOrderObjstopLossOrderTriggerPricestopLossOrderTypestopLossOrderLimitPricetakeProfitOrderTriggerPricetakeProfitOrderTypetakeProfitOrderLimitPricetriggerOrderSider r} orderActionwalletrdrWs% rr!hyperliquid.create_orders_request!s '')**4<<9JK**6:O q#f+&AyH..8R@K ..{O[YM(#' ' 1c&k*!9"nnXxD $ 2 2;Q\ ]  (+DGG7O-OPP + 6$jk!!#q#f+&AyH''(;H[[*FH%F))(F;D))(F;D%%h9F$$Xw7E..8R@K'' ZQH&.K #{J?HlCJ!/ZI))K*l1KLK!%!:!:6vW\^i!jL OOL )y,0,>,>x.ZeIf,g)$($4$4Xvw$O!*.*<*,>zGUfKgjE-F)'"ii j,5OP #% 5='-$',$)%)%>%>vGZ\lntwPRVR]R]^i+F&*kR&HOOH-'%)%>%>vGXZjlruLNRNYNYZe)B&*gN&HOOH-Y'Z #<   >>$,,(` r) cancel_ordersr-)rr2r&rVrs r cancel_orderhyperliquid.cancel_orders)##RD&9~~fa((r!idscUR5 Uc[URS-5eUR5 UR 5 UR XU5nUR U5nURUS5nURUS5nURUS5n/n [S[U55H*n Xn U RURU U S.55 M, U $)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 ` z* cancelOrders() requires a symbol argumentrXr[rrrr) rOr"r2rrPcancel_orders_requestrr-rSrTr:r_ safe_order) rr0r&rVrWrX innerResponser[rrrZrs rr-hyperliquid.cancel_orderss '') >#DGG.Z$Z[ [   ,,S&A++G4x< ~~mV4>>$ 3q#h-(A[F MM$// + )  r!cURU5nURUSS5nURUSS/5nUR5nSU0n/nS/S.n UR US5n UbP[ U[ 5(dU/nSU S '[S [U55Hn URU X[S .5 M OFS U S '[S [U55H(n URU UR X5S .5 M* XS'Sn URUSSS5upURU 5n URXU 5n XS'XS'U bURUS5nXS'U$)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 rrr~rrcancelsrmN cancelByCloidrr)assetcloidcancel)rlr;r9rJr}subAccountAddressr|rd) r/ safe_value_2rrparse_to_numeric isinstancelistrTr:r_handle_option_and_params_2rr)rr0r&rVr/rr~rW cancelReq cancelActionrmrZr}rds rr3!hyperliquid.cancel_orders_requestsV$))&/;O 6O[#AB!!# U   &&vh'78  $mT22!. #2L 1c-01  #*-"2 $,L 1c#h'  ..sv6"( #,Y #>>v~Wegz{ 00> '' \J ((   #YYv~6F&2N #r!cUR5 UR5 UR5 UR5nSU0n/nS/S.nSn[ S[ U55HnXn UR U S5n U bSnUR U S 5n UR U S 5n U c[URS -5eU bU(a[URS -5eU(aS OSn U(aSOSnURU 5n0nURUS5UU 'U(aU OURU 5UU'URU5 M U(aSOSUS'XVS'SnURUSSS5unnURU5nURXcU5nXdS'UUS'UbUR!US5nUUS'UR#U5nUR%SU05/$)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 ` r~rr8FrrNTr2r&zB cancelOrdersForSymbols() requires a symbol argument in each orderzI cancelOrdersForSymbols() all orders must have either id or clientOrderIdr;rlr<r;rmr:r=rr9rKr}r>r|rdr)rOrrPrrTr:r,r"r2r#r/r@r_rCrrrrr4)rrrVr~rWrDrEr:rZrrr2r&assetKeyidKeyr/ cancelObjr}rdrXs rcancel_orders_for_symbols%hyperliquid.cancel_orders_for_symbolss '')   !!# U    q#f+&AIE ,,UODM( $ !!%.B%%eX6F~'2v(vww~- +v!vww"/wSH,G#E[[(F I"&"7"7x8H"IIh 0=}4CXCXY[C\Ie    Y '#'$3@X V"+Y #>>vG_aorE F f00> '' \J ((   #YYv~6F&2GN #++G4 2344r!timeoutcUR5 UR5 UR5 URUSS/5nUR 5nSU0nSX1-S.nSnUR USSS 5upbUR U5nURXSU5nXTS 'XtS 'UbURUS5nXdS'URU5nU$) ah 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 rrr~scheduleCancel)rrNrHr}r>r|rd) rOrrPrrrCrrr) rrMrVr~rWrEr}rdrXs rcancel_all_orders_after#hyperliquid.cancel_all_orders_after>s '')   6O[#AB!!# U  %O  #>>vG]_mpC D 00> '' \J ((   #YYv~6F&2N #++G4r!cUR5 Sn[S[U55H4nXnURUS05nUR USS5nUcM2SnM6 U(aa[S[U55HHnXnURUS05nUR USS5nUbM2[ UR S-5e URU/SQ5n/n[S[U55GHnXnURUS 5n URUS 5n URU 5n U S n URUS 5n U S :HnURUS 5nUS:HnURUS5nURUS5nURUS05nURURS5nURUSU5nU(aSOSnURUSS5nU(aSnURUSU5nURU5nUR USS5nUR USS5nURUSU5nURUS5nU=(d UnURUSS5nURU/SQ5nURU5nU(arU(a,[ R""U[ R$"SU55O+[ R""U[ R&"SU55nUR)U U5nOUR)U U5nUR+U U5n0nU(a?Sn UbUR)U U5nSn OUR)U U5nUUU (aSOS S!.US"'OS#U0US$'UcS%nUR-U S&5UUUUUS'.n!UbUU!S('UR-U 5U!S).n"UR/U"5 GM UR15n#S*US+.n$Sn%UR3US,S-5un%nUR5U%5n%UR7U$U#U%5n&U$U#U&S..n'U%bU%U'S-'U'$)/NFrrVrrTzT editOrders() all orders must have clientOrderId if at least one has a clientOrderIdr r2r&rrrrrGrrrrrrrrrrrrr) rrrrrrrrrrrrrrrr rrmrr>)oidr batchModify)rmodifiesrWr}r)rOrTr:r-rr"r2rr,r/rrrrrrr,rrrrSrNrr_rrrr)(rrrVrrZrrrrUr2r4r/r&rrrrrGrrrrrrrrrrrrrrrr  modifyReqr~ modifyActionr}rdrWs( redit_orders_requesthyperliquid.edit_orders_requestfs '') q#f+&AyH..8R@K ..{O[YM(#' ' 1c&k*!9"nnXxD $ 2 2;Q\ ]  (+DGG7M-MNN + 6$jkq#f+&AyH!!(D1B''(;H[[*FH%F))(F;D(H))(F;DU]E%%h9F$$Xw7E..8R@K"..t||=NOO'' ZQH+3% ~~k:uEH%*"00mM_`K//+6K ..{O[YM--k>;WL ,,[/<XM"..{,>sH,MN_f_q_qrtv}wIwIJMOWwX`Y,,VR8,,VR8))&&9B I".#'#:#:6?#SLD#'#:#:6=#QL (!-%)D( )$;& '"#" &&vh'78 H( - ((,!I OOI &K'L!!#!   #< '' e\J ""   #&2GN #r!c UR5 Uc[URS-5eURXX4XVU5upUR U/U 5n U S$)a 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 ` z$ editOrder() requires an id argumentr)rr"r2r edit_orders) rr2r&rrrGrrVrrrs r edit_orderhyperliquid.edit_ordersc,  :#DGG.T$TU U"??DX^gmn!!5'<8ayr!cUR5 UR5 URX5nURU5nUR US05nUR US05nUR US/5nUR U5$)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 ` rXr[r)rrPrXrr-rSr)rrrVrWrXresponseObject dataObjectrs rr[hyperliquid.edit_orderss   **6:++G4H*bA^^NFB? >>*j"=  **r!r3 description initialUsdcZUR5 UR5 UR5nSU0nUR[R "UR U5S55nSUUUUS.nURX5n XS'XS'URURXd55n U $)a 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 r~1000000 createVault)rr3rbrcr~r|rd) rOrrrr,rrrrrR) rr3rbrcrVr~rWusdr|rdrXs r create_vaulthyperliquid.create_vault$ s '') !!# U  2 243H3H3TV_ `a!&  ''6 "( ++DKK,HIr!c UR5 Uc[URS-5eURU5nSUSS.nUbX&S'O&UcSOUnUR 5US-S-S -- US'UR US 5nUR US 5nUbXS 'URURXd55n /n [S [U 55H_n Xn UR U S 5n U RU URSU5URU S5U URU 5S.5 Ma URU S5nUR!XX#5$)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 argumentfundingHistoryr(rr.irr r,r/rrr )rr&r rrr)rr"r2r/rrnrrQrRrTr:r_rrrsort_byfilter_by_symbol_since_limit)rr&r*r rVr/rWmaxLimitr,rXrYrZrrsorteds rfetch_funding_rate_history&hyperliquid.fetch_funding_rate_historyJ sq  >#DGG.e$ef fV$$:&   #(K $}s5H#'#4#4#6B9Kd9R#RGK !!&'267+  !&I &&t{{7'CDq#h-(AKE))%8I MM**48#//}E& LL3  )fk200NNr!cfSnURSU5upTSnURUSSS5updUR5 UUS.nSnUb[URU5nUR USS5n U R S5n [ U 5n U S :aUR U S 5US 'URURXt55n /n [S [ U 55HBnXn0nUR US 5cS US'U RURUU55 MD URXX#5$)a3 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 ` NrmethodfrontendOpenOrdersrr(rrrrr<ropen ccxtStatus) rrrr/r,rr:rQrRrTr_r)rr&r*r rVrrsrWr/r(part partsLengthrXorderWithStatusrZr extendOrders rfetch_open_ordershyperliquid.fetch_open_orders sG  "889JFS 66v?PRZ\pq    [[(F'' B?H>>#&Dd)KQ!%!1!1$!:&&t{{7'CDq#h-(AKEKx08,2 L)  " "4;;uk#B C )   %GGr!cUR5 URUSSU5nURUSS/S5nURXaX#5$)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 ` NrclosedFr fetch_ordersfilter_by_arrayrmrr&r*r rVr closedOrderss rfetch_closed_ordershyperliquid.fetch_closed_orders sQ ""64v>++FHxj%P 00uTTr!cUR5 URUSSU5nURUSS/S5nURXaX#5$)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 ` NrcanceledFrrs rfetch_canceled_orders!hyperliquid.fetch_canceled_orders sQ ""64v>++FHzlER 00uTTr!cUR5 URUSSU5nURUS/SQS5nURXaX#5$)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)rr~rejectedFrrs r fetch_canceled_and_closed_orders,hyperliquid.fetch_canceled_and_closed_orders sQ ""64v>++FH>`bgh 00uTTr!cSnURSU5upTUR5 URU5nSUS.nURUR Xt55nUR XX#5$)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 :returns Order[]: a list of `order structures ` NrhistoricalOrdersr)rrr;rQrRr) rr&r*r rVrr/rWrXs rrhyperliquid.fetch_orders sw "88O  !!&)& &&t{{7'CD  5@@r!cSnURSU5upCUR5 URU5nURUS5nSUS.nUbUR US5nXgS'O+[ U5S:nU(aUOUR U5US'URURXs55n URU S5n URX5$) 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 ` NrrrrrS"r) rrr;r,rr:r@rQrRr- parse_order) rr2r&rVrr/rrWisClientOrderIdrXr[s r fetch_orderhyperliquid.fetch_order s "88vN  !!&)((A !   $YYv7F*EN!"gmO#2R8M8Mb8QGEN&&t{{7'CD8~~h0--r!rc URUS5nUbURUSS.5$URU/SQ5nUcUnURUS5nSnUbURU5nURUS5cUR US5nOUR Xb5nUSnUR US5nUR US S 5n URUS /5nURUS 5n U b U S :XaS OSn UR USS5n URUS5n URUS5n SnU bU S:HnUR0SU_SURUS5_SURUS5_SU_SURU5_SS_SUR US5_SU_SURURUS55_SU _SU_S URUS 5_S U _S!URUS"5_S#URUS$5(aURUS%5OS_S&U _S'S_URUS(5[R"X5U UR!U 5SSS).EU5$)*Nerrorrr2)rrestingfilledrr2r&rrrvrArrorigSztotalSzrrALOrrSrr<rlastTradeTimestamplastUpdateTimestampstatusTimestamprrrrrrlimitPxrrrrGravgPx)averager remainingrrMtrades)r,r4 safe_dict_nrr;rnrrrrparse_order_typerrrr,rparse_order_status)rrr/rrrr4r&rrr totalAmountrrrs rrhyperliquid.parse_orderG s@  0  ??$$   (FG =Ev.  --d3H   E4 ( 0%%h5F%%h7F!%%e[9 ##E8\B %,0v.  "ck6D(()D $$UD1 $$UE2 ?u H E $""5%0  T--eW=     Y/  !$   "4#4#4U""(   ??: & & ??: & &&99r!c0SSS.nURX!U5$)Nr r/)z stop limitz stop marketr,rs rrhyperliquid.parse_order_type s$!# &99r!cVSnURSU5upTUR5 URU5nSU0nUb SUS'X'S'OSUS'URUS5nUR US5nUbXS 'UR UR Xt55n URXX#5$) 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 ` NrzrrDrr.rEr,r/rFrHs rfetch_my_tradeshyperliquid.fetch_my_trades s "88&Q  !!&) K   /GFO#(K )GFO!!&'267+  !&I &&t{{7'CD,  5@@r!tradecRURUS5nURUS5nURUS5nURUS5nURU5nURUS5nUSnURUS5n URUS5n U b U S:XaS OS n URUS 5n Sn UR US 5n U b U (aS OSn UR UUUR U5UU URUS5SU U UUSU URUS5SS.S. U5$)Nrrrrr&tidrrrrrMcrossedrrrSfeeToken)rcurrencyrate) rrrr&r2rrr takerOrMakerrrGrrM)rnr,rr;r safe_trader)rrr/rrrGrr4r&r2rrMrrs r parse_tradehyperliquid.parse_trade. sU&%%eV4   -!!%.v.))$/!!(D1!   eU +v.  "ck6Due, .. 2  &-77L" Y/%%eU3( ,,UJ? $ % r!cNURU/U5nURUS05$)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_positionsr-)rr&rV positionss rfetch_positionhyperliquid.fetch_positione s+((&6: ~~iB//r!cUR5 SnURSU5up2URU5nSUS.nURUR XB55nUR US/5n/n[ S[U55H&nURURXhS55 M( URUSUS5$) 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 :returns dict[]: a list of `position structure ` NrrrassetPositionsrr&F) rrrrQrRrSrTr:r_parse_positionfilter_by_array_positions) rrrVrrWrXr[rYrZs rrhyperliquid.fetch_positionss s  "889I6R %%g.( &&t{{7'CD\~~h(8"=q#d)$A MM$--dgt< =%--fhOOr!positionc LURUS05nURUS5nURU5nURUS5nUSnURUS05nURUS5nUS:Hn URUS5n U n Sn U b6[R "U S5(aS OS n [R "U 5n URUS 5n [R "U 5nURUS 5nSnU (a[R"X5nOUn[R"[R"X5S 5nUR0SU_SS_SU_SS_SS_SU _SS_SU _SURU 5_SS_SURUS5_SS_SURUS5_SURUS5_SURU5_SURU5_SS_SSURU 5URUS5UURU5S .E5$)!Nrrr&rrrszirlongshort unrealizedPnl marginUsed100rr2rrrr contractsr entryPriceentryPxrnotional positionValuevalue collateral initialMarginmaintenanceMargin liquidationPx)initialMarginPercentagemaintenanceMarginPercentagerliquidationPricer percentage) r-r,rr;r,r string_absrr string_div safe_positionrr)rrr/rrr4r&rr isIsolatedrawSizesizerrawUnrealizedPnlabsRawUnrealizedPnlrrrs rrhyperliquid.parse_position s6xR8v.))$/!!(D1!>>%R8%%h7  J. ""5%0  $..w<<6'D%%d+D++E?C%001AB%%e\:  #..zLM&M''(:(:;N([]bc !!# H# $#  f#   #  #  #  d#  D#  **40#  D#  $**5)<#  #  ((@#  ((7;#  $++J7# T..}=!# " ## $(,+/!../?@ $ 0 0 H$++J7/#   r!rcDUc[URS-5eUR5 URU5nUR US5nUc[URS-5eUR US5nUS:HnUR 5nURUS/5nSUUUS.n Sn URUS S S 5upU b(U RS 5(aU RS S 5n URXU 5n U UU S.n U bXS 'URU 5n U $)a 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 argumentrz. setMarginMode() requires a leverage parameterrmcrossupdateLeveragerr;isCrossrrr}r>rVrr) r"r2rr/rnrrrrC startswithrrr)rrr&rVr/rr;rr~ updateActionr}rdrWrXs rset_margin_modehyperliquid.set_margin_mode sK >#DGG.[$[\ \ V$$$VZ8  #DGG.^$^_ _!!&"23(!!#6J<0$   #>>vXfh{|  #&&t,,+33D"= '' \J ""   #&2N #++G4r!rcUc[URS-5eUR5 URU5nUR USS5nUS:HnUR US5nUR 5nURUS5nSUUUS.n Sn URUSS S 5upURU 5n URXU 5n U UU S .n U bURUS 5nXS 'URU 5n U $) aS 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 argumentrrrmrrrr}r>r) r"r2rr/r,rrrrCrrr)rrr&rVr/rrr;r~rr}rdrWrXs r set_leveragehyperliquid.set_leverage< s' >#DGG.Y$YZ Z V$%%flGD (!!&"23!!#6<0$   #>>v}Vdfyz 00> '' \J ""   #YYv~6F&2N #++G4r!c(URXSU5$)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_helperrr&rGrVs r add_marginhyperliquid.add_marginl s((GGr!c(URXSU5$)a 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_marginhyperliquid.reduce_margin{ s((6JJr!c.UR5 URU5nURUS5nUR[R"UR X5S55nUS:XaU*nUR 5nSUSUS.n Sn URUSSS 5upURU 5n URXU 5n U UU S .n U bXS'URU 5n URURX5S URU S 505$) NrmrerupdateIsolatedMarginT)rr;rntli modifyMarginr}r>rrHr)rr/rr,rrNrrCrrrrRparse_margin_modificationr,)rr&rGrrVr/r;rr~rr}rdrWrXs rr hyperliquid.modify_margin_helper s6 V$!!&"23   w11$2J2J62Z\ef g 8 B!!#*   #>>v~Wegz{ 00> '' \J ""   #&2N #++G4{{499(K D$$Xx8N   r!r[c \UURSU5SSSSURUS5SSSS. $)Nrr) rr&rrrGrrHrrr)rr,)rr[r/s rr %hyperliquid.parse_margin_modification sF&&tV4$$$VX6  r!rH fromAccount toAccountcUR5 UR5 URURS5nUR 5nUR U/SQ5(aUR U/SQ5(d[ URS-5eURU5nURUSS5n U bURU 5n US-U -nUS:H=(d US :Hn U(aS OS UU US .n URU 5n U S SSUU US.UU S.n URU 5nU$SnSnUS:XaUnSnO!US:XaUnO[ URS-5eURU5 UbUR5S:XavUR[ R""URU5S55nSUUUS.nUR%UU5nUUUS.nURU5nUR'U5$UR)U5nSUUUURU5S.nUR%UU5nUUUS.nURU5nUR'U5$)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 transferr}r>Nz subaccount:rrArr)rrGrr~rrusdClassTransfer)rrrrGrr~rFmainTz4 transfer() only support main <> subaccount transferrresubAccountTransfer)rsubAccountUser isDepositrgsubAccountSpotTransfer)rrrtokenrG)rOrrrrin_arrayr'r2rrrrr check_addressrrr,rrparse_transferr&)rrHrGr rrVrr~ strAmountr}rtransferPayload transferSigtransferRequesttransferResponserr>rgr|rrWrXr&s rrhyperliquid.transfer s '') t||]C !!# ==&> ? ?==,DEE"477-]#]^^--f5I--fnFYZL'#88F %6E 6)CyF/BF1>II#  %O 77HK)88J(K(1.'$" ( %O $77H # #   & ) I & + tww)__` ` ,- <4::<61##G$6$6t7L7LV7TV_$`aC,"3& F %%fe4C  G //8H&&x0 0[[&F0"3&//7 F%%fe4C  G //8H&&x0 0r!rrc USSSSSSSSS. $)Nok) rr2rrrrGr rrro)rrrs rrhyperliquid.parse_transfer' s)   r!rtagcUR5 UR5 URU5 Ub.UR5nUS:wa[ UR S-5eSnUR USS5upeURU5nURUS5nUR5n0nSn UbSSU-SUS .nURX5n O\URURS S5n U (aS OS U[U5US .n URU 5n U SSU[U5USS.nUUU S.n URU 5n UR!U 5$)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} vaultTransferrVF)rr}rrgrrr)rrrGrrr withdraw3)rrrrGrrr)rOrrrr'r2rrrrrrrrorrparse_transaction)rrHrGrr$rVr}r~r|rrrrWrXs rrhyperliquid.withdraw7 sw '')  7#  :: 6>2!!#  #' $| 3" F %%f4C NN4<<NM1>II&f+ G ))'2C$+,>$?$-&f+# F  ++G4%%h//r! transactioncURUS5nURUS05nSnURUS5nUbSUS.nSnURUS5nUbUS:Hn0SU_S S_S URUS 5_S U_S URU5_SS_SS_SURUS5_SURUS5_SS_SS_SS_SS_SUR US5_SS_SURUS5_SS_SUUS.E$)NrdeltarMrrrrinternalTransferrr2txidrYrrnetworkr addressTor addressFromrr$tagTotagFromrGusdcrrupdated)commentinternalrM)rnr-r,rr) rr*rrr,rMfeeCostr8rs rr(hyperliquid.parse_transactionu s%%k6: {GR8##E51  "Cv.   22H K $  D$$[&9     Y/  t   t  ))%?  4++E6:  4  T  t  D  d&&uf5   d&&{H=! " t# $ )  r!c&UR5 SnURSU5up2URU5nSUS.nURUR XR55nUR US5UR US5S.nUR Xt5$)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>)rrr/rQrRr,parse_trading_fee)rr&rVrr/rWrXr[s rfetch_trading_feehyperliquid.fetch_trading_fee s  "889JFS V$ &&t{{7'CDJ"--hH++HmD %%d33r!rMcxURSU5nUUURUS5URUS5SSS.$)Nr>r=)rr&rrr tierBased)rr)rrMr/r&s rr?hyperliquid.parse_trading_fee sMH!!$/%%c=9%%c?;   r!c$UR5 SnURSU5upTSUS.nUbX&S'URUS5nUbXvS'URUS/5nUR UR Xd55nUR USX#5$)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 ` NrquserNonFundingLedgerUpdatesrr.r,r/)rrrnrrQrR parse_ledger) rrHr*r rVrrWr,rXs r fetch_ledgerhyperliquid.fetch_ledgers  "88O 1   #(K !!&'2  !&I YYvy1F&&t{{7'CD  4>>r!itemcURUS5nURUS05nSnURUS5nUbSUS.nURUS5nURUS5nURUURUS5SSURUS 5URUS5UR U5SUR U5UUR U5SSSUS .U5$) Nrr,rMrr-rr5rYr)rr2 directionrreferenceAccount referenceIdrrrGrrbeforeafterrrM)rnr-r,safe_ledger_entryparse_ledger_entry_typerr) rrJrrr,rMr9rrGs rparse_ledger_entryhyperliquid.parse_ledger_entry9s%%dF3 tWb1##E51  "Cv.!!%0%%""40 $ 0 0 ?++D&9006''/" Y/' ! r!c0SSS.nURX!U5$)Nr)r.accountClassTransferr)rr ledgerTypes rrR#hyperliquid.parse_ledger_entry_typebs$ *$.  $77r!cUR5 SnURSU5upTSUS.nUbX&S'URUS5nUb2Uc[URS-5eXvS'UR US/5nUR URXd55nURU5n Sn URUSS 5upURU 5n /n U b][S [U 55HCn Xn U S S :XdMURU S 5nUSSU -:XdM2U RU 5 ME OURU S S/S5n UR!U SX#5$)aI 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 ` NfetchDepositsWithdrawalsrFrr.r,z0 fetchDeposits requires since while until is setr/r}rr vaultDepositr,vaultrVrKF)rrrnr"r2rrQrRextract_type_from_deltarrrTr:r-r_rparse_transactions)rrHr*r rVrrWr,rXrecordsr}depositsrZrecordr,s rfetch_depositshyperliquid.fetch_depositsis}  "889SU[\ 1   #(K !!&'2  }'2d(dee!&I YYvy1F&&t{{7'CD..x8 #<   #1c'l+ &>^3 NN67;EW~ )<< / ,++GVi[%PH&&xuDDr!cUR5 SnURSU5upTSUS.nUbX&S'URUS5nUbXvS'URUS/5nUR UR Xd55nUR U5n Sn URUSS5upURU 5n /n U b][S [U 55HCn Xn U S S :XdMURU S 5nUS SU -:XdM2U RU 5 ME OURU S S/S5n URU SX#5$)aT 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 ` NrZrFrr.r,r/r}rr vaultWithdrawr,r\rVrF)rrrnrrQrRr]rrrTr:r-r_rr^)rrHr*r rVrrWr,rXr_r} withdrawalsrZrar,s rfetch_withdrawalshyperliquid.fetch_withdrawalsse  "889SU[\ 1   #(K !!&'2  !&I YYvy1F&&t{{7'CD..x8 #<   #1c'l+ &>_4 NN67;EW~ )<<#**62 ,..w eTK&&{D%GGr!cUR5 URU5nUR5nURX15$)z 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: )rrr`parse_open_interests)rrrV swapMarketss rfetch_open_interests hyperliquid.fetch_open_interestss? %%g.--/ ((>>r!crURU5nUR5 URU/U5nX1$)z 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&rrl)rr&rVoiss rfetch_open_interesthyperliquid.fetch_open_interests:V$ ''&9{r!c URUS05nURUS5nSnUbURU5nURUR U5UR US5SSSUS.U5$)Nrr3 openInterest)r&openInterestAmountopenInterestValuerrr)r-r,rsafe_open_interestrr)rinterestr/rr4s rparse_open_interesthyperliquid.parse_open_interests&>>(FB7&1  --d3H&&&&x0"&"2"28^"L!% (   r!cLUR5 SnUbURU5nSnURSU5updUSS.nUbX'S'URUS5nUR US5nUbXS'UR UR Xt55n URXX#5$)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)rrr.r,r/)rr/rrnrrQrR parse_incomes) rr&r*r rVr/rrWr,rXs rfetch_funding_history!hyperliquid.fetch_funding_historys   [[(F "889NPVW !   #(K !!&'267+  !&I &&t{{7'CD"!!(EAAr!c URUS5nURUS5nURUS5nURUS5nUS-nURU5nUSnURUS5n UR S5n UR US 5n UUU UUR U5UURU 5U S .$) NrYrr,r /USDC:USDCr&r5rr )rr&rHrrr2rGr)r,rnr-r;r.rrr) rincomer/r2rr,rm marketSymbolr&rGrHrs r parse_incomehyperliquid.parse_income?s  ff -%%ff5 vw/!!%0 , !!,/!!!%0&&v.}5" Y/''/  r!weightcUR5nSU0nSUS.nURXS5nXTS'XdS'URURXB55nU$)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 r~reserveRequestWeight)rrr|rd)rrrrR)rrrVr~rWr|rdrXs rreserve_request_weight"hyperliquid.reserve_request_weightcsm!!# U + ''6 "( ++DKK,HIr!c/n[S[U55H#nXnUSSUS'URU5 M% U$)Nrr,r)rTr:r_)rr[r_rZras rr]#hyperliquid.extract_type_from_deltaxsHq#d)$AWF#G_V4F6N NN6 "%r!c^UcgURS5(aURSS5$U$)NrVr)rr)rrs rr hyperliquid.format_vault_addresss1 ?   d # #??4, ,r! methodNamerVcSnURX!SS5up2UnURX!SU5upBUb US:waXB/$URbURS:waURU/$[URS-U-S-5e)Nrr>rr zF() requires a user parameter inside 'params' or the wallet address set)rCrrr"r2)rrrVuserAuxrs rr!hyperliquid.handle_public_addresss99&fVij44VT[\   42:> !    *1C1Cr1I&&/ /# :>H!HI Ir!rcURS5S:dURS5S:aU$URS5S:aURSS5nURU5S-$)Nr*r-@rrr)findrr.)rrs rrhyperliquid.coin_to_market_ids\ 99S>B $))C.2"5K 99S>B <<S)D&&t,|;;r!reasonurlrsheadersbodyc U(dgURUSS5n URUS5n Sn U S:XaURUS5n OU S:Xa[URS-U-5eU bU n OoURUS05n URU S05nUR US /5n[ S [ U55HnURUUS5n U cM O URS-U-nU SL=(a U S:gnU(a@URURS U U5 URURS U U5 U(a [U5eg) NrrrerrrX unknownOidrr[rrrr) r,r&r2r-rSrTr:throw_exactly_matched_exceptionrthrow_broadly_matched_exceptionr!)rrHrrrsrrrXrequestHeaders requestBodyrrrZresponsePayloadr[rrZfeedbacknonEmptyMessages r handle_errorshyperliquid.handle_errorssV!!(Hb9  73 U?&&x>/62>D~~dJ;H1c(m,**8A;@&-77S=4'#4/Dgm   0 01I7T\ ]  0 01I7T\ ] ) )r!rGETcURURSU5S-U-nUS:XaSS0nURU5nXsXeS.$)Nrr*POSTz Content-Typezapplication/json)rrsrr)implode_hostnamerjson)rpathrrsrVrrrs rsignhyperliquid.signsZ##DIIe$4S$9:S@4G V  2G99V$DdOOr!cfSU;aSU;aUSnUSnXg;aXv$URUSS5$)Nrrrr)r)rrrsrrVconfigrrs rcalculate_rate_limiter_cost'hyperliquid.calculate_rate_limiter_costsD  Vv%5&>DH%F~|#vvq11r!cURU5nSn URUSSS5upURU 5n USnUUUUUUS.n 0n U bXS'UbXS'X/$)NrQr}r>r&)r&rrrGrrVr2)r/rCr) rr2r&rrrGrrVr/r}rrs rr(hyperliquid.parse_create_edit_order_argssV$ #>>v}Vdfyz 00> !    #+7 ( >$K$$r!ro)NNNN)N)T)__name__ __module__ __qualname____firstlineno__rrr#rorr/rr r;rr\r rfrbr`floatrradictrrrr rrrrrrrrrrrrBr7rArIrNrSr[rerhrqrobjectrrrrrrrrrrPrrrrrr rrrr rr.r-r3rrKrPrXr\r[rrhrprr{rrrrrrrrrrrrrrrrrr rrrr rrrrrrr(rr@r?r rHrSrRrbrgrlrprxr}rrr]rrrrrrr__static_attributes__ __classcell__)rs@rr.r.sE P #P d .S_"]C]]RU]jm]zI]]*');Z;z$&$v,6)+mtF|m^)+7*tF|7*r(1u(1u(1[`(1T)+gtF|gRc 4c Fc J$&Y)(Y)v:>b.fs.f3.fY.f`04B GW G7 GD6:"7977979r/ v/ / b46:9=4^bkm8]#8]#8]S8]X[8]rvw{r|8]t  4 06:UW6A36As6A#6Ap}kkk: L  J**X  C C C C C. 13 1C 1D AC"14"1Hgksu3iyRW`c6@B)9D$6)9Vmqy{939i9y9Z]9fi9v46^$^@37r)s)C)$;?r-c-C-^CGr2c2C2VZ2hSUF55H0IF5P<>&s&P24iVTXfjsuS#SS`c:>@4+$|"44+lQS$$3$C$L8<$]ajl5O5OC5OWZ5On/3TXac7H7H37Hc7Hhlmrhs7Hr154VZce U# US UPS Ujnotju U37TX\eg UC Us URU Ulpqvlw U>BPTcgpr Us U# U]` Uw{}BxC U*.Dt\^!A3!Ac!A!Acghmcn!AF26b;.c;.3;.zVVvVVp::":-1tRV_a5Ac5A5AC5An55v55n24 0S 026bFPwFPT(^FPPJ tJ VJ X>B"3#3s3j9=R.S.#.`=? H He HCU H@B KC K KFX KFH% 3% L^% N d F N` &[]a1Sa1%a1ca1ca1ana1F t x = KOWY<0S<0%<0#<0C<0^i<0|1 T1 X1 Q\1 f579494;N94v, T, 6, EX, \(,$TZ\&?&?C&?s&?aefqar&?P't'x';'R8*.Dt\^7E37Ec7E7Er-1tRV_a5Hc5H5HC5Hfjkvfw5Hn7;2 ?G ?79 # FB37TX\eg+BC+Bs+BRU+BZ" 6" H:<S*,.C I IT Irsw (1 KKKKKKKK*.'.)*)09=4%K?%(KK?%r!