defistream 1.3.0__py3-none-any.whl → 1.4.1__py3-none-any.whl

defistream/__init__.py

@@ -36,7 +36,7 @@ from .query import (
     QueryBuilder,
 )
 
-__version__ = "1.3.0"
+__version__ = "1.4.1"
 
 __all__ = [
     # Clients

defistream/query.py

@@ -109,14 +109,18 @@ class QueryBuilder:
         self._endpoint = endpoint
         self._params: dict[str, Any] = initial_params or {}
         self._verbose = False
+        self._with_price = False
 
     def _copy_with(self, **updates: Any) -> "QueryBuilder":
         """Create a copy with updated parameters."""
         new_builder = QueryBuilder(self._client, self._endpoint, self._params.copy())
         new_builder._verbose = self._verbose
+        new_builder._with_price = self._with_price
         for key, value in updates.items():
             if key == "verbose":
                 new_builder._verbose = value
+            elif key == "with_price":
+                new_builder._with_price = value
             elif value is not None:
                 new_builder._params[key] = value
         return new_builder
@@ -232,6 +236,11 @@ class QueryBuilder:
         """Include all metadata fields (tx_hash, tx_id, log_index, network, name)."""
         return self._copy_with(verbose=enabled)
 
+    # Price enrichment
+    def with_price(self, enabled: bool = True) -> "QueryBuilder":
+        """Enrich events with USD price data (adds ``price`` and ``value_usd`` columns)."""
+        return self._copy_with(with_price=enabled)
+
     # Build final params
     def _build_params(self) -> dict[str, Any]:
         """Build the final query parameters."""
@@ -240,6 +249,8 @@ class QueryBuilder:
         _validate_mutual_exclusivity(params)
         if self._verbose:
             params["verbose"] = "true"
+        if self._with_price:
+            params["with_price"] = "true"
         return params
 
     # Terminal methods - execute the query
@@ -345,6 +356,7 @@ class QueryBuilder:
             self._params.copy(),
         )
         builder._verbose = self._verbose
+        builder._with_price = self._with_price
         builder._params["group_by"] = group_by
         builder._params["period"] = period
         return builder
@@ -365,9 +377,12 @@ class AggregateQueryBuilder(QueryBuilder):
         """Create a copy preserving aggregate builder type."""
         new_builder = AggregateQueryBuilder(self._client, self._endpoint, self._params.copy())
         new_builder._verbose = self._verbose
+        new_builder._with_price = self._with_price
         for key, value in updates.items():
             if key == "verbose":
                 new_builder._verbose = value
+            elif key == "with_price":
+                new_builder._with_price = value
             elif value is not None:
                 new_builder._params[key] = value
         return new_builder
@@ -449,14 +464,18 @@ class AsyncQueryBuilder:
         self._endpoint = endpoint
         self._params: dict[str, Any] = initial_params or {}
         self._verbose = False
+        self._with_price = False
 
     def _copy_with(self, **updates: Any) -> "AsyncQueryBuilder":
         """Create a copy with updated parameters."""
         new_builder = AsyncQueryBuilder(self._client, self._endpoint, self._params.copy())
         new_builder._verbose = self._verbose
+        new_builder._with_price = self._with_price
         for key, value in updates.items():
             if key == "verbose":
                 new_builder._verbose = value
+            elif key == "with_price":
+                new_builder._with_price = value
             elif value is not None:
                 new_builder._params[key] = value
         return new_builder
@@ -572,6 +591,11 @@ class AsyncQueryBuilder:
         """Include all metadata fields (tx_hash, tx_id, log_index, network, name)."""
         return self._copy_with(verbose=enabled)
 
+    # Price enrichment
+    def with_price(self, enabled: bool = True) -> "AsyncQueryBuilder":
+        """Enrich events with USD price data (adds ``price`` and ``value_usd`` columns)."""
+        return self._copy_with(with_price=enabled)
+
     # Build final params
     def _build_params(self) -> dict[str, Any]:
         """Build the final query parameters."""
@@ -580,6 +604,8 @@ class AsyncQueryBuilder:
         _validate_mutual_exclusivity(params)
         if self._verbose:
             params["verbose"] = "true"
+        if self._with_price:
+            params["with_price"] = "true"
         return params
 
     # Terminal methods - execute the query (async)
@@ -685,6 +711,7 @@ class AsyncQueryBuilder:
             self._params.copy(),
         )
         builder._verbose = self._verbose
+        builder._with_price = self._with_price
         builder._params["group_by"] = group_by
         builder._params["period"] = period
         return builder
