trd-utils 0.0.13__py3-none-any.whl → 0.0.15__py3-none-any.whl

trd_utils/exchanges/bx_ultra/bx_ultra_client.py

@@ -17,6 +17,8 @@ from trd_utils.exchanges.bx_ultra.bx_types import (
     AssetsInfoResponse,
     ContractOrdersHistoryResponse,
     ContractsListResponse,
+    CopyTraderFuturesStatsResponse,
+    CopyTraderResumeResponse,
     CopyTraderTradePositionsResponse,
     HintListResponse,
     HomePageResponse,
@@ -26,6 +28,7 @@ from trd_utils.exchanges.bx_ultra.bx_types import (
     SearchCopyTradersResponse,
     UserFavoriteQuotationResponse,
     ZenDeskABStatusResponse,
+    ZenDeskAuthResponse,
     ZoneModuleListResponse,
     BxApiResponse,
 )
@@ -45,6 +48,8 @@ ANDROID_APP_VERSION = "4.28.3"
 WEB_APP_VERSION = "4.78.12"
 TG_APP_VERSION = "5.0.15"
 
+ACCEPT_ENCODING_HEADER = "gzip, deflate, br, zstd"
+
 logger = logging.getLogger(__name__)
 
 
@@ -195,7 +200,13 @@ class BXUltraClient(ExchangeBase):
             headers=headers,
             model=ZenDeskABStatusResponse,
         )
-
+    async def do_zendesk_auth(self) -> ZenDeskAuthResponse:
+        headers = self.get_headers(needs_auth=True)
+        return await self.invoke_get(
+            f"{self.we_api_base_url}/customer/v1/zendesk/auth/jwt",
+            headers=headers,
+            model=ZenDeskAuthResponse,
+        )
     # endregion
     ###########################################################
     # region platform-tool
@@ -380,7 +391,7 @@ class BXUltraClient(ExchangeBase):
     # region copy-trade-facade
     async def get_copy_trade_trader_positions(
         self,
-        uid: str,
+        uid: int | str,
         api_identity: str,
         page_size: int = 20,
         page_id: int = 0,
@@ -438,6 +449,38 @@ class BXUltraClient(ExchangeBase):
             model=SearchCopyTradersResponse,
         )
 
+    async def get_copy_trader_futures_stats(
+        self,
+        uid: int | str,
+        api_identity: str,
+    ) -> CopyTraderFuturesStatsResponse:
+        params = {
+            "uid": f"{uid}",
+            "apiIdentity": f"{api_identity}",
+        }
+        headers = self.get_headers(params)
+        return await self.invoke_get(
+            f"{self.we_api_base_url}/copy-trade-facade/v4/trader/account/futures/stat",
+            headers=headers,
+            params=params,
+            model=CopyTraderFuturesStatsResponse,
+        )
+
+    async def get_copy_trader_resume(
+        self,
+        uid: int | str,
+    ) -> CopyTraderResumeResponse:
+        params = {
+            "uid": f"{uid}",
+        }
+        headers = self.get_headers(params)
+        return await self.invoke_get(
+            f"{self.we_api_base_url}/copy-trade-facade/v1/trader/resume",
+            headers=headers,
+            params=params,
+            model=CopyTraderResumeResponse,
+        )
+
     # endregion
     ###########################################################
     # region welfare
@@ -484,7 +527,7 @@ class BXUltraClient(ExchangeBase):
                 payload_data=payload,
             ),
             "Timestamp": f"{the_timestamp}",
-            'Accept-Encoding': 'gzip, deflate',
+            "Accept-Encoding": ACCEPT_ENCODING_HEADER,
             "User-Agent": self.user_agent,
             "Connection": "close",
             "appsiteid": "0",

trd_utils/exchanges/exchange_base.py

@@ -1,10 +1,11 @@
-
 from decimal import Decimal
 from typing import Any
 from abc import ABC
 
 import httpx
 
+from trd_utils.exchanges.base_types import UnifiedTraderInfo, UnifiedTraderPositions
+
 
 class ExchangeBase(ABC):
     ###########################################################
