ihddlmZddlmZddlmZmZmZmZm Z m Z m Z m Z m Z mZmZmZmZmZmZddlmZddlmZddlmZddlmZddlmZdd lmZdd lmZdd lmZdd lmZdd lm Z ddl!m"Z"GddeeZ#dS))Exchange) ImplicitAPI)Balances CurrenciesIntMarginModificationMarketNumOrder OrderBook OrderRequest OrderSide OrderTypeStrStringsTrade TransferEntry)List) ExchangeError)ArgumentsRequired) InvalidOrder) OrderNotFound) NotSupported)ROUND)DECIMAL_PLACES)SIGNIFICANT_DIGITS) TICK_SIZE)Precisec eZdZfdZfdZifdefdZifdeefdZ ifdeefdZ ifdeefdZ defdZ ifde fd Zd ifd ed edefd Zdd d ifd eded edeefdZdOdedefdZd d d ifd eded efdZdZd edefdZdZdZdZdPdZdZdOdefdZ dZ!dZ"dZ#d ifd ed e$d!e%d"e&d#e'f d$Z(ifd%ee)fd&Z*d ifd'ed efd(Z+d ifd)eed efd*Z,d d ifd'ed ed ed!ed"e'd#e'f d+Z-d d d ifd eded efd,Z.d d d ifd eded edee/fd-Z0d d d ifd eded edee/fd.Z1d ifd'ed efd/Z2dOdede/fd0Z3d1Z4d2Z5d d d ifd eded efd3Z6dOdede7fd4Z8ifd efd5Z9d ifd6e:fd7Z;dOdefd8Zifd ede?fd=Z@ifd ede?fd>ZAifd ede?fd?ZBdOdede?fd@ZCifdAed"e&dBedCedeDf dDZEd ifdAefdEZFdOdFefdGZGdHedIeHfdJZIdKZJdLdMid d fdNZKxZLS)Q hyperliquidc|tt|idddddgdddd d d d d didddd dd dd dd dd dd dd dd dd dd dd dd dd dd dd dd id d d!d d"d d#d d$d d%d d&d d'd d(d d)d d*d d+d d,d d-d d.d d/d d0d id1d2d3d d4d d5d d6d d7d d8d d9d d:d d;d dd d?dd@d dAd dBd idCd dDd dEd dFd dGd dHd dId dJd dKd dLd dMd dNd dOd dPd dQd dRd dSd idTd dUd dVd dWd dXd dYd dZd d[d d\d d]d d^d d_d d`d dad dbd dcd dddedfdgdhdidjdkdldmdndodpdqdedrdsdtdudvdwdwdxdydydxdzd{d|d}d~ddddiidddiidxd|d|dd|d|ddddd d d d ddit t t t t t t t t t d ddtdiddd dddiS)Nidr name Hyperliquid countriesversionv1 rateLimit2 certifiedFproThasCORSspotmarginswapfutureoption addMarginborrowCrossMarginborrowIsolatedMargincancelAllOrders cancelOrder cancelOrderscloseAllPositions closePositioncreateMarketBuyOrderWithCostcreateMarketOrderWithCostcreateMarketSellOrderWithCost createOrder createOrderscreateReduceOnlyOrder editOrder fetchAccounts fetchBalancefetchBorrowInterestfetchBorrowRateHistoriesfetchBorrowRateHistoryfetchCanceledOrdersfetchClosedOrdersfetchCrossBorrowRatefetchCrossBorrowRatesfetchCurrenciesfetchDepositAddressfetchDepositAddresses fetchDepositsfetchDepositWithdrawFeeemulatedfetchDepositWithdrawFeesfetchFundingHistoryfetchFundingRatefetchFundingRateHistoryfetchFundingRatesfetchIndexOHLCVfetchIsolatedBorrowRatefetchIsolatedBorrowRates fetchLedger fetchLeveragefetchLeverageTiersfetchLiquidationsfetchMarginModefetchMarketLeverageTiers fetchMarketsfetchMarkOHLCVfetchMyLiquidations fetchMyTrades fetchOHLCVfetchOpenInterestfetchOpenInterestHistoryfetchOpenOrders fetchOrderfetchOrderBook fetchOrdersfetchOrderTrades fetchPositionfetchPositionModefetchPositionsfetchPositionsRiskfetchPremiumIndexOHLCV fetchTicker fetchTickers fetchTime fetchTradesfetchTradingFeefetchTradingFees fetchTransferfetchTransfersfetchWithdrawalfetchWithdrawals reduceMarginrepayCrossMarginrepayIsolatedMargin setLeverage setMarginModesetPositionModetransferwithdraw timeframes1m3m5m15m30m1h2h4h6h12h1d3d1w)rrrrrrrrrrrrr1Mhostnamezhyperliquid.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"4?U@&uAUB(CUD EUUUF*:GUH+EIUJ&uKUL#EMUN*4OUP$UQUR"5SUT*5UUV+EWUXuYUZ [U\%e]U^$U_U`"4aUb+EcUdeUf!%gUUUh&uiUj kUldmUn$UoUp+EqUr"4sUtduUv!$wUxuyUz#E{U| }U~$UU@!$AUB%eCUD)%EUFuGUHIUUUJUKULtMUN"5OUP#EQUR SUT!%UUV"5WUX#EYUZ[U\#E]U^&u_U`taUb cUd"5eUfDgUhDiUUsF | }sF \ )]sF ^ k67 DD1[V:_sF |  "A  }sF T !..y99!..x88 "..y99!..x88  UsF h "!%" $$isF t >J>$2..DB##D&11D**400D!    F4LL rc||||g}|}|d}|d}|||S)a retrieves data on all markets for hyperliquid :see: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-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)fetch_swap_marketsfetch_spot_markets array_concat)rr rawPromisespromises swapMarkets spotMarketss r fetch_marketszhyperliquid.fetch_marketss\  # #F + +  # #F + + qk qk   k:::rc ddi}||||}||di}||dg}||di}g}t dt |D]\}||||i|||i}||d<||]||S)a retrieves data on all swap markets for hyperliquid :see: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-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 rmetaAndAssetCtxsrrrbaseId)rrrrrrappend parse_markets) rrrrr assetCtxsrrrs rrzhyperliquid.fetch_swap_marketss & &&t{{7F'C'CDD>~~h2..~~dJ33NN8Q33 q#d))$$  A;;tQ++y!R00DDN MM$    !!&)))rcddi}||||}||di}||dg}||dg}g}t dt |D]D}|||i} || d} | d} || d} || d} || }|| }|dz|z}||j d i}| |d }| |d }|| dg}| |d}| |d}|||i}|||i}||d }| |d }| |d z}| |id|d|d|d|ddd|d| dddd d dddddddddddddddd||ddddd||||d ddd!ddd!ddd!ddd!d"d| d# F|S)$a retrieves data on all spot markets for hyperliquid :see: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-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 rspotMetaAndAssetCtxsrrtokensr#/rr.rr szDecimalsi'r"symbolbasequotesettleNrquoteIdsettleIdTr/r0Fr1r2rcontractlinearamountpriceminmaxleveragerrcost inverserr contractSizeexpiryexpiryDatetimestrike optionTyperrcreatedr)rrrrrrrsplitrr safe_number safe_integernumber_to_stringrsafe_market_structurerparse_precision)rrrrfirstrrmarketsrmarket marketName marketPartsbaseNamerrrrrrr tokensPos baseTokenPos quoteTokenPos baseTokenInfoquoteTokenInfo baseDecimals quoteDecimalsrs rrzhyperliquid.fetch_spot_marketsHs * &&t{{7F'C'CDDHxB//~~eZ44x44q#d))$$F F A^^D!R00F))&&99J$**3//K'' Q77H&&{A66G**844D++G44ECZ%'F>>$)VR88D$$T733E$$T733Evx<` NrCr.spotClearinghouseStateclearinghouseStateruserbalancesrrcointotalholdfree marginSummary accountValuetotalMarginUsed)r%used)rrtime timestampdatetime)handle_public_addresshandle_market_type_and_paramsrrrrrrraccount safe_balancer safe_floatriso8601)rr userAddressrisSpotreqTyperrr# spotBalancesrbalancerr1r%r'rrr-s r fetch_balancezhyperliquid.fetch_balances  "88PP V99.$PVWW f&./5P**>(J77  "H-L1c(mm,, - -"1+..t/?/?/P/PQQ,,..(('::''88#( "&%, T""$$\22 2~~h<<~>>.?@@  %%h77 '{!\\)44z  (((rNrlimitc |||}d|dd}||||}||dg}||dg||dgd}||d} |||d | d d d d S)aW fetches information on open orders with bid(buy) and ask(sell) prices, volumes and other data :see: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#info :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 l2Bookrrr$levelsrr)bidsasksr,rr@rApxsz) load_marketsr rrrrparse_order_book) rrr;rr rrrrr-s rfetch_order_bookzhyperliquid.fetch_order_bookls V$$6N  &&t{{7F'C'CDD.~~h"55NN4B//NN4B//  %%h77 $$VVH-=y&RXZ^`deeerrsincec|||}||d|}|d}|d}||dg}d|d|||dd}||||} || ||||S) a) fetches historical candlestick data containing the open, high, low, and close price, and the volume of a market :see: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#info-1 :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 untilNricandleSnapshotr)r$interval startTimeendTime)rreq)rDr r millisecondsomitrr parse_ohlcvs) rr timeframerGr;rr rIrrs r fetch_ohlcvzhyperliquid.fetch_ohlcvs V$$!!&'43D3D3F3FGG =E =E6G9--$v%"   &&t{{7F'C'CDD"  69eUKKKrr c ||d||d||d||d||d||dgS)Ntohlcv)rr)rohlcvr s r parse_ohlcvzhyperliquid.parse_ohlcvs   eS ) )   UC ( (   UC ( (   UC ( (   UC ( (   UC ( (   rcd}|d|\}}|||}d|i}| d|d<||d<nd|d<||d}||d}|||d <||||} || |||S) a get the list of most recent trades for a particular symbol :see: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills :see: 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 :returns Trade[]: a list of `trade structures ` Nrsr"userFillsByTimerrL userFillsrIrMr/rD safe_marketrrPrr parse_trades rrrGr;rr5r rrIrs r fetch_tradeszhyperliquid.fetch_tradess "88OO V !!&)) K   /GFO#(GK )GFO!!&'2267++  !&GI &&t{{7F'C'CDD*  65%@@@rct||t|j|dd|jS)Nrr)decimal_to_precisionrr r)rrrs ramount_to_precisionzhyperliquid.amount_to_precisions2(( V8L[8YZb8ceiewxxxrc||}||t|ddt|j}||tdt |j}|S)Nrr)r rfrr paddingModer)rrrr rdecimalParsedResults rprice_to_precisionzhyperliquid.price_to_precisionscV$$**5% 9LW9UWikok{||"77q.Z^Zjkk""rc6d||ddzS)N0xkeccakhex)hash)rmessages r hash_messagezhyperliquid.hash_message sdii59999rc||dd|dddd}d|dzd|dz|d|ddS) N secp256k1rnrsrZ)rwrxrZ)ecdsasum)rrqr signatures r sign_hashzhyperliquid.sign_hash#sfJJtCDDz:cdd+;[$OO  #& #&"in--   rcd||||ddS)Nru)r}rs)rrrrs r sign_messagezhyperliquid.sign_message+s-~~d//88*STT:JKKKrTc|rdnd}||dS)Nba)source connectionId)rrq isTestnetrs rconstruct_phantom_agentz#hyperliquid.construct_phantom_agent.s%",    rc||}||}|}|d||zz }||dz }n |dz }||z }|||ddS)N000000001robinary)packbbinary_to_base16 int_to_base16rqbase16_to_binary)raction vaultAddressnonce dataBinarydataHexrs r action_hashzhyperliquid.action_hash5sZZ'' '' 33 $,,U3333   DLDD DLD L Dyy..t44hIIIrc\||||}||jdd}|||}||jd}d}|d|dd} dd d d d d d gi} || | |} || |j} | S)NrFri9rrchainIdr#verifyingContractr&Agentrstringr#rrbytes32)r safe_boolrrreth_encode_structured_datarr) rrr vaultAdressrqr phantomAgentrrdomain messageTypesmsgr|s rsign_l1_actionzhyperliquid.sign_l1_actionAs U;;NN4<FF 33D)DD .&&t|]CC !,    !844';; --flLQQ%%c4?;; rc||jd}|d|dd}||||}|||j}|S)Nrrrr)rrrrr)rrrrrrrrr|s r build_sigzhyperliquid.build_sigmsg&&t|]CC !,    --flGLL%%c4?;; rc||jd}|rdnd}dddddddd d dgi}||||S) Nrn鱤UsdTransferSignPayload destinationrrrr,uint64rrrrrr isSandboxModerrs rbuild_transfer_sigzhyperliquid.build_transfer_sigysmt|]CC *6&& $&99!84422' ~~g|W===rc||jd}|rdnd}dddddddd d dgi}||||S) NrrrWithdrawFromBridge2SignPayloadrrrusdr,rrrs rbuild_withdraw_sigzhyperliquid.build_withdraw_sigsmt|]CC *6&& ,&991122/ ~~g|W===rrsiderrc>|||}||d}||d}|d}||||||d} i} ||| d<|| g| } || d} | S)a% create a trade order :see: 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 fullfilled, 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 :returns dict: an `order structure ` rr)rrrrrrNr)rDr rrP create_ordersr) rrrrrrrr rorder globalParamsrr s r create_orderzhyperliquid.create_orders& V$$''?? 6>22!     #+7L (%%ug|<<x++ rordersc ||||jd}||d|}d}t dt |D]<}||}||di}||dd}|d }=|rot dt |D]Q}||}||di}||dd}|t|j d zR| |gd }| } g} t dt |D]}||}||d } | | } | d } | |d }|dk}| |d}|dk}||d}||d}||di}||dd}||d|}|rdnd}||dd}|rd}||d|}||}||dd}||d|}||d}|p|}d}|r|t|j dz|r(t#j|t#jd|n't#j|t#jd|}|| |}n|| |}|| |}||dd}i}|rAd} ||| |}d } n|| |}||| rdnd d!|d"<nd#|i|d$<| |gd%}|| d&|||||d'}!|||!d(<| ||!||||d)}"d*| d+d,}#|"d-|#d.<||#| |"}$|#| |$d/}%|"| |d)}|"|%d)<|||%|}&||&d0i}'||'d1i}(||(d2g})||)dS)3a create a list of trade orders :see: 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 ` rslippageFrr clientOrderId client_idNTzV createOrders() all orders must have clientOrderId if at least one has a clientOrderId) rrrr triggerPrice stopPrice stopLossPricetakeProfitPrice timeInForcerrMARKETrBUYrriocgtcpostOnlyalorrrrrzy market orders require price to calculate the max slippage price. Default slippage can be set in options(default is 5%).r reduceOnlytpslisMarket triggerPxtpsltriggertifr;) rrrrrrrrrrrrrprxrwrUrYrrna)rrgroupingr brokerCoderrr|rrstatuses)check_required_credentialsrDrrrrr safe_string_2rr"rPrOr safe_string_upperrsafe_string_lower capitalizer string_mul string_add string_subrlrg parse_to_intrrformat_vault_addressrprivatePostExchanger parse_orders)*rrrrhasClientOrderIdrrawOrder orderParamsrrorderReqmarketIdr rrrrisBuyrrrdefaultTimeInForcerrrrr isTriggerrBrCr orderTypeisTporderObjr orderActionr|rr responseObjrrs* rrzhyperliquid.create_orderssW ''))) **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++&&? @? @AayH''(;;H[[**FH%F))(F;;D(H))(F;;DU]E%%h99F$$Xw77E..8R@@K ..{O[YYM'' ZQQH+3!?% ~~k:uEEH +%*"00mM_``K//+66K--k>;WWL ,,[/<XXM"..{> ? ? ? ?001A1A&.1Y1YZZ    ()K %'' ULII !"    #YYv~66F&2GN #++DKK,H,HII$nnXz2>> ~~k6266>>$ B77  4000rr"c2||g||S)a cancels an open order :see: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s :see: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s-by-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.vaultAddress]: the vault address for order :returns dict: An `order structure ` ) cancel_orders)rr"rrs r cancel_orderzhyperliquid.cancel_order>s!!2$777ridsc||t|jdz|||}||dd}||ddg}|}d|i}g}dgd} ||d} |\t|ts|g}d | d <td t|D] } | | || d !nVd | d <td t|D]3} | | ||| d4|| d<|||d} || || } | |d<| |d<| ||d}| |d<||||}|S)a cancel multiple orders :see: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s :see: 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 :returns dict: an list of `order structures ` Nz* cancelOrders() requires a symbol argumentrrr)rcancelsr cancelByCloidrr)assetcloidcancel)rrVrrrr|)rrr"rDr  safe_value_2rPrOparse_to_numeric isinstancelistrrrrrrrr)rrrrr rrr cancelReq cancelActionrrrr|rs rrzhyperliquid.cancel_ordersLsc ''))) >#DG.Z$Z[[ [ V$$))&/;OO 6O[#ABB!!## U    &&vh'788  $mT22 0!. #2L 1c-0011    #*1-""  $,L 1c#hh''    ..s1v66""#, Y001A1A&.1Y1YZZ '' e\JJ ((   #YYv~66F&2GN #++DKK,H,HIIrc||t|jdz|||}|}|dk} |}|dk} ||jd} ||d| } | rdnd} ||d d }|rd } | |d | }| |}| |d d}| |dd}||d|}||d}|p|}| |gd}t|}| rm| r5ttj|tjd| n4ttj|tjd| }n#||t|}|||}||dd }i}|rAd }||||}d}n|||}| ||rdndd|d<nd|i|d<|d}|}||d| ||||d}|||d <|||d!}d"|gd#}|||d$}||||}|||d%} || |d$}|| d$<||| |}!||!d&i}"||"d'i}#||#d(g}$||$d)i}%||%|S)*a edit a trade order :see: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#modify-an-order :see: 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 fullfilled, in units of the base 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 :returns dict: an `order structure ` Nz$ editOrder() requires an id argumentrrrrrrrFrrrrrrrr)rrrrrrrrrTrrrrrr;0rrrY)oidr batchModify)rmodifiesrrrrrr)rrr"rDr upperrrrrrrrPstrrrrrrlrgrOrrrrrrr parse_order)&rr"rrrrrrr rrrrrrrrrrrrrBrCrrrrr modifyReq modifyActionrr|rrresponseObject dataObjectrr s& r edit_orderzhyperliquid.edit_orders( ''))) :#DG.T$TUU U V$$zz||H$zz||**4<9JKK##FJHH'/;UUe>>&*e<<  '!& ,,V]DVWW ook22 **6?KPP ))&.+NN ((,OO **63DEE"5o 6$Q$Q$QRR ZZ  =W\eW'..0B30Q0QRRRcfgngyzhAhACJCUVY[cCdCddedeBB((U<>*j"==xB//v...rc |||}d|dd}|||d<n|dz |d<||d}||d}|||d<||||}g} td t|D]v} || } || d } | | | d|| | d | | | d w| | d } || |||S)a fetches historical funding rate prices :see: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#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 ` fundingHistoryrr>NrLi*urIrMrr, fundingRate)rrrr-r.r-)rDr rOrrPrrrrr safe_symbolrr4sort_byfilter_by_symbol_since_limit)rrrGr;rr rrIrrrentryr-sorteds rfetch_funding_rate_historyz&hyperliquid.fetch_funding_rate_history s V$$$6N    #(GK #'#4#4#6#69M#MGK !!&'2267++  !&GI &&t{{7F'C'CDDq#h--((  AQKE))%88I MM**488#//}EE& LL33     fk2200NNNrcd}|d|\}}|||}d|d}||||}|||||S)a fetch all unfilled currently open orders :see: 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 :returns Order[]: a list of `order structures ` Nrf openOrdersr!r/rDrarrr rrrGr;rr5r rrs rfetch_open_orderszhyperliquid.fetch_open_ordersRs "889JFSS V !!&))   &&t{{7F'C'CDD  65%@@@rcd}|d|\}}|||}d|d}||||}|||||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 ` NrHhistoricalOrdersr!rr s rfetch_closed_orderszhyperliquid.fetch_closed_ordersus "889LfUU V !!&))&  &&t{{7F'C'CDD  65%@@@rcfd}|d|\}}|||}d|||d}||||}||d}|||S)a$ fetches information on an order made by the user :see: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#query-order-status-by-oid-or-cloid :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.user]: user address, will default to self.walletAddress if not provided :returns dict: An `order structure ` Nrg orderStatus)rr r"r)r/rDrarrrrr) rr"rrr5r rrrs r fetch_orderzhyperliquid.fetch_orders "88vNN V !!&))!((,,   &&t{{7F'C'CDD8~~h00f---rc n||gd}||}||d}d}|!|ddkr|}n|dz}||d||d}n|||}|d}||dd }||d }||d } | | d krd nd} |id|d||dd||dd|d||ddddd|d||dd||dddd| |dd | d| |dd| |dr| |d ndd!| |d"d#d$d| |d%dd| |ddd&|S)'N)rrestingfilledr$r /USDC:USDCr"rr-statusTimestampstatusrAsellbuyrr rrr.lastTradeTimestamplastUpdateTimestamprrrrrrrlimitPxrrrrrCtotalSzravgPx)averager* remainingr.rtrades) safe_dict_nrfindrasafe_integer_2 safe_orderr4rrrr safe_number_2parse_order_status) rrr rr$rrr-r.rs rrzhyperliquid.parse_ordersR  (F(F(FGG =Ev..  yy~~"",.   E4 ( ( 0%%h55FF%%h77F!''{>  411%??    $.. ==  D  T%%eY77  DNNSXZeDfDfpD,,UK@@@lp d((i@@! " D# $''w77--f55/   0 1 rc:ddd}||||S)Nopenclosed) triggeredr*rrr.rs rr?zhyperliquid.parse_order_status?s.  &&999rc:ddd}||||S)Nr;r )z stop limitz stop marketrDrEs rparse_order_typezhyperliquid.parse_order_typeFs.!#  &&999rcd}|d|\}}|||}d|i}| d|d<||d<nd|d<||d}||d}|||d <||||} || |||S) a fetch all trades made by the user :see: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-fills :see: 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 :returns Trade[]: a list of `trade structures ` Nrbr"r^rrLr_rIrMr`rcs rfetch_my_tradeszhyperliquid.fetch_my_tradesMs "88&QQ V !!&)) K   /GFO#(GK )GFO!!&'2267++  !&GI &&t{{7F'C'CDD*  65%@@@rc0||d}||d}||d}||d}|dz}||d}|d}||d} ||d} | | d krd nd } ||d } ||||||| ||d d| d||d| ddd |S)Nr,rBrCr$r,rtidrr/r0r1rr r)rcurrency) rr-r.rr"rrr takerOrMakerrrrr)rrra safe_trader4) rtrader r-rrr$rrr"rrs r parse_tradezhyperliquid.parse_tradesG&%%eV44   --!!%..v..,&!!(D11!   eU + +v..  "ckk66Due,," Y//%%eU33 V44    rc^||g|}||diS)a fetch data on an open position :see: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-state :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)rrr positionss rfetch_positionzhyperliquid.fetch_positions1((&6:: ~~iB///rsymbolsc|d}|d|\}}||}d|d}||||}||dg}g}t dt|D]1}|| ||d2| |d|dS) a fetch all open positions :see: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint#retrieve-a-users-state :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 :returns dict[]: a list of `position structure ` Nrmr r!assetPositionsrrF) rDr/market_symbolsrrrrrrparse_positionfilter_by_array_positions) rrUrr5rrrrrs rrRzhyperliquid.fetch_positionss  "889I6RR V%%g..(  &&t{{7F'C'CDD\~~h(8"==q#d))$$ > >A MM$--d1gt<< = = = =--fhOOOrc ||di}||d}|dz}||d}|d}||di}||ddk}||d} d} | | d krd nd } ||d } ||d } | | z dz} |id|ddd|ddddd|ddd| d||dddd||dddd||dd||dddd| d ddd| ||d!d| d"S)#Npositionr$r,rrrisolatedrawUsdrshortlong unrealizedPnl marginUseddrr"r-r.hedgedr contractsszir entryPriceentryPx markPricenotional positionValuevalue collateral initialMarginmaintenanceMargin liquidationPx)initialMarginPercentagemaintenanceMarginPercentageraliquidationPrice marginMode percentage)rrrar safe_position)rr\r rr$rrr isIsolatedquantityrrarnrus rrYzhyperliquid.parse_positionsH6xR88v..,&!!(D11!>>%R88&&x88JF ##Hh77  '!||77&D((@@ (( == "]2S8 !!# H# $#  f#   #  #  #  d#  D#  ))%77#  D#  $**5)<<#  #  ((@@#  ((7;;#  $# ]!# " ## $(,+/* $ 0 0 H H$/# # #    rrtc|t|jdz|||}||d}|t|jdz||d}|dk}|}||dg}d|||d} ||d } | A||d }| d r| d d } | | |} | | || } | || d } | | | d <| | }|S) 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) :returns dict: response from the exchange Nz+ setMarginMode() requires a symbol argumentrz. setMarginMode() requires a leverage parameterrcrossupdateLeveragerrisCrossrrrnrr)rr"rDr rrrOrPr startswithreplacerrr)rrtrrr rrr}r updateActionrextendedActionr|rrs rset_margin_modezhyperliquid.set_margin_modeCs >#DG.[$[\\ \ V$$$$VZ88  #DG.^$^__ _!!&"233(!!##6J<00$   ''??  #YYv~66F&&t,, >+33D"== \6::''|LL $"    #&2GN #++G44rrct|t|jdz|||}||dd}|dk}||d}|}||d}d|||d} |||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 argumentrtrzrr{r|rr) rr"rDr rrrOrPrrrr)rrrrr rtr}rrrrr|rrs r set_leveragezhyperliquid.set_leveragewsU >#DG.Y$YZZ Z V$$%%flGDD (!!&"233!!##6<00$   001A1A&.1Y1YZZ '' e\JJ ""    #YYv~66F&2GN #++DKK,H,HIIrc2|||d|S)a add margin :see: 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 :returns dict: a `margin structure ` addmodify_margin_helperrrrrs r add_marginzhyperliquid.add_margins((GGGrc2|||d|S)a :see: 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 :returns dict: a `margin structure ` reducerrs r reduce_marginzhyperliquid.reduce_margins((6JJJrc|||}||d}|tj|||d}|dkr| }|}d|d|d} |||d} | | || } | || d} | | |d}| | d<| | | |} | | | |d || d iS) Nr1000000rupdateIsolatedMarginT)rrrntlirrrr.)rDr rrrrgrOrrrrPrrparse_margin_modification)rrrrrr rrCrrrr|rrs rrz hyperliquid.modify_margin_helpers V$$!!&"233   w1$2J2J6SY2Z2Z\eff g g 8  B!!##*   001A1A&.1Y1YZZ '' e\JJ ""    #YYv~66F&2GN #++DKK,H,HII{{499(FKK D$$Xx88N    rc l||d|dddd||ddddd S)Nr]r) rrrrtrr%rr.r-r.)rr)rrr s rrz%hyperliquid.parse_margin_modificationsQ&&tV44$$$VX66   rr fromAccount toAccountc||||jd}|}||gdr||gdst |jdz|| |d}| |d}|dkp|dk} d|| dd } | | ||} | | ||| d } ||| d<| | } | S|||1|}|d krt |jd z||||d}||}|rdnd|dd||d }| | ||}|S)a transfer currency internally between wallets on the same account :see: 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.r0perpz-transfer() only support spot <> swap transferrrr0spotUser)usdctoPerp)r classTransferrNrwithdraw() only support USDC)rrr,ArbitrumTestnetArbitrum usdTransferchainpayloadr)rrDrrrOin_arrayrr"rrrPrrr check_addressr rr)rrrrrrrrrrrr| innerRequesttransferResponsersigrrs rrzhyperliquid.transfersJ ''))) t|]CC !!## ==&>&>&> ? ? $==,D,D,DEE ^"47-\#\]]]44T5E5Efn5]5]^^LYYv~66F6)CyF/BF""$""F++FE<HHI++ff55&L '/; ^,#77 EE # # 9%%%  ::<` Nrrr)rrr,rr withdraw2rr) rrDrr rr"rrrOr rrr) rrraddresstagrrrrrrrs rrzhyperliquid.withdraw4s  '')))  7###  ::< !   *1Cr1I1I&/ /# :>H!HII Irc 8|sdS||dd} d} | dkr||d} nq||di} || di} || dg}||d}||d} |jd z|z}| duo| dk}|rD||jd | |||jd | ||rt|dS) Nr.rerrrrrrerrorrrr)rrrr"throw_exactly_matched_exceptionrthrow_broadly_matched_exceptionr)rrreasonurlmethodheadersbodyrrequestHeaders requestBodyr.rrresponsePayloadrr firstStatusfeedbacknonEmptyMessages r handle_errorszhyperliquid.handle_errorsls; 4!!(Hb99 U??&&x<>/62>>D~~dJ;;H..155K&&{G<b,f,fs,f3,fY,f,f,f,f\26DW[df.L.L#.Lc.LQT.Lkoptku.L.L.L.L`   4    0*.Dt\^3A3A33Ac3A3A3A3A3Ajyyy###### :::   LLL     J J J******X    > > > > > >gksu%%3%i%y%RW%`c%%%%N@BD1D1D$6D1D1D1D1L37r 8 8s 8C 8 8 8 8;?rDDcDCDDDDLTXfjsuL/L/SL/#L/SL/L/SL/`cL/L/L/L/\8<$]ajl0O0O0OC0OWZ0O0O0O0Od/3TXac!A!A!A3!Ac!Ahlmrhs!A!A!A!AF154VZce A A# AS APS Ajnotju A A A AD26b/./.c/.3/./././.buuu5uuuun::::::-1tRV_a1A1Ac1A1AC1A1A1A1Af---5----^24 0 0S 0 0 0 026bCPCPwCPCPCPCPJA A vA A A A F>B"22#2s2222h9=R,,S,#,,,,\68 H H H>S>%>c>c>an>>>>@8rs ('''''111111qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq******......))))))******))))))000000999999======444444%%%%%%z!Pz!Pz!Pz!Pz!P(Kz!Pz!Pz!Pz!Pz!Pr