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

defistream/__init__.py

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

defistream/protocols.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING, Any
 
-from .query import QueryBuilder, AsyncQueryBuilder
+from .query import QueryBuilder, AsyncQueryBuilder, _normalize_multi
 
 if TYPE_CHECKING:
     from .client import BaseClient
@@ -16,25 +16,37 @@ class ERC20Protocol:
     def __init__(self, client: "BaseClient"):
         self._client = client
 
-    def transfers(self, token: str | None = None) -> QueryBuilder:
+    def transfers(self, *tokens: str) -> QueryBuilder:
         """
         Start a query for ERC20 transfer events.
 
         Args:
-            token: Token symbol (USDT, USDC, WETH, etc.) or contract address
+            *tokens: One or more token symbols (USDT, USDC, DAI, etc.) or a
+                single contract address. Multiple tokens are joined as
+                comma-separated symbols (multi-token queries only support
+                known symbol names, not contract addresses).
 
         Returns:
             QueryBuilder for chaining filters
 
         Example:
+            # Single token
             df = (
                 client.erc20.transfers("USDT")
                 .network("ETH")
                 .block_range(21000000, 21010000)
                 .as_df()
             )
+
+            # Multiple tokens
+            df = (
+                client.erc20.transfers("USDT", "USDC", "DAI")
+                .network("ETH")
+                .block_range(21000000, 21010000)
+                .as_df()
+            )
         """
-        params = {"token": token} if token else {}
+        params = {"token": _normalize_multi(*tokens)} if tokens else {}
         return QueryBuilder(self._client, "/erc20/events/transfer", params)
 
 
@@ -261,9 +273,16 @@ class AsyncERC20Protocol:
     def __init__(self, client: "BaseClient"):
         self._client = client
 
-    def transfers(self, token: str | None = None) -> AsyncQueryBuilder:
-        """Start a query for ERC20 transfer events."""
-        params = {"token": token} if token else {}
+    def transfers(self, *tokens: str) -> AsyncQueryBuilder:
+        """Start a query for ERC20 transfer events.
+
+        Args:
+            *tokens: One or more token symbols (USDT, USDC, DAI, etc.) or a
+                single contract address. Multiple tokens are joined as
+                comma-separated symbols (multi-token queries only support
+                known symbol names, not contract addresses).
+        """
+        params = {"token": _normalize_multi(*tokens)} if tokens else {}
         return AsyncQueryBuilder(self._client, "/erc20/events/transfer", params)
 
 

defistream/query.py

@@ -205,9 +205,9 @@ class QueryBuilder:
         return self._copy_with(max_amount=amount)
 
     # ERC20 specific
-    def token(self, symbol: str) -> "QueryBuilder":
-        """Set token symbol or address (ERC20)."""
-        return self._copy_with(token=symbol)
+    def token(self, *symbols: str) -> "QueryBuilder":
+        """Set token symbol(s) or address (ERC20). Accepts multiple known symbols for multi-token queries."""
+        return self._copy_with(token=_normalize_multi(*symbols))
 
     # AAVE specific
     def eth_market_type(self, market_type: str) -> "QueryBuilder":
@@ -545,9 +545,9 @@ class AsyncQueryBuilder:
         return self._copy_with(max_amount=amount)
 
     # ERC20 specific
-    def token(self, symbol: str) -> "AsyncQueryBuilder":
-        """Set token symbol or address (ERC20)."""
-        return self._copy_with(token=symbol)
+    def token(self, *symbols: str) -> "AsyncQueryBuilder":
+        """Set token symbol(s) or address (ERC20). Accepts multiple known symbols for multi-token queries."""
+        return self._copy_with(token=_normalize_multi(*symbols))
 
     # AAVE specific
     def eth_market_type(self, market_type: str) -> "AsyncQueryBuilder":

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: defistream
-Version: 1.2.1
+Version: 1.3.0
 Summary: Python client for the DeFiStream API
 Project-URL: Homepage, https://defistream.dev
 Project-URL: Documentation, https://docs.defistream.dev
@@ -138,6 +138,23 @@ df = (
     .as_df()
 )
 
+# Query multiple tokens at once (known symbols only, not contract addresses)
+df = (
+    client.erc20.transfers("USDT", "USDC", "DAI")
+    .network("ETH")
+    .block_range(21000000, 21010000)
+    .as_df()
+)
+
+# Or set multiple tokens via chain method
+df = (
+    client.erc20.transfers()
+    .token("USDT", "USDC")
+    .network("ETH")
+    .block_range(21000000, 21010000)
+    .as_df()
+)
+
 # Filter by sender
 df = (
     client.erc20.transfers("USDT")
@@ -529,7 +546,7 @@ print(f"Request cost: {client.last_response.request_cost}")
 
 | Method | Protocols | Description |
 |--------|-----------|-------------|
-| `.token(symbol)` | ERC20 | Token symbol (USDT, USDC) or contract address (required) |
+| `.token(*symbols)` | ERC20 | Token symbol(s) (USDT, USDC) or contract address. Accepts multiple known symbols for multi-token queries (multi-value). |
 | `.sender(*addrs)` | ERC20, Native | Filter by sender address (multi-value) |
 | `.receiver(*addrs)` | ERC20, Native | Filter by receiver address (multi-value) |
 | `.involving(*addrs)` | All | Filter by any involved address (multi-value) |

defistream-1.3.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+defistream/__init__.py,sha256=444yPKGSGiJqmgD5CPcgbDyL6OZBAz4WBula-RRbxz4,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-1.2.1.dist-info/RECORD

@@ -1,11 +0,0 @@
-defistream/__init__.py,sha256=jnSTX8AxaD5A8NIp059veFWnMkV9BOSWxgKfI-aau6k,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=5_bYd46lDy-mK6LZ8sTGW0Z2IVH4g0cQ5rBbbOXsw0U,15368
-defistream/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-defistream/query.py,sha256=Pr-zwUCBcjBUkqa1CFzVJmsnZ4DpV29c0_9p1VtfGak,30433
-defistream-1.2.1.dist-info/METADATA,sha256=S-XgsiQCjkgOLElZxcoFWfDSetIFxD17KmWOIwJQ1oM,15406
-defistream-1.2.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-defistream-1.2.1.dist-info/licenses/LICENSE,sha256=72DWAof8dMePfFQmfaswClW5d-sE6k7p-7VpuSKLmU4,1067
-defistream-1.2.1.dist-info/RECORD,,