intentkit 0.5.0__py3-none-any.whl → 0.5.2__py3-none-any.whl

intentkit/skills/cryptocompare/fetch_price.py

@@ -0,0 +1,99 @@
+"""Tool for fetching cryptocurrency prices via CryptoCompare API."""
+
+import logging
+from typing import List, Type
+
+from langchain_core.runnables import RunnableConfig
+from pydantic import BaseModel, Field
+
+from intentkit.skills.cryptocompare.base import CryptoCompareBaseTool, CryptoPrice
+
+logger = logging.getLogger(__name__)
+
+
+class CryptoCompareFetchPriceInput(BaseModel):
+    """Input for CryptoCompareFetchPrice tool."""
+
+    from_symbol: str = Field(
+        ...,
+        description="Base cryptocurrency symbol to get prices for (e.g., 'BTC', 'ETH')",
+    )
+    to_symbols: List[str] = Field(
+        ...,
+        description="List of target currencies (fiat or crypto) (e.g., ['USD', 'EUR', 'JPY'])",
+    )
+
+
+class CryptoCompareFetchPrice(CryptoCompareBaseTool):
+    """Tool for fetching cryptocurrency prices from CryptoCompare.
+
+    This tool uses the CryptoCompare API to retrieve real-time cryptocurrency price data
+    with multi-currency support. Provide a base currency (e.g., 'BTC', 'ETH') and a list
+    of target currencies (e.g., ['USD', 'EUR', 'JPY']) to get current exchange rates.
+
+    Attributes:
+        name: The name of the tool.
+        description: A description of what the tool does.
+        args_schema: The schema for the tool's input arguments.
+    """
+
+    name: str = "cryptocompare_fetch_price"
+    description: str = (
+        "Fetch real-time cryptocurrency price data with multi-currency support"
+    )
+    args_schema: Type[BaseModel] = CryptoCompareFetchPriceInput
+
+    async def _arun(
+        self,
+        from_symbol: str,
+        to_symbols: List[str],
+        config: RunnableConfig,
+        **kwargs,
+    ) -> List[CryptoPrice]:
+        """Async implementation of the tool to fetch cryptocurrency prices.
+
+        Args:
+            from_symbol: Base cryptocurrency symbol to get prices for (e.g., 'BTC', 'ETH')
+            to_symbols: List of target currencies (fiat or crypto) (e.g., ['USD', 'EUR', 'JPY'])
+            config: The configuration for the runnable, containing agent context.
+
+        Returns:
+            List[CryptoPrice]: A list of cryptocurrency prices for each target currency.
+
+        Raises:
+            Exception: If there's an error accessing the CryptoCompare API.
+        """
+        try:
+            context = self.context_from_config(config)
+
+            # Check rate limit
+            await self.check_rate_limit(context.agent.id, max_requests=10, interval=60)
+
+            # Get API key from context
+            api_key = context.config.get("api_key")
+            if not api_key:
+                raise ValueError("CryptoCompare API key not found in configuration")
+
+            # Fetch price data directly
+            price_data = await self.fetch_price(api_key, from_symbol, to_symbols)
+
+            # Check for errors
+            if "error" in price_data:
+                raise ValueError(price_data["error"])
+
+            # Convert to list of CryptoPrice objects
+            result = []
+            for to_symbol, price in price_data.items():
+                result.append(
+                    CryptoPrice(
+                        from_symbol=from_symbol,
+                        to_symbol=to_symbol,
+                        price=price,
+                    )
+                )
+
+            return result
+
+        except Exception as e:
+            logger.error("Error fetching price: %s", str(e))
+            raise type(e)(f"[agent:{context.agent.id}]: {e}") from e

intentkit/skills/cryptocompare/fetch_top_exchanges.py

