oxarchive 0.3.2__tar.gz → 0.3.3__tar.gz

oxarchive-0.3.3/.gitignore

@@ -0,0 +1,78 @@
+# Tests (internal only, not published)
+tests/
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db

{oxarchive-0.3.2 → oxarchive-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oxarchive
-Version: 0.3.2
+Version: 0.3.3
 Summary: Official Python SDK for 0xarchive - Hyperliquid Historical Data API
 Project-URL: Homepage, https://0xarchive.io
 Project-URL: Documentation, https://0xarchive.io/docs/sdks
@@ -28,6 +28,7 @@ Requires-Dist: websockets>=12.0; extra == 'all'
 Provides-Extra: dev
 Requires-Dist: mypy>=1.9.0; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
 Requires-Dist: pytest>=8.0.0; extra == 'dev'
 Requires-Dist: ruff>=0.4.0; extra == 'dev'
 Provides-Extra: websocket

{oxarchive-0.3.2 → oxarchive-0.3.3}/oxarchive/__init__.py

@@ -57,7 +57,7 @@ except ImportError:
     OxArchiveWs = None  # type: ignore
     WsOptions = None  # type: ignore
 
-__version__ = "0.1.0"
+__version__ = "0.3.3"
 
 __all__ = [
     # Client

{oxarchive-0.3.2 → oxarchive-0.3.3}/oxarchive/http.py

@@ -50,13 +50,26 @@ class HttpClient:
         return self._async_client
 
     def close(self) -> None:
-        """Close the HTTP clients."""
+        """Close the HTTP clients.
+
+        Note: This closes the sync client immediately. For the async client,
+        use aclose() instead, or call this from a sync context where you
+        don't need to await the async cleanup.
+        """
         if self._client is not None:
             self._client.close()
             self._client = None
         if self._async_client is not None:
-            # Note: async client should be closed with await
-            pass
+            # Close async client synchronously (will log warning but works)
+            # For proper cleanup, use aclose() in async contexts
+            try:
+                import asyncio
+                loop = asyncio.get_running_loop()
+                loop.create_task(self._async_client.aclose())
+            except RuntimeError:
+                # No running loop, close synchronously (httpx supports this)
+                self._async_client.close()
+            self._async_client = None
 
     async def aclose(self) -> None:
         """Close the async HTTP client."""

{oxarchive-0.3.2 → oxarchive-0.3.3}/oxarchive/types.py

@@ -124,11 +124,17 @@ class Trade(BaseModel):
     start_position: Optional[str] = None
     """Position size before this trade."""
 
-    source: Optional[Literal["s3", "ws", "api"]] = None
-    """Data source."""
+    source: Optional[Literal["s3", "ws", "api", "live"]] = None
+    """Data source: 's3' (historical), 'api' (REST backfill), 'ws' (websocket), 'live' (real-time ingestion)."""
 
     user_address: Optional[str] = None
-    """User's wallet address."""
+    """User's wallet address (for fill-level data)."""
+
+    maker_address: Optional[str] = None
+    """Maker's wallet address (for market-level WebSocket trades)."""
+
+    taker_address: Optional[str] = None
+    """Taker's wallet address (for market-level WebSocket trades)."""
 
 
 # =============================================================================

{oxarchive-0.3.2 → oxarchive-0.3.3}/oxarchive/websocket.py

@@ -123,8 +123,8 @@ StreamCompleteHandler = Callable[[WsChannel, str, int], None]  # channel, coin,
 def _transform_trade(coin: str, raw: dict) -> Trade:
     """Transform raw Hyperliquid trade format to SDK Trade type.
 
-    Raw format: { coin, side, px, sz, time, hash, tid }
-    SDK format: { coin, side, price, size, timestamp, tx_hash, trade_id }
+    Raw WebSocket format: { coin, side, px, sz, time, hash, tid, users: [maker, taker] }
+    SDK format: { coin, side, price, size, timestamp, tx_hash, trade_id, maker_address, taker_address }
     """
     from datetime import datetime
 
@@ -136,6 +136,12 @@ def _transform_trade(coin: str, raw: dict) -> Trade:
     time_ms = raw.get("time")
     timestamp = datetime.utcfromtimestamp(time_ms / 1000).isoformat() + "Z" if time_ms else None
 
+    # Extract maker/taker addresses from users array
+    # WebSocket trades have: users: [maker_address, taker_address]
+    users = raw.get("users", [])
+    maker_address = users[0] if len(users) > 0 else None
+    taker_address = users[1] if len(users) > 1 else None
+
     return Trade(
         coin=raw.get("coin", coin),
         side=raw.get("side", "B"),
@@ -144,6 +150,10 @@ def _transform_trade(coin: str, raw: dict) -> Trade:
         timestamp=timestamp,
         tx_hash=raw.get("hash"),
         trade_id=raw.get("tid"),
+        maker_address=maker_address,
+        taker_address=taker_address,
+        # user_address is for fill-level data (REST API), not market-level WebSocket trades
+        user_address=raw.get("user_address"),
     )
 
 

{oxarchive-0.3.2 → oxarchive-0.3.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "oxarchive"
-version = "0.3.2"
+version = "0.3.3"
 description = "Official Python SDK for 0xarchive - Hyperliquid Historical Data API"
 readme = "README.md"
 license = "MIT"
@@ -38,6 +38,7 @@ websocket = [
 dev = [
     "pytest>=8.0.0",
     "pytest-asyncio>=0.23.0",
+    "pytest-cov>=4.0.0",
     "ruff>=0.4.0",
     "mypy>=1.9.0",
 ]