@@ -25,6 +26,38 @@ class ExchangeBase(ABC):
 
     _fav_letter: str = "^"
     # endregion
+    ###########################################################
+
+    # region abstract trading methods
+
+    async def get_unified_trader_positions(
+        self,
+        uid: int | str,
+    ) -> UnifiedTraderPositions:
+        """
+        Returns the unified version of all currently open positions of the specific
+        trader. Note that different exchanges might fill different fields, according to the
+        data they provide in their public APIs.
+        If you want to fetch past positions history, you have to use another method.
+        """
+        raise NotImplementedError(
+            "This method is not implemented in ExchangeBase class. "
+            "Please use a real exchange class inheriting and implementing this method."
+        )
+
+    async def get_unified_trader_info(self, uid: int | str) -> UnifiedTraderInfo:
+        """
+        Returns information about a specific trader.
+        Different exchanges might return and fill different information according to the
+        data returned from their public APIs.
+        """
+        raise NotImplementedError(
+            "This method is not implemented in ExchangeBase class. "
+            "Please use a real exchange class inheriting and implementing this method."
+        )
+
+    # endregion
+
     ###########################################################
     # region client helper methods
     def get_headers(self, payload=None, needs_auth: bool = False) -> dict:

trd_utils/exchanges/hyperliquid/README.md