@@ -0,0 +1,113 @@
+"""Tool for fetching top exchanges for a cryptocurrency pair via CryptoCompare API."""
+
+import logging
+from typing import List, Type
+
+from langchain_core.runnables import RunnableConfig
+from pydantic import BaseModel, Field
+
+from intentkit.skills.cryptocompare.base import CryptoCompareBaseTool, CryptoExchange
+
+logger = logging.getLogger(__name__)
+
+
+class CryptoCompareFetchTopExchangesInput(BaseModel):
+    """Input for CryptoCompareFetchTopExchanges tool."""
+
+    from_symbol: str = Field(
+        ..., description="Base cryptocurrency symbol for the trading pair (e.g., 'BTC')"
+    )
+    to_symbol: str = Field(
+        "USD",
+        description="Quote currency symbol for the trading pair. Defaults to 'USD'",
+    )
+    limit: int = Field(
+        10,
+        description="Number of exchanges to fetch (max 100)",
+        ge=1,
+        le=100,
+    )
+
+
+class CryptoCompareFetchTopExchanges(CryptoCompareBaseTool):
+    """Tool for fetching top exchanges for a cryptocurrency pair from CryptoCompare.
+
+    This tool uses the CryptoCompare API to retrieve the top exchanges
+    for a specific cryptocurrency trading pair, ranked by volume.
+
+    Attributes:
+        name: The name of the tool.
+        description: A description of what the tool does.
+        args_schema: The schema for the tool's input arguments.
+    """
+
+    name: str = "cryptocompare_fetch_top_exchanges"
+    description: str = (
+        "Fetch top exchanges for a cryptocurrency trading pair, ranked by volume"
+    )
+    args_schema: Type[BaseModel] = CryptoCompareFetchTopExchangesInput
+
+    async def _arun(
+        self,
+        from_symbol: str,
+        to_symbol: str = "USD",
+        limit: int = 10,
+        config: RunnableConfig = None,
+        **kwargs,
+    ) -> List[CryptoExchange]:
+        """Async implementation of the tool to fetch top exchanges for a cryptocurrency pair.
+
+        Args:
+            from_symbol: Base cryptocurrency symbol for the trading pair (e.g., 'BTC')
+            to_symbol: Quote currency symbol for the trading pair. Defaults to 'USD'
+            limit: Number of exchanges to fetch (max 100)
+            config: The configuration for the runnable, containing agent context.
+
+        Returns:
+            List[CryptoExchange]: A list of top exchanges for the specified trading pair.
+
+        Raises:
+            Exception: If there's an error accessing the CryptoCompare API.
+        """
+        try:
+            context = self.context_from_config(config)
+
+            # Check rate limit
+            await self.check_rate_limit(context.agent.id, max_requests=5, interval=60)
+
+            # Get API key from context
+            api_key = context.config.get("api_key")
+            if not api_key:
+                raise ValueError("CryptoCompare API key not found in configuration")
+
+            # Fetch top exchanges data directly
+            exchanges_data = await self.fetch_top_exchanges(
+                api_key, from_symbol, to_symbol
+            )
+
+            # Check for errors
+            if "error" in exchanges_data:
+                raise ValueError(exchanges_data["error"])
+
+            # Convert to list of CryptoExchange objects
+            result = []
+            if "Data" in exchanges_data and exchanges_data["Data"]:
+                for item in exchanges_data["Data"]:
+                    if len(result) >= limit:
+                        break
+
+                    result.append(
+                        CryptoExchange(
+                            exchange=item.get("exchange", ""),
+                            from_symbol=from_symbol,
+                            to_symbol=to_symbol,
+                            volume24h=item.get("volume24h", 0),
+                            volume24h_to=item.get("volume24hTo", 0),
+                        )
+                    )
+
+            return result
+
+        except Exception as e:
+            logger.error("Error fetching top exchanges: %s", str(e))
+            raise type(e)(f"[agent:{context.agent.id}]: {e}") from e

intentkit/skills/cryptocompare/fetch_top_market_cap.py

