trd-utils 0.0.19__py3-none-any.whl → 0.0.20__py3-none-any.whl

trd_utils/__init__.py

@@ -1,3 +1,3 @@
 
-__version__ = "0.0.19"
+__version__ = "0.0.20"
 

trd_utils/common_utils/wallet_utils.py

@@ -0,0 +1,26 @@
+"""
+General usage wallet-related utils code.
+"""
+
+
+def shorten_wallet_address(
+    address: str,
+    start_chars: int = 7,
+    end_chars: int = 6,
+):
+    """
+    Shortens an Ethereum address by keeping a specific number of characters
+    from the beginning and end, separated by '...'.
+
+    Args:
+        address (str): The Ethereum address to shorten
+        start_chars (int): Number of characters to keep from the beginning (default: 7)
+        end_chars (int): Number of characters to keep from the end (default: 6)
+
+    Returns:
+        str: The shortened address
+    """
+    if not address or len(address) <= start_chars + end_chars:
+        return address
+
+    return f"{address[:start_chars]}...{address[-end_chars:]}"

trd_utils/exchanges/base_types.py

@@ -1,10 +1,9 @@
-
-
 from datetime import datetime
 from decimal import Decimal
 
 from trd_utils.types_helper.base_model import BaseModel
 
+
 class UnifiedPositionInfo(BaseModel):
     # The id of the position.
     position_id: str = None
@@ -40,20 +39,22 @@ class UnifiedPositionInfo(BaseModel):
 
     def __str__(self):
         parts = []
-        
+
         # Add position pair and ID
-        parts.append(f"Position: {self.position_pair or 'Unknown'} (ID: {self.position_id or 'N/A'})")
-        
+        parts.append(
+            f"Position: {self.position_pair or 'Unknown'} (ID: {self.position_id or 'N/A'})"
+        )
+
         # Add side and leverage
         side_str = f"Side: {self.position_side or 'Unknown'}"
         if self.position_leverage is not None:
             side_str += f", {self.position_leverage}x"
         parts.append(side_str)
-        
+
         # Add margin mode if available
         if self.margin_mode:
             parts.append(f"Margin: {self.margin_mode}")
-        
+
         # Add open price if available
         price_str = "Open price: "
         if self.open_price is not None:
@@ -63,23 +64,25 @@ class UnifiedPositionInfo(BaseModel):
         else:
             price_str += "N/A"
         parts.append(price_str)
-        
+
         # Add open time if available
         if self.open_time:
             parts.append(f"Opened: {self.open_time.strftime('%Y-%m-%d %H:%M:%S')}")
-        
+
         # Add PNL if available
         if self.position_pnl is not None:
             parts.append(f"PNL: {self.position_pnl}")
-        
+
         return " | ".join(parts)
 
     def __repr__(self):
         return self.__str__()
 
+
 class UnifiedTraderPositions(BaseModel):
     positions: list[UnifiedPositionInfo] = None
 
+
 class UnifiedTraderInfo(BaseModel):
     # Trader's id. Either int or str. In DEXes (such as HyperLiquid),
     # this might be wallet address of the trader.
@@ -94,13 +97,15 @@ class UnifiedTraderInfo(BaseModel):
     # Trader's win-rate. Not all exchanges might support this field.
     win_rate: Decimal = None
 
+    def get_win_rate_str(self) -> str:
+        return str(round(self.win_rate, 2)) if self.win_rate is not None else "N/A"
+
     def __str__(self):
         return (
-            f"Trader: {self.trader_name} (ID: {self.trader_id})"
-            f"{' | Win Rate: ' + str(round(self.win_rate, 2))}"
-            f"{' | Profile: ' + self.trader_url}"
+            f"{self.trader_name} ({self.trader_id})"
+            f" | Win Rate: {self.get_win_rate_str()}"
+            f" | Profile: {self.trader_url}"
         )
-    
+
     def __repr__(self):
         return self.__str__()
-    

trd_utils/exchanges/hyperliquid/hyperliquid_client.py

@@ -8,11 +8,15 @@ import httpx
 from pathlib import Path
 
 from trd_utils.cipher import AESCipher
+from trd_utils.common_utils.wallet_utils import shorten_wallet_address
+from trd_utils.exchanges.base_types import UnifiedPositionInfo, UnifiedTraderInfo, UnifiedTraderPositions
 from trd_utils.exchanges.exchange_base import ExchangeBase
 from trd_utils.exchanges.hyperliquid.hyperliquid_types import HyperLiquidApiResponse, TraderPositionsInfoResponse
 
 logger = logging.getLogger(__name__)
 
