update packachore(deps): upgrade core dependencies to latest versions

- aiohttp: 3.12.13 → 3.12.15 (HTTP client improvements)
- build: 1.2.2 → 1.3.0 (build system enhancements)
- multidict: 6.6.3 → 6.6.4 (performance improvements)
- pydantic: 2.0.0+ → 2.11.7 (validation framework updates)
- pre-commit: 4.2.0 → 4.3.0 (code quality tooling)
- pyright: 1.1.402 → 1.1.404 (type checking improvements)
- pytest-asyncio: 1.0.0 → 1.1.0 (async testing enhancements)
- ruff: 0.12.2 → 0.12.10 (linting and formatting improvements)

All tests pass with updated dependencies. Updated pre-commit
configuration to use new tool versions.ges.

chore(deps): upgrade core dependencies to latest versions

- aiohttp: 3.12.13 → 3.12.15 (HTTP client improvements)
- build: 1.2.2 → 1.3.0 (build system enhancements)
- multidict: 6.6.3 → 6.6.4 (performance improvements)
- pydantic: 2.0.0+ → 2.11.7 (validation framework updates)
- pre-commit: 4.2.0 → 4.3.0 (code quality tooling)
- pyright: 1.1.402 → 1.1.404 (type checking improvements)
- pytest-asyncio: 1.0.0 → 1.1.0 (async testing enhancements)
- ruff: 0.12.2 → 0.12.10 (linting and formatting improvements)

All tests pass with updated dependencies. Updated pre-commit
configuration to use new tool versions.

Author: doubledare704

.pre-commit-config.yaml

@@ -12,13 +12,13 @@ repos:
     -   id: requirements-txt-fixer
 
 -   repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.12.2
+    rev: v0.12.10
     hooks:
     -   id: ruff
         args: [--fix, --exit-non-zero-on-fix]
     -   id: ruff-format
 
 -   repo: https://github.com/RobertCraigie/pyright-python
-    rev: v1.1.402
+    rev: v1.1.404
     hooks:
     -   id: pyright

README.md