@@ -705,9 +732,12 @@ class AsyncAggregateQueryBuilder(AsyncQueryBuilder):
         """Create a copy preserving async aggregate builder type."""
         new_builder = AsyncAggregateQueryBuilder(self._client, self._endpoint, self._params.copy())
         new_builder._verbose = self._verbose
+        new_builder._with_price = self._with_price
         for key, value in updates.items():
             if key == "verbose":
                 new_builder._verbose = value
+            elif key == "with_price":
+                new_builder._with_price = value
             elif value is not None:
                 new_builder._params[key] = value
         return new_builder

{defistream-1.3.0.dist-info → defistream-1.4.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: defistream
-Version: 1.3.0
+Version: 1.4.1
 Summary: Python client for the DeFiStream API
 Project-URL: Homepage, https://defistream.dev
 Project-URL: Documentation, https://docs.defistream.dev
@@ -337,6 +337,35 @@ df = (
 )
 ```
 
+### Price Enrichment
+
+Use `.with_price()` to enrich events with USD price data. This adds `price` (unit price) and `value_usd` (amount × price) columns to individual events. On aggregate endpoints, it produces an `agg_value_usd` (sum) column.
+
+Supported protocols: AAVE, Uniswap, Lido, Stader, ERC20, Native Token.
+
+```python
+# Individual events with price data
+df = (
+    client.aave.deposits()
+    .network("ETH")
+    .block_range(21000000, 21010000)
+    .with_price()
+    .as_df()
+)
+# df now includes 'price' and 'value_usd' columns
+
+# Aggregate with price — adds agg_value_usd column
+df = (
+    client.aave.deposits()
+    .network("ETH")
+    .block_range(21000000, 21100000)
+    .with_price()
+    .aggregate(group_by="time", period="2h")
+    .as_df()
+)
+# df now includes 'agg_value_usd' column
+```
+
 ### Return as DataFrame
 
 ```python
@@ -541,6 +570,7 @@ print(f"Request cost: {client.last_response.request_cost}")
 | `.end_time(ts)` | Set ending time (ISO format or Unix timestamp) |
 | `.time_range(start, end)` | Set both start and end times |
 | `.verbose()` | Include all metadata fields |
+| `.with_price()` | Enrich events with USD price data (`price` and `value_usd` columns) |
 
 ### Protocol-Specific Parameters
 

{defistream-1.3.0.dist-info → defistream-1.4.1.dist-info}/RECORD

@@ -1,11 +1,11 @@
-defistream/__init__.py,sha256=444yPKGSGiJqmgD5CPcgbDyL6OZBAz4WBula-RRbxz4,1224
+defistream/__init__.py,sha256=VwTy9GK84IWHtxN-uHBtbN1c5ecw_u9hEsD0vQ4_MpE,1224
 defistream/client.py,sha256=OZsaa7kgDxWCS37geoTGlp-IFaO3Kn8bm1ghNE9tqB4,13973
 defistream/exceptions.py,sha256=_GxZQ18_YvXFtmNHeddWV8fHPIllHgFeP7fP0CmHF1k,1492
 defistream/models.py,sha256=Zw3DHAISxB6pivKybNzyHXR5IcRwvTZl23DHbjfyKwM,622
 defistream/protocols.py,sha256=lVWtFnZwjyyVjH_9glvFDxVs-bpHlFLXEyIEbEAKN1Q,16174
 defistream/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-defistream/query.py,sha256=mS_ClbpMXRsBpwqL9kDRW50eaXvoarP3xvmItD9MDms,30595
-defistream-1.3.0.dist-info/METADATA,sha256=0A8Q3JBoHYujiLAwyiBdYAlXuZxqwRn10enbmKPoH8w,15856
-defistream-1.3.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-defistream-1.3.0.dist-info/licenses/LICENSE,sha256=72DWAof8dMePfFQmfaswClW5d-sE6k7p-7VpuSKLmU4,1067
-defistream-1.3.0.dist-info/RECORD,,
+defistream/query.py,sha256=vcQ7rvsODZued0ZIqq497cP82nHpuK0GL6Bq0dCJ0bE,31916
+defistream-1.4.1.dist-info/METADATA,sha256=J-A1KXDNOOqokVd1TW2AbZE0yWHaRYjdKt7GAKkHxIU,16752
+defistream-1.4.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+defistream-1.4.1.dist-info/licenses/LICENSE,sha256=72DWAof8dMePfFQmfaswClW5d-sE6k7p-7VpuSKLmU4,1067
+defistream-1.4.1.dist-info/RECORD,,