@@ -0,0 +1,3 @@
+# Hyperdash
+
+NOTE: [Hyperdash](https://hyperdash.info) is not an exchange, but a tracker for HyperLiquid.

trd_utils/exchanges/hyperliquid/__init__.py

@@ -0,0 +1,7 @@
+
+from .hyperliquid_client import HyperLiquidClient
+
+
+__all__ = [
+    HyperLiquidClient,
+]

trd_utils/exchanges/hyperliquid/hyperliquid_client.py

@@ -0,0 +1,188 @@
+
+from decimal import Decimal
+import json
+import logging
+from typing import Type
+import httpx
+
+from pathlib import Path
+
+from trd_utils.cipher import AESCipher
+from trd_utils.exchanges.exchange_base import ExchangeBase
+from trd_utils.exchanges.hyperliquid.hyperliquid_types import HyperLiquidApiResponse, TraderPositionsInfoResponse
+
+logger = logging.getLogger(__name__)
+
+
+class HyperLiquidClient(ExchangeBase):
+    ###########################################################
+    # region client parameters
+    hyperliquid_api_base_host: str = "https://api.hyperliquid.xyz"
+    hyperliquid_api_base_url: str = "https://api.hyperliquid.xyz"
+    origin_header: str = "app.hyperliquid.xy"
+
+    # endregion
+    ###########################################################
+    # region client constructor
+    def __init__(
+        self,
+        account_name: str = "default",
+        http_verify: bool = True,
+        fav_letter: str = "^",
+        read_session_file: bool = False,
+        sessions_dir: str = "sessions",
+        use_http1: bool = True,
+        use_http2: bool = False,
+    ):
+        # it looks like hyperliquid's api endpoints don't support http2 :(
+        self.httpx_client = httpx.AsyncClient(
+            verify=http_verify,
+            http1=use_http1,
+            http2=use_http2,
+        )
+        self.account_name = account_name
+        self._fav_letter = fav_letter
+        self.sessions_dir = sessions_dir
+
+        if read_session_file:
+            self.read_from_session_file(f"{sessions_dir}/{self.account_name}.hl")
+
+    # endregion
+    ###########################################################
+    # region info endpoints
+    async def get_trader_positions_info(
+        self,
+        uid: int | str,
+    ) -> TraderPositionsInfoResponse:
+        payload = {
+            "type": "clearinghouseState",
+            "user": f"{uid}",
+        }
+        headers = self.get_headers()
+        return await self.invoke_post(
+            f"{self.hyperliquid_api_base_host}/info",
+            headers=headers,
+            content=payload,
+            model=TraderPositionsInfoResponse,
+        )
+
+    #endregion
+    ###########################################################
+    # region another-thing
+    # async def get_another_thing_info(self, uid: int) -> AnotherThingInfoResponse:
+    #     payload = {
+    #         "uid": uid,
+    #     }
+    #     headers = self.get_headers()
+    #     return await self.invoke_post(
+    #         f"{self.hyperliquid_api_base_url}/another-thing/info",
+    #         headers=headers,
+    #         content=payload,
+    #         model=CopyTraderInfoResponse,
+    #     )
+
+    # endregion
+    ###########################################################
+    # region client helper methods
+    def get_headers(self, payload=None, needs_auth: bool = False) -> dict:
+        the_headers = {
+            # "Host": self.hyperliquid_api_base_host,
+            "Content-Type": "application/json",
+            "Accept": "application/json",
+            "Accept-Encoding": "gzip, deflate, br, zstd",
+            "User-Agent": self.user_agent,
+            "Connection": "close",
+            "appsiteid": "0",
+        }
+
+        if self.x_requested_with:
+            the_headers["X-Requested-With"] = self.x_requested_with
+
+        if needs_auth:
+            the_headers["Authorization"] = f"Bearer {self.authorization_token}"
+        return the_headers
+
+    async def invoke_get(
+        self,
+        url: str,
+        headers: dict | None = None,
+        params: dict | None = None,
+        model: Type[HyperLiquidApiResponse] | None = None,
+        parse_float=Decimal,
+    ) -> "HyperLiquidApiResponse":
+        """
+        Invokes the specific request to the specific url with the specific params and headers.
+        """
+        response = await self.httpx_client.get(
+            url=url,
+            headers=headers,
+            params=params,
+        )
+        return model.deserialize(response.json(parse_float=parse_float))
+
+    async def invoke_post(
+        self,
+        url: str,
+        headers: dict | None = None,
+        params: dict | None = None,
+        content: dict | str | bytes = "",
+        model: Type[HyperLiquidApiResponse] | None = None,
+        parse_float=Decimal,
+    ) -> "HyperLiquidApiResponse":
+        """
+        Invokes the specific request to the specific url with the specific params and headers.
+        """
+
+        if isinstance(content, dict):
+            content = json.dumps(content, separators=(",", ":"), sort_keys=True)
+
+        response = await self.httpx_client.post(
+            url=url,
+            headers=headers,
+            params=params,
+            content=content,
+        )
+        if not model:
+            return response.json()
+
+        return model.deserialize(response.json(parse_float=parse_float))
+
+    async def aclose(self) -> None:
+        await self.httpx_client.aclose()
+        logger.info("HyperLiquidClient closed")
+        return True
+
+    def read_from_session_file(self, file_path: str) -> None:
+        """
+        Reads from session file; if it doesn't exist, creates it.
+        """
+        # check if path exists
+        target_path = Path(file_path)
+        if not target_path.exists():
+            return self._save_session_file(file_path=file_path)
+
+        aes = AESCipher(key=f"bf_{self.account_name}_bf", fav_letter=self._fav_letter)
+        content = aes.decrypt(target_path.read_text()).decode("utf-8")
+        json_data: dict = json.loads(content)
+
+        self.authorization_token = json_data.get(
+            "authorization_token",
+            self.authorization_token,
+        )
+        self.user_agent = json_data.get("user_agent", self.user_agent)
+
+    def _save_session_file(self, file_path: str) -> None:
+        """
+        Saves current information to the session file.
+        """
+
+        json_data = {
+            "authorization_token": self.authorization_token,
+            "user_agent": self.user_agent,
+        }
+        aes = AESCipher(key=f"bf_{self.account_name}_bf", fav_letter=self._fav_letter)
+        target_path = Path(file_path)
+        target_path.write_text(aes.encrypt(json.dumps(json_data)))
+
+    # endregion
+    ###########################################################

trd_utils/exchanges/hyperliquid/hyperliquid_types.py

@@ -0,0 +1,109 @@
+from decimal import Decimal
+from trd_utils.types_helper import BaseModel
+
+
+###########################################################
+
+
+# region Common types
+
+
+class HyperLiquidApiResponse(BaseModel):
+    time: int = None
+
+
+# endregion
+
+###########################################################
+
+
+# region info types
+
+
+class CumFundingInfo(BaseModel):
+    all_time: str = None
+    since_open: str = None
+    since_change: str = None
+
+
+class LeverageInfo(BaseModel):
+    type: str = None
+    value: int = None
+
+
+class PositionInfo(BaseModel):
+    coin: str = None
+    szi: Decimal = None
+    leverage: LeverageInfo = None
+    entry_px: Decimal = None
+    position_value: Decimal = None
+    unrealized_pnl: Decimal = None
+    return_on_equity: Decimal = None
+    liquidation_px: Decimal = None
+    margin_used: Decimal = None
+    max_leverage: int = None
+    cum_funding: CumFundingInfo = None
+
+    def get_side(self) -> str:
+        if self.szi > 0:
+            return "LONG"
+        elif self.szi < 0:
+            return "SHORT"
+        return "UNKNOWN_SIDE"
+
+    def get_position_id(self) -> str:
+        """
+        As far as I know, the API endpoint does not return the position id,
+        maybe it only returns it to the account owner?
+        In any case, we will have to somehow fake it in order to be able to compare
+        it with other positions...
+        """
+        return (
+            f"{self.coin}-{self.leverage.value}{self.entry_px}"
+        ).encode("utf-8").hex()
+
+    def get_leverage(self) -> str:
+        return f"{self.leverage.value}x ({self.leverage.type})"
+
+    def __repr__(self):
+        return (
+            f"{self.get_side()} {self.get_leverage()} {self.coin} "
+            f"Margin: {self.margin_used}, PNL: {self.unrealized_pnl}"
+        )
+
+    def __str__(self):
+        return self.__repr__()
+
+
+class AssetPosition(BaseModel):
+    type: str = None
+    position: PositionInfo = None
+
+    def __repr__(self):
+        return f"{self.position}; {self.type}"
+
+    def __str__(self):
+        return self.__str__()
+    
+    def get_position_id(self) -> str:
+        return self.position.get_position_id()
+
+
+class MarginSummaryInfo(BaseModel):
+    account_value: Decimal = None
+    total_ntl_pos: Decimal = None
+    total_raw_usd: Decimal = None
+    total_margin_used: Decimal = None
+
+
+class TraderPositionsInfoResponse(BaseModel):
+    margin_summary: MarginSummaryInfo = None
+    cross_margin_summary: MarginSummaryInfo = None
+    cross_maintenance_margin_used: Decimal = None
+    withdrawable: Decimal = None
+    asset_positions: list[AssetPosition] = None
+
+
+# endregion
+
+###########################################################

trd_utils/types_helper/base_model.py

@@ -1,3 +1,4 @@
+import datetime
 from decimal import Decimal
 import json
 from typing import (
@@ -7,6 +8,8 @@ from typing import (
     get_args as get_type_args,
 )
 
+import dateutil.parser
+
 from trd_utils.html_utils.html_formats import camel_to_snake
 
 # Whether to use ultra-list instead of normal python list or not.
@@ -241,6 +244,14 @@ class BaseModel:
 
                 if ULTRA_LIST_ENABLED and isinstance(value, list):
                     value = convert_to_ultra_list(value)
+            elif expected_type is datetime.datetime and isinstance(value, str):
+                try:
+                    value = dateutil.parser.parse(value)
+                except Exception as ex:
+                    raise ValueError(
+                        f"Failed to parse the string as datetime: {value}"
+                        f" Are you sure it's in correct format? inner error: {ex}"
+                    )
 
             # Type checking
             elif not (is_any_type(expected_type) or isinstance(value, expected_type)):

{trd_utils-0.0.13.dist-info → trd_utils-0.0.15.dist-info}/METADATA

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

trd_utils-0.0.15.dist-info/RECORD

@@ -0,0 +1,29 @@
+trd_utils/__init__.py,sha256=tth9x7eIK8zwa9EZR2wIczpeBj0qNJRjG8svFe9CfmE,25
+trd_utils/cipher/__init__.py,sha256=V05KNuzQwCic-ihMVHlC8sENaJGc3I8MCb4pg4849X8,1765
+trd_utils/common_utils/float_utils.py,sha256=W-jv7nzjl88xwGB6gsEXmDDhF6DseOrrVT2qx7OvyCo,266
+trd_utils/exchanges/README.md,sha256=UwkpsfcoLCJaMvJe4yBsFkDpf8P6DOLYhtybb6xWMLc,6738
+trd_utils/exchanges/__init__.py,sha256=ghL9RKX76Fr6xhtZ6QEBwq5GCg0A3HRZMvsgD-BNnus,426
+trd_utils/exchanges/base_types.py,sha256=NkgTw81oAUG0BMWHOS_kMOBoR17N9N1FQaXVvwuWhvQ,1417
+trd_utils/exchanges/blofin/__init__.py,sha256=dQkY9aSbI5fZJDOSbkrbrbpHSbWbJjLEmjpkXxDMDD4,74
+trd_utils/exchanges/blofin/blofin_client.py,sha256=TWeo90mubIzfxIfRRX8gGT7EE_Ye6EShYxXrxKLK1oU,12092
+trd_utils/exchanges/blofin/blofin_types.py,sha256=ejBgJeGrbqVrLIJSZ8UZQIuIxhlDOVm1UOJFBI_qvJg,4055
+trd_utils/exchanges/bx_ultra/__init__.py,sha256=8Ssy-eOemQR32Nv1-FoPHm87nRqRO4Fm2PU5GHEFKfQ,80
+trd_utils/exchanges/bx_ultra/bx_types.py,sha256=muHLa9lEjIOIDLQCb6xdyxSoQiIMSHErVe0NCoAS-RI,31017
+trd_utils/exchanges/bx_ultra/bx_ultra_client.py,sha256=UtWbS__FYyYbYgGvxIrpIkuXLaD4nppP_AyEZWOe5ec,22591
+trd_utils/exchanges/bx_ultra/bx_utils.py,sha256=PwapomwDW33arVmKIDj6cL-aP0ptu4BYy_lOCqSAPOo,1392
+trd_utils/exchanges/exchange_base.py,sha256=-cphxYRbj_DTls2a_HsYMSsutAVCIxI_2lcOdwHGBZE,3330
+trd_utils/exchanges/hyperliquid/README.md,sha256=-qaxmDt_9NTus2xRuzyFGkKgYDWgWk7ufHVTSkyn3t4,105
+trd_utils/exchanges/hyperliquid/__init__.py,sha256=mgrug9TELB1K4T0QVynYzz4QDGR850_CKJLvjgAUY1k,90
+trd_utils/exchanges/hyperliquid/hyperliquid_client.py,sha256=BZe7GZ_Fcxsl3doapvTnfXibwidF5TesZY6dQU16QUs,6245
+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
+trd_utils/tradingview/__init__.py,sha256=H0QYb-O5qvy7qC3yswtlcSWLmeBnaS6oJ3JtjvmaV_Y,154
+trd_utils/tradingview/tradingview_client.py,sha256=g_eWYaCRQAL8Kvd-r6AnAdbH7Jha6C_GAyCuxh-RQUU,3917
+trd_utils/tradingview/tradingview_types.py,sha256=z21MXPVdWHAduEl3gSeMIRhxtBN9yK-jPYHfZSMIbSA,6144
+trd_utils/types_helper/__init__.py,sha256=VlEXDzOyn6fYH-dE86EGJ6u_el08QvdyOtJkj-0EAVA,65
+trd_utils/types_helper/base_model.py,sha256=uy3s_AzMBxCVQEIMQYZZw9a5go327oOEGIl1iIZP-gs,10600
+trd_utils-0.0.15.dist-info/LICENSE,sha256=J1EP2xt87RjjmsTV1jTjHDQMLIM9FjdwEftTpw8hyv4,1067
+trd_utils-0.0.15.dist-info/METADATA,sha256=eI7bHdiO4nCbVmy-5CU81hyt_Tej_mtSfV89aiccL74,1095
+trd_utils-0.0.15.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+trd_utils-0.0.15.dist-info/RECORD,,

trd_utils-0.0.13.dist-info/RECORD

@@ -1,23 +0,0 @@
-trd_utils/__init__.py,sha256=ksSTwj4RO6vrwFfVs_ChoS8hAYDemQDbl8pB-dXIwV0,25
-trd_utils/cipher/__init__.py,sha256=V05KNuzQwCic-ihMVHlC8sENaJGc3I8MCb4pg4849X8,1765
-trd_utils/common_utils/float_utils.py,sha256=W-jv7nzjl88xwGB6gsEXmDDhF6DseOrrVT2qx7OvyCo,266
-trd_utils/exchanges/__init__.py,sha256=SQJt5cIXh305miWuDumkOLZHzqDUyOqSmlhTT9Xc9RY,180
-trd_utils/exchanges/blofin/__init__.py,sha256=dQkY9aSbI5fZJDOSbkrbrbpHSbWbJjLEmjpkXxDMDD4,74
-trd_utils/exchanges/blofin/blofin_client.py,sha256=SoA272BtqvG8FpxZYpwWx-flJxHEm1-qVMzklmDYZkQ,11611
-trd_utils/exchanges/blofin/blofin_types.py,sha256=8uTJEMYL3Tq3Q_-yAZ4naGKQdQCgyjVn7bE1GRIr8kA,3845
-trd_utils/exchanges/bx_ultra/__init__.py,sha256=8Ssy-eOemQR32Nv1-FoPHm87nRqRO4Fm2PU5GHEFKfQ,80
-trd_utils/exchanges/bx_ultra/bx_types.py,sha256=FiJish58XpF6_vDRWxvpBVlPwXjC7uzK5K7CaA6Y8AI,25217
-trd_utils/exchanges/bx_ultra/bx_ultra_client.py,sha256=4Zsybe7lzB7qSvOByp8KdoVvFcOAnFuStJJQuGWT6po,21164
-trd_utils/exchanges/bx_ultra/bx_utils.py,sha256=PwapomwDW33arVmKIDj6cL-aP0ptu4BYy_lOCqSAPOo,1392
-trd_utils/exchanges/exchange_base.py,sha256=SQERi-z9nvDAzuM4oZ3_v-wYWiw_eZV75jmAL2E4MG4,1976
-trd_utils/html_utils/__init__.py,sha256=1WWs8C7JszRjTkmzIRLHpxWECHur_DrulTPGIeX88oM,426
-trd_utils/html_utils/html_formats.py,sha256=unKsvOiiDmYTTaM0DYZEUNLEUzWQKKrqASJXvY54kvU,2299
-trd_utils/tradingview/__init__.py,sha256=H0QYb-O5qvy7qC3yswtlcSWLmeBnaS6oJ3JtjvmaV_Y,154
-trd_utils/tradingview/tradingview_client.py,sha256=g_eWYaCRQAL8Kvd-r6AnAdbH7Jha6C_GAyCuxh-RQUU,3917
-trd_utils/tradingview/tradingview_types.py,sha256=z21MXPVdWHAduEl3gSeMIRhxtBN9yK-jPYHfZSMIbSA,6144
-trd_utils/types_helper/__init__.py,sha256=VlEXDzOyn6fYH-dE86EGJ6u_el08QvdyOtJkj-0EAVA,65
-trd_utils/types_helper/base_model.py,sha256=YFaZFVgLe49YdDVEcF1ezvGeofei0rSWPLLkc-lHT0M,10144
-trd_utils-0.0.13.dist-info/LICENSE,sha256=J1EP2xt87RjjmsTV1jTjHDQMLIM9FjdwEftTpw8hyv4,1067
-trd_utils-0.0.13.dist-info/METADATA,sha256=tgfIzjF3WSJ7Yd1cnL5SEjT3Lhra5xlJiLP271Cmp3g,1095
-trd_utils-0.0.13.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-trd_utils-0.0.13.dist-info/RECORD,,