+BASE_PROFILE_URL = "https://hypurrscan.io/address/"
+
 
 class HyperLiquidClient(ExchangeBase):
     ###########################################################
@@ -63,7 +67,7 @@ class HyperLiquidClient(ExchangeBase):
             f"{self.hyperliquid_api_base_host}/info",
             headers=headers,
             content=payload,
-            model=TraderPositionsInfoResponse,
+            model_type=TraderPositionsInfoResponse,
         )
 
     #endregion
@@ -78,7 +82,7 @@ class HyperLiquidClient(ExchangeBase):
     #         f"{self.hyperliquid_api_base_url}/another-thing/info",
     #         headers=headers,
     #         content=payload,
-    #         model=CopyTraderInfoResponse,
+    #         model_type=CopyTraderInfoResponse,
     #     )
 
     # endregion
@@ -138,3 +142,48 @@ class HyperLiquidClient(ExchangeBase):
 
     # endregion
     ###########################################################
+    # region unified methods
+    async def get_unified_trader_positions(
+        self,
+        uid: int | str,
+    ) -> UnifiedTraderPositions:
+        result = await self.get_trader_positions_info(
+            uid=uid,
+        )
+        unified_result = UnifiedTraderPositions()
+        unified_result.positions = []
+        for position_container in result.asset_positions:
+            position = position_container.position
+            unified_pos = UnifiedPositionInfo()
+            unified_pos.position_id = position.get_position_id()
+            unified_pos.position_pnl = round(position.unrealized_pnl, 3)
+            unified_pos.position_side = position.get_side()
+            unified_pos.margin_mode = position.leverage.type
+            unified_pos.position_leverage = Decimal(position.leverage.value)
+            unified_pos.position_pair = f"{position.coin}/USDT"
+            unified_pos.open_time = None # hyperliquid doesn't provide this...
+            unified_pos.open_price = position.entry_px
+            unified_pos.open_price_unit = "USDT"
+            unified_result.positions.append(unified_pos)
+
+        return unified_result
+
+    async def get_unified_trader_info(
+        self,
+        uid: int | str,
+    ) -> UnifiedTraderInfo:
+        if not isinstance(uid, str):
+            uid = str(uid)
+        # sadly hyperliquid doesn't really have an endpoint to fetch information
+        # so we have to somehow *fake* these...
+        # maybe in future try to find a better way?
+        unified_info = UnifiedTraderInfo()
+        unified_info.trader_id = uid
+        unified_info.trader_name = shorten_wallet_address(uid)
+        unified_info.trader_url = f"{BASE_PROFILE_URL}{uid}"
+        unified_info.win_rate = None
+
+        return unified_info
+
+    # endregion
+    ###########################################################