@@ -0,0 +1,109 @@
+"""Tool for fetching top cryptocurrencies by market cap via CryptoCompare API."""
+
+import logging
+from typing import List, Type
+
+from langchain_core.runnables import RunnableConfig
+from pydantic import BaseModel, Field
+
+from intentkit.skills.cryptocompare.base import CryptoCompareBaseTool, CryptoCurrency
+
+logger = logging.getLogger(__name__)
+
+
+class CryptoCompareFetchTopMarketCapInput(BaseModel):
+    """Input for CryptoCompareFetchTopMarketCap tool."""
+
+    to_symbol: str = Field(
+        "USD",
+        description="Quote currency for market cap calculation (e.g., 'USD', 'EUR')",
+    )
+    limit: int = Field(
+        10,
+        description="Number of cryptocurrencies to fetch (max 100)",
+        ge=1,
+        le=100,
+    )
+
+
+class CryptoCompareFetchTopMarketCap(CryptoCompareBaseTool):
+    """Tool for fetching top cryptocurrencies by market cap from CryptoCompare.
+
+    This tool uses the CryptoCompare API to retrieve the top cryptocurrencies
+    ranked by market capitalization in a specified quote currency.
+
+    Attributes:
+        name: The name of the tool.
+        description: A description of what the tool does.
+        args_schema: The schema for the tool's input arguments.
+    """
+
+    name: str = "cryptocompare_fetch_top_market_cap"
+    description: str = "Fetch top cryptocurrencies ranked by market capitalization"
+    args_schema: Type[BaseModel] = CryptoCompareFetchTopMarketCapInput
+
+    async def _arun(
+        self,
+        to_symbol: str = "USD",
+        limit: int = 10,
+        config: RunnableConfig = None,
+        **kwargs,
+    ) -> List[CryptoCurrency]:
+        """Async implementation of the tool to fetch top cryptocurrencies by market cap.
+
+        Args:
+            to_symbol: Quote currency for market cap calculation (e.g., 'USD', 'EUR')
+            limit: Number of cryptocurrencies to fetch (max 100)
+            config: The configuration for the runnable, containing agent context.
+
+        Returns:
+            List[CryptoCurrency]: A list of top cryptocurrencies by market cap.
+
+        Raises:
+            Exception: If there's an error accessing the CryptoCompare API.
+        """
+        try:
+            context = self.context_from_config(config)
+
+            # Check rate limit
+            await self.check_rate_limit(context.agent.id, max_requests=5, interval=60)
+
+            # Get API key from context
+            api_key = context.config.get("api_key")
+            if not api_key:
+                raise ValueError("CryptoCompare API key not found in configuration")
+
+            # Fetch top market cap data directly
+            market_cap_data = await self.fetch_top_market_cap(api_key, limit, to_symbol)
+
+            # Check for errors
+            if "error" in market_cap_data:
+                raise ValueError(market_cap_data["error"])
+
+            # Convert to list of CryptoCurrency objects
+            result = []
+            if "Data" in market_cap_data and market_cap_data["Data"]:
+                for item in market_cap_data["Data"]:
+                    coin_info = item.get("CoinInfo", {})
+                    raw_data = item.get("RAW", {}).get(to_symbol, {})
+
+                    result.append(
+                        CryptoCurrency(
+                            id=str(coin_info.get("Id", "")),
+                            name=coin_info.get("Name", ""),
+                            symbol=coin_info.get(
+                                "Name", ""
+                            ),  # API uses same field for symbol
+                            full_name=coin_info.get("FullName", ""),
+                            market_cap=raw_data.get("MKTCAP", 0),
+                            volume24h=raw_data.get("VOLUME24HOUR", 0),
+                            price=raw_data.get("PRICE", 0),
+                            change24h=raw_data.get("CHANGEPCT24HOUR", 0),
+                        )
+                    )
+
+            return result
+
+        except Exception as e:
+            logger.error("Error fetching top market cap: %s", str(e))
+            raise type(e)(f"[agent:{context.agent.id}]: {e}") from e