@@ -6,9 +6,13 @@ Async Python client for WhiteBit API
 
 * [Private http V4 API](https://github.com/whitebit-exchange/api-docs/blob/f7ca495281ade44f9f075a91c2e55d5da32a99fd/Private/http-trade-v4.md)
 * [Public WS API](https://github.com/whitebit-exchange/api-docs/blob/master/Public/websocket.md)
+  * Enhanced WebSocket events with `event_time` and `update_id` metadata
+  * BookTicker WebSocket stream for real-time best bid/ask prices
+  * Market depth subscriptions with enhanced metadata support
 * [Public http v1](https://github.com/whitebit-exchange/api-docs/blob/main/docs/Public/http-v1.md)
 * [Public http v2](https://github.com/whitebit-exchange/api-docs/blob/main/docs/Public/http-v2.md)
 * [Public http v4](https://github.com/whitebit-exchange/api-docs/blob/main/docs/Public/http-v4.md)
+  * Funding history endpoint for futures markets
 * Webhook support with examples
 * Rate limiting
 * Type hints
@@ -41,6 +45,62 @@ async def main():
 asyncio.run(main())
 ```
 
+### New Features in v0.3.0
+
+#### BookTicker WebSocket Stream
+
+```python
+import asyncio
+from aiowhitebit.clients.websocket import PublicWebSocketClient, SubscribeRequest
+
+async def bookticker_example():
+    client = PublicWebSocketClient()
+
+    # Subscribe to BookTicker stream
+    response = await client.bookticker_subscribe("BTC_USDT")
+    print(f"Subscribed: {response}")
+
+    # Unsubscribe from BookTicker stream
+    response = await client.bookticker_unsubscribe("BTC_USDT")
+    print(f"Unsubscribed: {response}")
+
+    await client.close()
+
+asyncio.run(bookticker_example())
+```
+
+#### Funding History for Futures Markets
+
+```python
+import asyncio
+from aiowhitebit.clients.public import PublicV4Client
+
+async def funding_history_example():
+    client = PublicV4Client()
+
+    # Get funding rate history for BTC_USDT futures
+    history = await client.get_funding_history("BTC_USDT")
+
+    for item in history.result:
+        print(f"Time: {item.timestamp}, Rate: {item.funding_rate}")
+
+asyncio.run(funding_history_example())
+```
+
+#### Enhanced WebSocket Events with Metadata
+
+All WebSocket events now include optional `event_time` and `update_id` fields for better tracking and synchronization:
+
+```python
+# WebSocket responses now include metadata
+{
+    "method": "depth_update",
+    "params": {...},
+    "event_time": 1640995200000,  # Event timestamp
+    "update_id": 12345           # Unique update identifier
+}
+```
+
 ## Documentation
 
 For detailed documentation and examples, visit our [GitHub repository](https://github.com/doubledare704/aiowhitebit).

aiowhitebit/__init__.py

@@ -5,4 +5,4 @@
 """
 
 # Version information
-__version__ = "0.2.5"
+__version__ = "0.3.0"

aiowhitebit/clients/public/v4.py

@@ -14,6 +14,7 @@
     Depth,
     Fee,
     FeeResponse,
+    FundingHistoryResponse,
     FuturesMarkets,
     MaintenanceStatus,
     MarketActivity,
@@ -264,3 +265,30 @@ async def get_mining_pool_overview(self) -> MiningPoolOverview:
                 - Recent blocks
         """
         return await self._make_request(APIEndpoints.MINING_POOL, converter=lambda x: MiningPoolOverview(**x))
+
+    @rate_limit(limit=2000, window=10.0)
+    async def get_funding_history(self, market: str) -> FundingHistoryResponse:
+        """Get funding rate history for a futures market.
+
+        Args:
+            market: Market symbol (e.g., "BTC_USDT")
+
+        Returns:
+            FundingHistoryResponse: List of funding rate history items containing:
+                - Timestamp of the funding rate
+                - Funding rate value
+
+        Raises:
+            WhitebitValidationError: If the market parameter is invalid
+
+        Example:
+            ```python
+            client = PublicV4Client()
+            history = await client.get_funding_history("BTC_USDT")
+            for item in history.result:
+                print(f"Time: {item.timestamp}, Rate: {item.funding_rate}")
+            ```
+        """
+        validate_market(market)
+        endpoint = APIEndpoints.FUNDING_HISTORY_V4.format(market=market)
+        return await self._make_request(endpoint, converter=lambda x: FundingHistoryResponse(**x))

aiowhitebit/clients/websocket/public.py

@@ -233,6 +233,40 @@ async def market_depth(self, market: str, limit: int, intervals: str) -> WSRespo
         """
         return await self.base_ws_requester(WSRequest(method="depth_request", params=[market, limit, intervals]))
 
+    async def bookticker_subscribe(self, market: str) -> WSResponse:
+        """Subscribe to BookTicker stream for a market.
+
+        Args:
+            market: Market (e.g. BTC_USDT)
+
+        Returns:
+            WebSocket response confirming subscription
+
+        Example:
+            ```python
+            client = PublicWebSocketClient()
+            response = await client.bookticker_subscribe("BTC_USDT")
+            ```
+        """
+        return await self.base_ws_requester(WSRequest(method="bookTicker_subscribe", params=[market]))
+
+    async def bookticker_unsubscribe(self, market: str) -> WSResponse:
+        """Unsubscribe from BookTicker stream for a market.
+
+        Args:
+            market: Market (e.g. BTC_USDT)
+
+        Returns:
+            WebSocket response confirming unsubscription
+
+        Example:
+            ```python
+            client = PublicWebSocketClient()
+            response = await client.bookticker_unsubscribe("BTC_USDT")
+            ```
+        """
+        return await self.base_ws_requester(WSRequest(method="bookTicker_unsubscribe", params=[market]))
+
     async def close(self):
         """Close the WebSocket connection.
 

aiowhitebit/clients/websocket/subscriber.py

@@ -151,6 +151,48 @@ def depth_subscribe(
             id=next(id_gen),
         ).model_dump()
 
+    @staticmethod
+    def bookticker_subscribe(market: str) -> dict:
+        """Build a BookTicker subscribe request.
+
+        Args:
+            market: Market (e.g. BTC_USDT)
+
+        Returns:
+            Subscribe request
+
+        Example:
+            ```python
+            request = SubscribeRequest.bookticker_subscribe("BTC_USDT")
+            ```
+        """
+        return WSRequest(
+            method="bookTicker_subscribe",
+            params=[market],
+            id=next(id_gen),
+        ).model_dump()
+
+    @staticmethod
+    def bookticker_unsubscribe(market: str) -> dict:
+        """Build a BookTicker unsubscribe request.
+
+        Args:
+            market: Market (e.g. BTC_USDT)
+
+        Returns:
+            Unsubscribe request
+
+        Example:
+            ```python
+            request = SubscribeRequest.bookticker_unsubscribe("BTC_USDT")
+            ```
+        """
+        return WSRequest(
+            method="bookTicker_unsubscribe",
+            params=[market],
+            id=next(id_gen),
+        ).model_dump()
+
 
 def ws_subscribe_builder(
     sub_msg: dict,

aiowhitebit/config.py

@@ -23,6 +23,7 @@ class APIEndpoints:
     DEPTH_V4 = "/api/v4/public/orderbook/depth/{market}"  # Corrected URL
     TRADES_V4 = "/api/v4/public/trades/{market}"
     FEE_V4 = "/api/v4/public/fee"
+    FUNDING_HISTORY_V4 = "/api/v4/public/funding-history/{market}"
 
     # V2 endpoints
     MARKET_INFO_V2: Final = "/api/v2/public/markets"

aiowhitebit/models/__init__.py

@@ -34,6 +34,10 @@
     # Add other specific imports from public.v4 module
 )
 from aiowhitebit.models.websocket import (
+    BookTickerData,
+    BookTickerResponse,
+    DepthData,
+    DepthUpdateResponse,
     WSError,
     # Add other specific imports from websocket module
     WSRequest,
@@ -48,8 +52,12 @@
     "BasePublicV2Response",
     "BaseResponse",
     "BaseWebSocketResponse",
+    "BookTickerData",
+    "BookTickerResponse",
     "CreateLimitOrderRequest",
     "CreateOrderResponse",
+    "DepthData",
+    "DepthUpdateResponse",
     "ExecutedOrdersResponse",
     "MarketActivity",
     "MarketInfo",

aiowhitebit/models/base.py

@@ -1,6 +1,6 @@
 """Base models for the WhiteBit API."""
 
-from typing import Any
+from typing import Any, Optional
 
 from pydantic import BaseModel
 
@@ -36,6 +36,12 @@ class BasePrivateResponse(BaseResponse):
 
 
 class BaseWebSocketResponse(BaseModel):
-    """Base model for WebSocket API responses."""
+    """Base model for WebSocket API responses.
 
-    pass
+    Attributes:
+        event_time: Timestamp of the event (optional for backward compatibility)
+        update_id: Unique identifier for each update (optional for backward compatibility)
+    """
+
+    event_time: Optional[int] = None
+    update_id: Optional[int] = None

aiowhitebit/models/public/v4/__init__.py

@@ -11,6 +11,8 @@
     Depth,
     Fee,
     FeeResponse,
+    FundingHistoryItem,
+    FundingHistoryResponse,
     FuturesMarket,
     FuturesMarkets,
     MaintenanceStatus,
@@ -33,6 +35,8 @@
     "Depth",
     "Fee",
     "FeeResponse",
+    "FundingHistoryItem",
+    "FundingHistoryResponse",
     "FuturesMarket",
     "FuturesMarkets",
     "MaintenanceStatus",