hyperquant 1.1__py3-none-any.whl → 1.2__py3-none-any.whl

hyperquant/broker/bitmart.py

@@ -510,3 +510,101 @@ class Bitmart:
         if resp.get("success") is False or resp.get("errno") not in (None, "OK"):
             raise ValueError(f"Bitmart cancelOrders error: {resp}")
         return resp
+
+    async def get_leverage(
+        self,
+        *,
+        symbol: str | None = None,
+        contract_id: int | str | None = None,
+    ) -> dict[str, Any]:
+        """
+        获取指定合约的杠杆信息（可通过 contract_id 或 symbol 查询）。
+
+        参数:
+            symbol (str | None): 合约符号，例如 "BTCUSDT"。如果未传入 contract_id，则会自动解析。
+            contract_id (int | str | None): 合约 ID，可直接指定。
+
+        返回:
+            dict[str, Any]: 杠杆信息字典，典型返回结构如下:
+            {
+                "contract_id": 1,
+                "leverage": 96,             # 当前杠杆倍数
+                "open_type": 2,             # 开仓类型 (1=全仓, 2=逐仓)
+                "max_leverage": {
+                    "contract_id": 1,
+                    "leverage": "200",      # 最大可用杠杆倍数
+                    "open_type": 0,
+                    "imr": "0.005",         # 初始保证金率
+                    "mmr": "0.0025",        # 维持保证金率
+                    "value": "0"
+                }
+            }
+
+        异常:
+            ValueError: 当未提供 symbol 或 contract_id，或接口返回错误时抛出。
+
+        示例:
+            data = await bitmart.get_leverage(symbol="BTCUSDT")
+            print(data["leverage"])  # 输出当前杠杆倍数
+        """
+        if contract_id is None:
+            if symbol is not None:
+                contract_id = self.get_contract_id(symbol)
+            if contract_id is None:
+                raise ValueError("Either contract_id or a valid symbol must be provided to get leverage info.")
+        res = await self.client.get(
+            f"{self.forward_api}/v1/ifcontract/getLeverage",
+            params={"contract_id": contract_id},
+        )
+        resp = await res.json()
+        if resp.get("success") is False or resp.get("errno") not in (None, "OK"):
+            raise ValueError(f"Bitmart getLeverage error: {resp}")
+        return resp.get("data")
+
+    async def bind_leverage(
+        self,
+        *,
+        symbol: str | None = None,
+        contract_id: int | str | None = None,
+        leverage: int | str,
+        open_type: Literal[1, 2] = 2,
+    ) -> None:
+        """
+        绑定（设置）指定合约的杠杆倍数。
+
+        参数:
+            symbol (str | None): 合约符号，例如 "BTCUSDT"。若未传入 contract_id，会自动解析。
+            contract_id (int | str | None): 合约 ID，可直接指定。
+            leverage (int | str): 要设置的杠杆倍数，如 20、50、100。
+            open_type (int): 开仓模式，1＝全仓（Cross），2＝逐仓（Isolated）。
+
+        返回:
+            None — 如果接口调用成功，不返回任何内容。
+                   若失败则抛出 ValueError。
+
+        异常:
+            ValueError: 当未提供 symbol 或 contract_id，或接口返回错误时抛出。
+
+        示例:
+            await bitmart.bind_leverage(symbol="BTCUSDT", leverage=50, open_type=2)
+        """
+        if contract_id is None:
+            if symbol is not None:
+                contract_id = self.get_contract_id(symbol)
+            if contract_id is None:
+                raise ValueError("Either contract_id or a valid symbol must be provided to bind leverage.")
+
+        payload = {
+            "contract_id": int(contract_id),
+            "leverage": leverage,
+            "open_type": open_type,
+        }
+
+        res = await self.client.post(
+            f"{self.forward_api}/v1/ifcontract/bindLeverage",
+            json=payload,
+        )
+        resp = await res.json()
+        if resp.get("success") is False or resp.get("errno") not in (None, "OK"):
+            raise ValueError(f"Bitmart bindLeverage error: {resp}")
+        return None

{hyperquant-1.1.dist-info → hyperquant-1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperquant
-Version: 1.1
+Version: 1.2
 Summary: A minimal yet hyper-efficient backtesting framework for quantitative trading
 Project-URL: Homepage, https://github.com/yourusername/hyperquant
 Project-URL: Issues, https://github.com/yourusername/hyperquant/issues

{hyperquant-1.1.dist-info → hyperquant-1.2.dist-info}/RECORD

@@ -6,7 +6,7 @@ hyperquant/logkit.py,sha256=nUo7nx5eONvK39GOhWwS41zNRL756P2J7-5xGzwXnTY,8462
 hyperquant/notikit.py,sha256=x5yAZ_tAvLQRXcRbcg-VabCaN45LUhvlTZnUqkIqfAA,3596
 hyperquant/broker/auth.py,sha256=C8B5-x8Qcaeafm4ZwPCVFR7GRURmHC3CE4_vdg00Qgw,12139
 hyperquant/broker/bitget.py,sha256=X_S0LKZ7FZAEb6oEMr1vdGP1fondzK74BhmNTpRDSEA,9488
-hyperquant/broker/bitmart.py,sha256=gOMh_w22vd0L-rMLLCLvtBDqHpXPKeru6bnd9hx1u-M,17604
+hyperquant/broker/bitmart.py,sha256=wHot_CwaRNituj0Rpn60Kv5bU5YQquDIMPDFzlzbFws,21443
 hyperquant/broker/coinup.py,sha256=eOr8BTRXiTb5tCU2FDmvBdXXgqiwVmCbP5pdeA1ORJ8,20390
 hyperquant/broker/coinw.py,sha256=SnJU0vASh77rfcpMGWaIfTblQSjQk3vjlW_4juYdbcs,17214
 hyperquant/broker/edgex.py,sha256=TqUO2KRPLN_UaxvtLL6HnA9dAQXC1sGxOfqTHd6W5k8,18378
@@ -32,6 +32,6 @@ hyperquant/datavison/_util.py,sha256=92qk4vO856RqycO0YqEIHJlEg-W9XKapDVqAMxe6rbw
 hyperquant/datavison/binance.py,sha256=3yNKTqvt_vUQcxzeX4ocMsI5k6Q6gLZrvgXxAEad6Kc,5001
 hyperquant/datavison/coinglass.py,sha256=PEjdjISP9QUKD_xzXNzhJ9WFDTlkBrRQlVL-5pxD5mo,10482
 hyperquant/datavison/okx.py,sha256=yg8WrdQ7wgWHNAInIgsWPM47N3Wkfr253169IPAycAY,6898
-hyperquant-1.1.dist-info/METADATA,sha256=6HPHF63atspmUAmbE3Gig8F3TwhHFSPe74kPgX2zglQ,4408
-hyperquant-1.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-hyperquant-1.1.dist-info/RECORD,,
+hyperquant-1.2.dist-info/METADATA,sha256=sWjVioqvlZhhPPOx0AiD6t29SR4xXRR56ebM09hhLKM,4408
+hyperquant-1.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+hyperquant-1.2.dist-info/RECORD,,