hyperquant 0.83__tar.gz → 0.85__tar.gz

{hyperquant-0.83 → hyperquant-0.85}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperquant
-Version: 0.83
+Version: 0.85
 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-0.83 → hyperquant-0.85}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "hyperquant"
-version = "0.83"
+version = "0.85"
 description = "A minimal yet hyper-efficient backtesting framework for quantitative trading"
 authors = [
     { name = "MissinA", email = "1421329142@qq.com" }

{hyperquant-0.83 → hyperquant-0.85}/src/hyperquant/broker/coinw.py

@@ -52,6 +52,7 @@ class Coinw:
         self,
         update_type: Literal[
             "detail",
+            "ticker",
             "orders",
             "position",
             "balance",
@@ -67,6 +68,7 @@ class Coinw:
         """刷新本地缓存，使用 CoinW REST API。
 
         - detail: ``GET /v1/perpum/instruments`` （公共）
+        - ticker: ``GET /v1/perpumPublic/tickers`` （公共）
         - orders: ``GET /v1/perpum/orders/open`` （私有，需要 ``instrument``）
         - position: ``GET /v1/perpum/positions`` （私有，需要 ``instrument``）
         - balance: ``GET /v1/perpum/account/getUserAssets`` （私有）
@@ -75,6 +77,7 @@ class Coinw:
         requests: list[Any] = []
 
         include_detail = update_type in {"detail", "all"}
+        include_ticker = update_type in {"ticker", "all"}
         include_orders = update_type in {"orders", "all"}
         include_position = update_type in {"position", "all"}
         include_balance = update_type in {"balance", "all"}
@@ -82,6 +85,9 @@ class Coinw:
         if include_detail:
             requests.append(self.client.get(f"{self.rest_api}/v1/perpum/instruments"))
 
+        if include_ticker:
+            requests.append(self.client.get(f"{self.rest_api}/v1/perpumPublic/tickers"))
+
         if include_orders:
             if not instrument:
                 raise ValueError("instrument is required when updating orders")
@@ -299,7 +305,7 @@ class Coinw:
         self,
         pair_codes: Sequence[str] | str,
         *,
-        depth_limit: int | None = None,
+        depth_limit: int | None = 1,
         biz: str = "futures",
     ) -> pybotters.ws.WebSocketApp:
         """订阅 ``type=depth`` 订单簿数据，批量控制发送频率。"""

{hyperquant-0.83 → hyperquant-0.85}/src/hyperquant/broker/models/coinw.py

@@ -142,6 +142,55 @@ class Detail(DataStore):
             self._insert(items)
 
 
+class Ticker(DataStore):
+    """CoinW 24h 交易摘要数据存储。
+
+    文档: https://www.coinw.com/api-doc/futures-trading/market/get-last-trade-summary-of-all-instruments
+    """
+
+    _KEYS = ["name"]
+
+    @staticmethod
+    def _normalize(entry: dict[str, Any]) -> dict[str, Any] | None:
+        instrument = entry.get("instrument") or entry.get("symbol") or entry.get("pairCode")
+        if not instrument:
+            return None
+        normalized = dict(entry)
+        normalized["instrument"] = str(instrument).upper()
+        return normalized
+
+    def _onresponse(self, data: Any) -> None:
+        if isinstance(data, dict):
+            entries = data.get("data") or []
+        else:
+            entries = data
+
+        self._update(entries)
+
+    def _on_message(self, msg: dict[str, Any]) -> None:
+        data = msg.get("data")
+        entries: list[dict[str, Any]] = []
+        if isinstance(data, list):
+            entries = data
+        elif isinstance(data, dict):
+            entries = data.get("data") or data.get("tickers") or []
+
+        items: list[dict[str, Any]] = []
+        for entry in entries:
+            if not isinstance(entry, dict):
+                continue
+            normalized = self._normalize(entry)
+            if normalized:
+                items.append(normalized)
+
+        if not items:
+            return
+
+        instruments = [{"instrument": item["instrument"]} for item in items]
+        self._delete(instruments)
+        self._insert(items)
+
+
 class Orders(DataStore):
     """CoinW 当前订单数据存储。"""
 
@@ -386,6 +435,7 @@ class CoinwFuturesDataStore(DataStoreCollection):
     def _init(self) -> None:
         self._create("book", datastore_class=Book)
         self._create("detail", datastore_class=Detail)
+        self._create("ticker", datastore_class=Ticker)
         self._create("orders", datastore_class=Orders)
         self._create("position", datastore_class=Position)
         self._create("balance", datastore_class=Balance)
@@ -400,6 +450,8 @@ class CoinwFuturesDataStore(DataStoreCollection):
             self.position._on_message(msg)
         elif msg_type == "assets":
             self.balance._on_message(msg)
+        elif msg_type == "ticker":
+            self.ticker._on_message(msg)
 
     async def initialize(self, *aws: Awaitable[aiohttp.ClientResponse]) -> None:
         for fut in asyncio.as_completed(aws):
@@ -407,6 +459,8 @@ class CoinwFuturesDataStore(DataStoreCollection):
             data = await res.json()
             if res.url.path == "/v1/perpum/instruments":
                 self.detail._onresponse(data)
+            elif res.url.path == "/v1/perpumPublic/tickers":
+                self.ticker._onresponse(data)
             elif res.url.path == "/v1/perpum/orders/open":
                 self.orders._onresponse(data)
             elif res.url.path == "/v1/perpum/positions":
@@ -512,6 +566,31 @@ class CoinwFuturesDataStore(DataStoreCollection):
 
         return self._get("detail", Detail)
 
+    @property
+    def ticker(self) -> Ticker:
+        """24小时交易摘要数据流。
+        
+        .. code:: json
+
+            {
+                'fair_price': 97072.4,
+                'max_leverage': 125,
+                'total_volume': 0.003,
+                'price_coin': 'btc',
+                'contract_id': 1,
+                'base_coin': 'btc',
+                'high': 98001.5,
+                'rise_fall_rate': 0.012275,
+                'low': 95371.4,
+                'name': 'BTCUSDT',
+                'contract_size': 0.001,
+                'quote_coin': 'usdt',
+                'last_price': 97072.4
+            }
+        
+        """
+        return self._get("ticker", Ticker)
+
     @property
     def orders(self) -> Orders:
         """当前订单数据流。

{hyperquant-0.83 → hyperquant-0.85}/tests/test_coinw.py

@@ -7,15 +7,16 @@ import pybotters
 from hyperquant.broker.coinw import Coinw
 
 
-async def test_detail() -> None:
+async def test_update() -> None:
     """Fetch instrument metadata via REST."""
     async with pybotters.Client() as client:
         async with Coinw(client) as cw:
-            detail = cw.store.detail.find({
-                'symbol': 'SOL_USDT'
-            })
-            print(detail)
-            
+            # detail = cw.store.detail.find({
+            #     'symbol': 'SOL_USDT'
+            # })
+            # print(detail)
+            await cw.update('ticker')
+            print(cw.store.ticker.find())
 
 
 async def test_update_private() -> None:
@@ -208,4 +209,4 @@ async def test_order_sync_polling() -> None:
 
 
 if __name__ == "__main__":
-    asyncio.run(test_order_sync_polling())
+    asyncio.run(test_update())

{hyperquant-0.83 → hyperquant-0.85}/uv.lock

@@ -662,7 +662,7 @@ wheels = [
 
 [[package]]
 name = "hyperquant"
-version = "0.82"
+version = "0.84"
 source = { editable = "." }
 dependencies = [
     { name = "aiohttp" },