intentkit/skills/cryptocompare/fetch_top_volume.py

@@ -0,0 +1,108 @@
+"""Tool for fetching top cryptocurrencies by trading volume via CryptoCompare API."""
+
+import logging
+from typing import List, Type
+
+from langchain_core.runnables import RunnableConfig
+from pydantic import BaseModel, Field
+
+from intentkit.skills.cryptocompare.base import CryptoCompareBaseTool, CryptoCurrency
+
+logger = logging.getLogger(__name__)
+
+
+class CryptoCompareFetchTopVolumeInput(BaseModel):
+    """Input for CryptoCompareFetchTopVolume tool."""
+
+    to_symbol: str = Field(
+        "USD", description="Quote currency for volume calculation. Defaults to 'USD'"
+    )
+    limit: int = Field(
+        10,
+        description="Number of cryptocurrencies to fetch (max 100)",
+        ge=1,
+        le=100,
+    )
+
+
+class CryptoCompareFetchTopVolume(CryptoCompareBaseTool):
+    """Tool for fetching top cryptocurrencies by trading volume from CryptoCompare.
+
+    This tool uses the CryptoCompare API to retrieve the top cryptocurrencies
+    ranked by 24-hour trading volume in a specified quote currency.
+
+    Attributes:
+        name: The name of the tool.
+        description: A description of what the tool does.
+        args_schema: The schema for the tool's input arguments.
+    """
+
+    name: str = "cryptocompare_fetch_top_volume"
+    description: str = "Fetch top cryptocurrencies ranked by 24-hour trading volume"
+    args_schema: Type[BaseModel] = CryptoCompareFetchTopVolumeInput
+
+    async def _arun(
+        self,
+        to_symbol: str = "USD",
+        limit: int = 10,
+        config: RunnableConfig = None,
+        **kwargs,
+    ) -> List[CryptoCurrency]:
+        """Async implementation of the tool to fetch top cryptocurrencies by trading volume.
+
+        Args:
+            to_symbol: Quote currency for volume calculation. Defaults to 'USD'
+            limit: Number of cryptocurrencies to fetch (max 100)
+            config: The configuration for the runnable, containing agent context.
+
+        Returns:
+            List[CryptoCurrency]: A list of top cryptocurrencies by trading volume.
+
+        Raises:
+            Exception: If there's an error accessing the CryptoCompare API.
+        """
+        try:
+            context = self.context_from_config(config)
+
+            # Check rate limit
+            await self.check_rate_limit(context.agent.id, max_requests=5, interval=60)
+
+            # Get API key from context
+            api_key = context.config.get("api_key")
+            if not api_key:
+                raise ValueError("CryptoCompare API key not found in configuration")
+
+            # Fetch top volume data directly
+            volume_data = await self.fetch_top_volume(api_key, limit, to_symbol)
+
+            # Check for errors
+            if "error" in volume_data:
+                raise ValueError(volume_data["error"])
+
+            # Convert to list of CryptoCurrency objects
+            result = []
+            if "Data" in volume_data and volume_data["Data"]:
+                for item in volume_data["Data"]:
+                    coin_info = item.get("CoinInfo", {})
+                    raw_data = item.get("RAW", {}).get(to_symbol, {})
+
+                    result.append(
+                        CryptoCurrency(
+                            id=str(coin_info.get("Id", "")),
+                            name=coin_info.get("Name", ""),
+                            symbol=coin_info.get(
+                                "Name", ""
+                            ),  # API uses same field for symbol
+                            full_name=coin_info.get("FullName", ""),
+                            market_cap=raw_data.get("MKTCAP", 0),
+                            volume24h=raw_data.get("VOLUME24HOUR", 0),
+                            price=raw_data.get("PRICE", 0),
+                            change24h=raw_data.get("CHANGEPCT24HOUR", 0),
+                        )
+                    )
+
+            return result
+
+        except Exception as e:
+            logger.error("Error fetching top volume: %s", str(e))
+            raise type(e)(f"[agent:{context.agent.id}]: {e}") from e