{trd_utils-0.0.19.dist-info → trd_utils-0.0.20.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: trd_utils
-Version: 0.0.19
+Version: 0.0.20
 Summary: Common Basic Utils for Python3. By ALiwoto.
 Keywords: utils,trd_utils,basic-utils,common-utils
 Author: ALiwoto

{trd_utils-0.0.19.dist-info → trd_utils-0.0.20.dist-info}/RECORD

@@ -1,11 +1,12 @@
-trd_utils/__init__.py,sha256=5VsjvbcZt1tZKEb5CSJ0arTPA63xHY8ibWQ5EXVRXvY,25
+trd_utils/__init__.py,sha256=zuFTqIXT51Hc1FEjtDNWqv0BXlPgdEGVKQ_5Z4W4oZs,25
 trd_utils/cipher/__init__.py,sha256=V05KNuzQwCic-ihMVHlC8sENaJGc3I8MCb4pg4849X8,1765
 trd_utils/common_utils/float_utils.py,sha256=W-jv7nzjl88xwGB6gsEXmDDhF6DseOrrVT2qx7OvyCo,266
+trd_utils/common_utils/wallet_utils.py,sha256=OX9q2fymP0VfIWTRIRBP8W33cfyjLXimxMgPOsZe-3g,727
 trd_utils/date_utils/__init__.py,sha256=Erg_E1TfKWNpiuZFm_NXRjCwoRMfxpPS2-mJK6V4lFM,77
 trd_utils/date_utils/datetime_helpers.py,sha256=euIJBr-6PfJzLScOC9xVXd8Re_Gw5CSBPwtHX9_Il4A,596
 trd_utils/exchanges/README.md,sha256=UwkpsfcoLCJaMvJe4yBsFkDpf8P6DOLYhtybb6xWMLc,6738
 trd_utils/exchanges/__init__.py,sha256=x74_8-P7ktZyL-1AuAU_SDQD8eKZMPh1gfkLzPuS1xY,440
-trd_utils/exchanges/base_types.py,sha256=bPsRUetQIHdW7ESMAQcjvX-Z2uixtCC93Vb-XnX6FFs,3229
+trd_utils/exchanges/base_types.py,sha256=9sjXwGaUlUgdYg2NJz64AIalPxKc2aGvjVZdt6aM63I,3284
 trd_utils/exchanges/blofin/__init__.py,sha256=X4r9o4Nyjla4UeOBG8lrgtnGYO2aErFMKaJ7yQrFasE,76
 trd_utils/exchanges/blofin/blofin_client.py,sha256=x0CU75_wWRA6RmVfm2wh7y-jNjohpcMG6HJ1tqkD1ok,12342
 trd_utils/exchanges/blofin/blofin_types.py,sha256=LnK3LEVlqU3Vg0Cg1jNmb5GGHQImwI6LCKaDw-aQa6A,4059
@@ -16,7 +17,7 @@ trd_utils/exchanges/bx_ultra/bx_utils.py,sha256=PwapomwDW33arVmKIDj6cL-aP0ptu4BY
 trd_utils/exchanges/exchange_base.py,sha256=ZY_9vL9LXtAbAmlWygdVyy0wC-QDla-JGWZ8HMRlkk8,4266
 trd_utils/exchanges/hyperliquid/README.md,sha256=-qaxmDt_9NTus2xRuzyFGkKgYDWgWk7ufHVTSkyn3t4,105
 trd_utils/exchanges/hyperliquid/__init__.py,sha256=QhwGRcneGFHREM-MMdYpbcx-aWdsWsu2WznHzx7LaUM,92
-trd_utils/exchanges/hyperliquid/hyperliquid_client.py,sha256=xLSZWTwjm2i0Paa8x8csdCahE16GN0yaP2b7wpV_S0w,4764
+trd_utils/exchanges/hyperliquid/hyperliquid_client.py,sha256=rqR5AG3aLV6vcho2lvYSgl8SCz-cFTNwag8dNLLDcn4,6852
 trd_utils/exchanges/hyperliquid/hyperliquid_types.py,sha256=ueL7Q4yOAK4orlUqeLVNRk6u1AG83pDeGJasTeT3774,2666
 trd_utils/html_utils/__init__.py,sha256=1WWs8C7JszRjTkmzIRLHpxWECHur_DrulTPGIeX88oM,426
 trd_utils/html_utils/html_formats.py,sha256=unKsvOiiDmYTTaM0DYZEUNLEUzWQKKrqASJXvY54kvU,2299
@@ -25,7 +26,7 @@ trd_utils/tradingview/tradingview_client.py,sha256=g_eWYaCRQAL8Kvd-r6AnAdbH7Jha6
 trd_utils/tradingview/tradingview_types.py,sha256=z21MXPVdWHAduEl3gSeMIRhxtBN9yK-jPYHfZSMIbSA,6144
 trd_utils/types_helper/__init__.py,sha256=lLbUiW1jUV1gjzTMFLthwkvF0hwauH-F_J2JZq--1U0,67
 trd_utils/types_helper/base_model.py,sha256=zehCrDH-9OhWtdKVu05yfcKP52oBD303aMEhs_nytSg,10892
-trd_utils-0.0.19.dist-info/LICENSE,sha256=J1EP2xt87RjjmsTV1jTjHDQMLIM9FjdwEftTpw8hyv4,1067
-trd_utils-0.0.19.dist-info/METADATA,sha256=GB_FuAcnnuw3a6HaRWIlEZeeF2IR1u5f4zFIYaXvqbg,1095
-trd_utils-0.0.19.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-trd_utils-0.0.19.dist-info/RECORD,,
+trd_utils-0.0.20.dist-info/LICENSE,sha256=J1EP2xt87RjjmsTV1jTjHDQMLIM9FjdwEftTpw8hyv4,1067
+trd_utils-0.0.20.dist-info/METADATA,sha256=9p1L_6c3sR9uN8UR0_hBQ-aFNMvuD4dj9E1GiVGKbFY,1095
+trd_utils-0.0.20.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+trd_utils-0.0.20.dist-info/RECORD,,