intentkit/skills/cryptocompare/fetch_trading_signals.py

@@ -0,0 +1,107 @@
+"""Tool for fetching cryptocurrency trading signals via CryptoCompare API."""
+
+import logging
+from typing import Dict, List, Type
+
+from langchain_core.runnables import RunnableConfig
+from pydantic import BaseModel, Field
+
+from intentkit.skills.cryptocompare.base import CryptoCompareBaseTool
+
+logger = logging.getLogger(__name__)
+
+
+class CryptoCompareFetchTradingSignalsInput(BaseModel):
+    """Input for CryptoCompareFetchTradingSignals tool."""
+
+    from_symbol: str = Field(
+        ...,
+        description="Cryptocurrency symbol to fetch trading signals for (e.g., 'BTC')",
+    )
+
+
+class TradingSignal(BaseModel):
+    """Model representing a cryptocurrency trading signal."""
+
+    symbol: str
+    indicator: str
+    value: float
+    signal: str
+    description: str
+
+
+class CryptoCompareFetchTradingSignals(CryptoCompareBaseTool):
+    """Tool for fetching cryptocurrency trading signals from CryptoCompare.
+
+    This tool uses the CryptoCompare API to retrieve the latest trading signals
+    for a specific cryptocurrency. These signals can help inform trading decisions.
+
+    Attributes:
+        name: The name of the tool.
+        description: A description of what the tool does.
+        args_schema: The schema for the tool's input arguments.
+    """
+
+    name: str = "cryptocompare_fetch_trading_signals"
+    description: str = "Fetch the latest trading signals for a specific cryptocurrency"
+    args_schema: Type[BaseModel] = CryptoCompareFetchTradingSignalsInput
+
+    async def _arun(
+        self,
+        from_symbol: str,
+        config: RunnableConfig,
+        **kwargs,
+    ) -> List[TradingSignal]:
+        """Async implementation of the tool to fetch cryptocurrency trading signals.
+
+        Args:
+            from_symbol: Cryptocurrency symbol to fetch trading signals for (e.g., 'BTC')
+            config: The configuration for the runnable, containing agent context.
+
+        Returns:
+            List[TradingSignal]: A list of trading signals for the specified cryptocurrency.
+
+        Raises:
+            Exception: If there's an error accessing the CryptoCompare API.
+        """
+        try:
+            context = self.context_from_config(config)
+
+            # Check rate limit
+            await self.check_rate_limit(context.agent.id, max_requests=5, interval=60)
+
+            # Get API key from context
+            api_key = context.config.get("api_key")
+            if not api_key:
+                raise ValueError("CryptoCompare API key not found in configuration")
+
+            # Fetch trading signals data directly
+            signals_data = await self.fetch_trading_signals(api_key, from_symbol)
+
+            # Check for errors
+            if "error" in signals_data:
+                raise ValueError(signals_data["error"])
+
+            # Convert to list of TradingSignal objects
+            result = []
+            if "Data" in signals_data and signals_data["Data"]:
+                for indicator_name, indicator_data in signals_data["Data"].items():
+                    if (
+                        isinstance(indicator_data, Dict)
+                        and "sentiment" in indicator_data
+                    ):
+                        result.append(
+                            TradingSignal(
+                                symbol=from_symbol,
+                                indicator=indicator_name,
+                                value=indicator_data.get("score", 0.0),
+                                signal=indicator_data.get("sentiment", ""),
+                                description=indicator_data.get("description", ""),
+                            )
+                        )
+
+            return result
+
+        except Exception as e:
+            logger.error("Error fetching trading signals: %s", str(e))
+            raise type(e)(f"[agent:{context.agent.id}]: {e}") from e