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

intentkit/skills/defillama/volumes/fetch_dex_overview.py

@@ -0,0 +1,157 @@
+"""Tool for fetching DEX overview data via DeFi Llama API."""
+
+from typing import Dict, List, Optional
+
+from langchain.schema.runnable import RunnableConfig
+from pydantic import BaseModel, Field
+
+from intentkit.skills.defillama.api import fetch_dex_overview
+from intentkit.skills.defillama.base import DefiLlamaBaseTool
+
+FETCH_DEX_OVERVIEW_PROMPT = """
+This tool fetches comprehensive overview data for DEX protocols from DeFi Llama.
+Returns:
+- Chain statistics and breakdowns
+- Protocol-specific metrics
+- Change percentages
+- Total volume data
+"""
+
+
+class MethodologyInfo(BaseModel):
+    """Model representing methodology information."""
+
+    UserFees: Optional[str] = Field(None, description="User fee information")
+    Fees: Optional[str] = Field(None, description="Fee structure")
+    Revenue: Optional[str] = Field(None, description="Revenue model")
+    ProtocolRevenue: Optional[str] = Field(None, description="Protocol revenue info")
+    HoldersRevenue: Optional[str] = Field(None, description="Holder revenue info")
+    SupplySideRevenue: Optional[str] = Field(
+        None, description="Supply side revenue info"
+    )
+
+
+class ProtocolInfo(BaseModel):
+    """Model representing individual protocol data."""
+
+    total24h: Optional[float] = Field(None, description="24h total")
+    total48hto24h: Optional[float] = Field(None, description="48h to 24h total")
+    total7d: Optional[float] = Field(None, description="7d total")
+    total14dto7d: Optional[float] = Field(None, description="14d to 7d total")
+    total60dto30d: Optional[float] = Field(None, description="60d to 30d total")
+    total30d: Optional[float] = Field(None, description="30d total")
+    total1y: Optional[float] = Field(None, description="1y total")
+    totalAllTime: Optional[float] = Field(None, description="All time total")
+    average1y: Optional[float] = Field(None, description="1y average")
+    change_1d: Optional[float] = Field(None, description="1d change")
+    change_7d: Optional[float] = Field(None, description="7d change")
+    change_1m: Optional[float] = Field(None, description="1m change")
+    change_7dover7d: Optional[float] = Field(None, description="7d over 7d change")
+    change_30dover30d: Optional[float] = Field(None, description="30d over 30d change")
+    breakdown24h: Optional[Dict[str, Dict[str, float]]] = Field(
+        None, description="24h breakdown by chain"
+    )
+    breakdown30d: Optional[Dict[str, Dict[str, float]]] = Field(
+        None, description="30d breakdown by chain"
+    )
+    total7DaysAgo: Optional[float] = Field(None, description="Total 7 days ago")
+    total30DaysAgo: Optional[float] = Field(None, description="Total 30 days ago")
+    defillamaId: Optional[str] = Field(None, description="DeFi Llama ID")
+    name: str = Field(..., description="Protocol name")
+    displayName: str = Field(..., description="Display name")
+    module: str = Field(..., description="Module name")
+    category: str = Field(..., description="Protocol category")
+    logo: Optional[str] = Field(None, description="Logo URL")
+    chains: List[str] = Field(..., description="Supported chains")
+    protocolType: str = Field(..., description="Protocol type")
+    methodologyURL: Optional[str] = Field(None, description="Methodology URL")
+    methodology: Optional[MethodologyInfo] = Field(
+        None, description="Methodology details"
+    )
+    latestFetchIsOk: bool = Field(..., description="Latest fetch status")
+    disabled: Optional[bool] = Field(None, description="Whether protocol is disabled")
+    parentProtocol: Optional[str] = Field(None, description="Parent protocol")
+    slug: str = Field(..., description="Protocol slug")
+    linkedProtocols: Optional[List[str]] = Field(None, description="Linked protocols")
+    id: str = Field(..., description="Protocol ID")
+
+
+class FetchDexOverviewResponse(BaseModel):
+    """Response schema for DEX overview data."""
+
+    totalDataChart: List = Field(
+        default_factory=list, description="Total data chart points"
+    )
+    totalDataChartBreakdown: List = Field(
+        default_factory=list, description="Total data chart breakdown"
+    )
+    breakdown24h: Optional[Dict[str, Dict[str, float]]] = Field(
+        None, description="24h breakdown by chain"
+    )
+    breakdown30d: Optional[Dict[str, Dict[str, float]]] = Field(
+        None, description="30d breakdown by chain"
+    )
+    chain: Optional[str] = Field(None, description="Specific chain")
+    allChains: List[str] = Field(..., description="List of all chains")
+    total24h: float = Field(..., description="24h total")
+    total48hto24h: float = Field(..., description="48h to 24h total")
+    total7d: float = Field(..., description="7d total")
+    total14dto7d: float = Field(..., description="14d to 7d total")
+    total60dto30d: float = Field(..., description="60d to 30d total")
+    total30d: float = Field(..., description="30d total")
+    total1y: float = Field(..., description="1y total")
+    change_1d: float = Field(..., description="1d change")
+    change_7d: float = Field(..., description="7d change")
+    change_1m: float = Field(..., description="1m change")
+    change_7dover7d: float = Field(..., description="7d over 7d change")
+    change_30dover30d: float = Field(..., description="30d over 30d change")
+    total7DaysAgo: float = Field(..., description="Total 7 days ago")
+    total30DaysAgo: float = Field(..., description="Total 30 days ago")
+    protocols: List[ProtocolInfo] = Field(..., description="List of protocol data")
+    error: Optional[str] = Field(None, description="Error message if any")
+
+
+class DefiLlamaFetchDexOverview(DefiLlamaBaseTool):
+    """Tool for fetching DEX overview data from DeFi Llama.
+
+    This tool retrieves comprehensive data about DEX protocols, including
+    volumes, metrics, and chain breakdowns.
+
+    Example:
+        overview_tool = DefiLlamaFetchDexOverview(
+            skill_store=store,
+            agent_id="agent_123",
+            agent_store=agent_store
+        )
+        result = await overview_tool._arun()
+    """
+
+    name: str = "defillama_fetch_dex_overview"
+    description: str = FETCH_DEX_OVERVIEW_PROMPT
+    args_schema: None = None  # No input parameters needed
+
+    async def _arun(self, config: RunnableConfig) -> FetchDexOverviewResponse:
+        """Fetch DEX overview data.
+
+        Returns:
+            FetchDexOverviewResponse containing overview data or error
+        """
+        try:
+            # Check rate limiting
+            context = self.context_from_config(config)
+            is_rate_limited, error_msg = await self.check_rate_limit(context)
+            if is_rate_limited:
+                return FetchDexOverviewResponse(error=error_msg)
+
+            # Fetch overview data from API
+            result = await fetch_dex_overview()
+
+            # Check for API errors
+            if isinstance(result, dict) and "error" in result:
+                return FetchDexOverviewResponse(error=result["error"])
+
+            # Return the response matching the API structure
+            return FetchDexOverviewResponse(**result)
+
+        except Exception as e:
+            return FetchDexOverviewResponse(error=str(e))

intentkit/skills/defillama/volumes/fetch_dex_summary.py

@@ -0,0 +1,123 @@
+"""Tool for fetching DEX protocol summary data via DeFi Llama API."""
+
+from typing import Dict, List, Optional, Type
+
+from langchain.schema.runnable import RunnableConfig
+from pydantic import BaseModel, Field
+
+from intentkit.skills.defillama.api import fetch_dex_summary
+from intentkit.skills.defillama.base import DefiLlamaBaseTool
+
+FETCH_DEX_SUMMARY_PROMPT = """
+This tool fetches summary data for a specific DEX protocol from DeFi Llama.
+Required:
+- Protocol identifier
+Returns:
+- Protocol details and metadata
+- Volume metrics
+- Social links and identifiers
+- Child protocols and versions
+"""
+
+
+class FetchDexSummaryInput(BaseModel):
+    """Input schema for fetching DEX protocol summary."""
+
+    protocol: str = Field(..., description="Protocol identifier (e.g. 'uniswap')")
+
+
+class FetchDexSummaryResponse(BaseModel):
+    """Response schema for DEX protocol summary data."""
+
+    id: str = Field(..., description="Protocol ID")
+    name: str = Field(..., description="Protocol name")
+    url: Optional[str] = Field(None, description="Protocol website URL")
+    description: Optional[str] = Field(None, description="Protocol description")
+    logo: Optional[str] = Field(None, description="Logo URL")
+    gecko_id: Optional[str] = Field(None, description="CoinGecko ID")
+    cmcId: Optional[str] = Field(None, description="CoinMarketCap ID")
+    chains: List[str] = Field(default_factory=list, description="Supported chains")
+    twitter: Optional[str] = Field(None, description="Twitter handle")
+    treasury: Optional[str] = Field(None, description="Treasury identifier")
+    governanceID: Optional[List[str]] = Field(None, description="Governance IDs")
+    github: Optional[List[str]] = Field(None, description="GitHub organizations")
+    childProtocols: Optional[List[str]] = Field(None, description="Child protocols")
+    linkedProtocols: Optional[List[str]] = Field(None, description="Linked protocols")
+    disabled: Optional[bool] = Field(None, description="Whether protocol is disabled")
+    displayName: str = Field(..., description="Display name")
+    module: Optional[str] = Field(None, description="Module name")
+    category: Optional[str] = Field(None, description="Protocol category")
+    methodologyURL: Optional[str] = Field(None, description="Methodology URL")
+    methodology: Optional[Dict] = Field(None, description="Methodology details")
+    forkedFrom: Optional[List[str]] = Field(None, description="Forked from protocols")
+    audits: Optional[str] = Field(None, description="Audit information")
+    address: Optional[str] = Field(None, description="Contract address")
+    audit_links: Optional[List[str]] = Field(None, description="Audit links")
+    versionKey: Optional[str] = Field(None, description="Version key")
+    parentProtocol: Optional[str] = Field(None, description="Parent protocol")
+    previousNames: Optional[List[str]] = Field(None, description="Previous names")
+    latestFetchIsOk: bool = Field(..., description="Latest fetch status")
+    slug: str = Field(..., description="Protocol slug")
+    protocolType: str = Field(..., description="Protocol type")
+    total24h: Optional[float] = Field(None, description="24h total volume")
+    total48hto24h: Optional[float] = Field(None, description="48h to 24h total volume")
+    total7d: Optional[float] = Field(None, description="7d total volume")
+    totalAllTime: Optional[float] = Field(None, description="All time total volume")
+    totalDataChart: List = Field(default_factory=list, description="Total data chart")
+    totalDataChartBreakdown: List = Field(
+        default_factory=list, description="Chart breakdown"
+    )
+    change_1d: Optional[float] = Field(None, description="1d change percentage")
+    error: Optional[str] = Field(None, description="Error message if any")
+
+
+class DefiLlamaFetchDexSummary(DefiLlamaBaseTool):
+    """Tool for fetching DEX protocol summary data from DeFi Llama.
+
+    This tool retrieves detailed information about a specific DEX protocol,
+    including metadata, metrics, and related protocols.
+
+    Example:
+        summary_tool = DefiLlamaFetchDexSummary(
+            skill_store=store,
+            agent_id="agent_123",
+            agent_store=agent_store
+        )
+        result = await summary_tool._arun(protocol="uniswap")
+    """
+
+    name: str = "defillama_fetch_dex_summary"
+    description: str = FETCH_DEX_SUMMARY_PROMPT
+    args_schema: Type[BaseModel] = FetchDexSummaryInput
+
+    async def _arun(
+        self, config: RunnableConfig, protocol: str
+    ) -> FetchDexSummaryResponse:
+        """Fetch summary data for the given DEX protocol.
+
+        Args:
+            config: Runnable configuration
+            protocol: Protocol identifier
+
+        Returns:
+            FetchDexSummaryResponse containing protocol data or error
+        """
+        try:
+            # Check rate limiting
+            context = self.context_from_config(config)
+            is_rate_limited, error_msg = await self.check_rate_limit(context)
+            if is_rate_limited:
+                return FetchDexSummaryResponse(error=error_msg)
+
+            # Fetch protocol data from API
+            result = await fetch_dex_summary(protocol=protocol)
+
+            # Check for API errors
+            if isinstance(result, dict) and "error" in result:
+                return FetchDexSummaryResponse(error=result["error"])
+
+            # Return the response matching the API structure
+            return FetchDexSummaryResponse(**result)
+
+        except Exception as e:
+            return FetchDexSummaryResponse(error=str(e))

intentkit/skills/defillama/volumes/fetch_options_overview.py

@@ -0,0 +1,131 @@
+"""Tool for fetching options overview data via DeFi Llama API."""
+
+from typing import Dict, List, Optional, Type
+
+from langchain.schema.runnable import RunnableConfig
+from pydantic import BaseModel, Field
+
+from intentkit.skills.defillama.api import fetch_options_overview
+from intentkit.skills.defillama.base import DefiLlamaBaseTool
+
+FETCH_OPTIONS_OVERVIEW_PROMPT = """
+This tool fetches comprehensive overview data for all options protocols from DeFi Llama.
+Returns detailed metrics including:
+- Total volumes across different timeframes
+- Change percentages
+- Protocol-specific data
+- Chain breakdowns
+"""
+
+
+class ProtocolMethodology(BaseModel):
+    """Model representing protocol methodology data."""
+
+    UserFees: Optional[str] = Field(None, description="User fees description")
+    Fees: Optional[str] = Field(None, description="Fees description")
+    Revenue: Optional[str] = Field(None, description="Revenue description")
+    ProtocolRevenue: Optional[str] = Field(
+        None, description="Protocol revenue description"
+    )
+    HoldersRevenue: Optional[str] = Field(
+        None, description="Holders revenue description"
+    )
+    SupplySideRevenue: Optional[str] = Field(
+        None, description="Supply side revenue description"
+    )
+
+
+class Protocol(BaseModel):
+    """Model representing protocol data."""
+
+    name: str = Field(..., description="Protocol name")
+    displayName: str = Field(..., description="Display name of protocol")
+    defillamaId: str = Field(..., description="DeFi Llama ID")
+    category: str = Field(..., description="Protocol category")
+    logo: str = Field(..., description="Logo URL")
+    chains: List[str] = Field(..., description="Supported chains")
+    module: str = Field(..., description="Protocol module")
+    total24h: Optional[float] = Field(None, description="24-hour total")
+    total7d: Optional[float] = Field(None, description="7-day total")
+    total30d: Optional[float] = Field(None, description="30-day total")
+    total1y: Optional[float] = Field(None, description="1-year total")
+    totalAllTime: Optional[float] = Field(None, description="All-time total")
+    change_1d: Optional[float] = Field(None, description="24-hour change percentage")
+    change_7d: Optional[float] = Field(None, description="7-day change percentage")
+    change_1m: Optional[float] = Field(None, description="30-day change percentage")
+    methodology: Optional[ProtocolMethodology] = Field(
+        None, description="Protocol methodology"
+    )
+    breakdown24h: Optional[Dict[str, Dict[str, float]]] = Field(
+        None, description="24-hour breakdown by chain"
+    )
+    breakdown30d: Optional[Dict[str, Dict[str, float]]] = Field(
+        None, description="30-day breakdown by chain"
+    )
+
+
+class FetchOptionsOverviewResponse(BaseModel):
+    """Response schema for options overview data."""
+
+    total24h: float = Field(..., description="Total volume in last 24 hours")
+    total7d: float = Field(..., description="Total volume in last 7 days")
+    total30d: float = Field(..., description="Total volume in last 30 days")
+    total1y: float = Field(..., description="Total volume in last year")
+    change_1d: float = Field(..., description="24-hour change percentage")
+    change_7d: float = Field(..., description="7-day change percentage")
+    change_1m: float = Field(..., description="30-day change percentage")
+    allChains: List[str] = Field(..., description="List of all chains")
+    protocols: List[Protocol] = Field(..., description="List of protocols")
+    error: Optional[str] = Field(None, description="Error message if any")
+
+
+class DefiLlamaFetchOptionsOverview(DefiLlamaBaseTool):
+    """Tool for fetching options overview data from DeFi Llama.
+
+    This tool retrieves comprehensive data about all options protocols,
+    including volume metrics, change percentages, and detailed protocol information.
+
+    Example:
+        overview_tool = DefiLlamaFetchOptionsOverview(
+            skill_store=store,
+            agent_id="agent_123",
+            agent_store=agent_store
+        )
+        result = await overview_tool._arun()
+    """
+
+    name: str = "defillama_fetch_options_overview"
+    description: str = FETCH_OPTIONS_OVERVIEW_PROMPT
+
+    class EmptyArgsSchema(BaseModel):
+        """Empty schema for no input parameters."""
+
+        pass
+
+    args_schema: Type[BaseModel] = EmptyArgsSchema
+
+    async def _arun(self, config: RunnableConfig) -> FetchOptionsOverviewResponse:
+        """Fetch overview data for all options protocols.
+
+        Returns:
+            FetchOptionsOverviewResponse containing comprehensive overview data or error
+        """
+        try:
+            # Check rate limiting
+            context = self.context_from_config(config)
+            is_rate_limited, error_msg = await self.check_rate_limit(context)
+            if is_rate_limited:
+                return FetchOptionsOverviewResponse(error=error_msg)
+
+            # Fetch overview data from API
+            result = await fetch_options_overview()
+
+            # Check for API errors
+            if isinstance(result, dict) and "error" in result:
+                return FetchOptionsOverviewResponse(error=result["error"])
+
+            # Return the parsed response
+            return FetchOptionsOverviewResponse(**result)
+
+        except Exception as e:
+            return FetchOptionsOverviewResponse(error=str(e))

intentkit/skills/defillama/yields/fetch_pool_chart.py

@@ -0,0 +1,100 @@
+"""Tool for fetching pool chart data via DeFi Llama API."""
+
+from typing import List, Optional, Type
+
+from langchain_core.runnables import RunnableConfig
+from pydantic import BaseModel, Field
+
+from intentkit.skills.defillama.api import fetch_pool_chart
+from intentkit.skills.defillama.base import DefiLlamaBaseTool
+
+FETCH_POOL_CHART_PROMPT = """
+This tool fetches historical chart data from DeFi Llama for a specific pool.
+Required:
+- Pool ID
+Returns historical data including:
+- TVL in USD
+- APY metrics (base, reward, total)
+- Timestamps for each data point
+"""
+
+
+class PoolDataPoint(BaseModel):
+    """Model representing a single historical data point."""
+
+    timestamp: str = Field(..., description="ISO formatted timestamp of the data point")
+    tvlUsd: float = Field(..., description="Total Value Locked in USD")
+    apy: Optional[float] = Field(None, description="Total APY including rewards")
+    apyBase: Optional[float] = Field(None, description="Base APY without rewards")
+    apyReward: Optional[float] = Field(None, description="Additional APY from rewards")
+    il7d: Optional[float] = Field(None, description="7-day impermanent loss")
+    apyBase7d: Optional[float] = Field(None, description="7-day base APY")
+
+
+class FetchPoolChartInput(BaseModel):
+    """Input schema for fetching pool chart data."""
+
+    pool_id: str = Field(..., description="ID of the pool to fetch chart data for")
+
+
+class FetchPoolChartResponse(BaseModel):
+    """Response schema for pool chart data."""
+
+    status: str = Field("success", description="Response status")
+    data: List[PoolDataPoint] = Field(
+        default_factory=list, description="List of historical data points"
+    )
+    error: Optional[str] = Field(None, description="Error message if any")
+
+
+class DefiLlamaFetchPoolChart(DefiLlamaBaseTool):
+    """Tool for fetching pool chart data from DeFi Llama.
+
+    This tool retrieves historical data for a specific pool, including
+    TVL and APY metrics over time.
+
+    Example:
+        chart_tool = DefiLlamaFetchPoolChart(
+            skill_store=store,
+            agent_id="agent_123",
+            agent_store=agent_store
+        )
+        result = await chart_tool._arun(
+            pool_id="747c1d2a-c668-4682-b9f9-296708a3dd90"
+        )
+    """
+
+    name: str = "defillama_fetch_pool_chart"
+    description: str = FETCH_POOL_CHART_PROMPT
+    args_schema: Type[BaseModel] = FetchPoolChartInput
+
+    async def _arun(
+        self, config: RunnableConfig, pool_id: str
+    ) -> FetchPoolChartResponse:
+        """Fetch historical chart data for the given pool.
+
+        Args:
+            pool_id: ID of the pool to fetch chart data for
+
+        Returns:
+            FetchPoolChartResponse containing historical data or error
+        """
+        try:
+            # Check rate limiting
+            context = self.context_from_config(config)
+            is_rate_limited, error_msg = await self.check_rate_limit(context)
+            if is_rate_limited:
+                return FetchPoolChartResponse(error=error_msg)
+
+            # Fetch chart data from API
+            result = await fetch_pool_chart(pool_id=pool_id)
+
+            # Check for API errors
+            if isinstance(result, dict) and "error" in result:
+                return FetchPoolChartResponse(error=result["error"])
+
+            # Return the response matching the API structure
+            return FetchPoolChartResponse(**result)
+
+        except Exception as e:
+            return FetchPoolChartResponse(error=str(e))

intentkit/skills/defillama/yields/fetch_pools.py

@@ -0,0 +1,126 @@
+"""Tool for fetching pool data via DeFi Llama API."""
+
+from typing import Optional
+
+from langchain.schema.runnable import RunnableConfig
+from pydantic import BaseModel, Field
+
+from intentkit.skills.defillama.api import fetch_pools
+from intentkit.skills.defillama.base import DefiLlamaBaseTool
+
+FETCH_POOLS_PROMPT = """
+This tool fetches comprehensive data about yield-generating pools from DeFi Llama.
+Returns data including:
+- Pool details (chain, project, symbol)
+- TVL and APY information
+- Statistical metrics (mean, standard deviation)
+- Risk assessments and predictions
+- Historical performance data
+"""
+
+
+class PredictionData(BaseModel):
+    """Model representing prediction data for a pool."""
+
+    predictedClass: Optional[str] = Field(
+        None, description="Predicted direction of APY movement"
+    )
+    predictedProbability: Optional[float] = Field(
+        None, description="Probability of the prediction"
+    )
+    binnedConfidence: Optional[int] = Field(None, description="Confidence level bucket")
+
+
+class PoolData(BaseModel):
+    """Model representing a single pool's data."""
+
+    chain: str = Field(..., description="Blockchain network")
+    project: str = Field(..., description="Protocol or project name")
+    symbol: str = Field(..., description="Token or pool symbol")
+    tvlUsd: float = Field(..., description="Total Value Locked in USD")
+    apyBase: Optional[float] = Field(None, description="Base APY without rewards")
+    apyReward: Optional[float] = Field(None, description="Additional APY from rewards")
+    apy: Optional[float] = Field(None, description="Total APY including rewards")
+    rewardTokens: Optional[list[str]] = Field(
+        None, description="List of reward token addresses"
+    )
+    pool: Optional[str] = Field(None, description="Pool identifier")
+    apyPct1D: Optional[float] = Field(None, description="1-day APY percentage change")
+    apyPct7D: Optional[float] = Field(None, description="7-day APY percentage change")
+    apyPct30D: Optional[float] = Field(None, description="30-day APY percentage change")
+    stablecoin: bool = Field(False, description="Whether pool involves stablecoins")
+    ilRisk: str = Field("no", description="Impermanent loss risk assessment")
+    exposure: str = Field("single", description="Asset exposure type")
+    predictions: Optional[PredictionData] = Field(
+        None, description="APY movement predictions"
+    )
+    poolMeta: Optional[str] = Field(None, description="Additional pool metadata")
+    mu: Optional[float] = Field(None, description="Mean APY value")
+    sigma: Optional[float] = Field(None, description="APY standard deviation")
+    count: Optional[int] = Field(None, description="Number of data points")
+    outlier: bool = Field(False, description="Whether pool is an outlier")
+    underlyingTokens: Optional[list[str]] = Field(
+        None, description="List of underlying token addresses"
+    )
+    il7d: Optional[float] = Field(None, description="7-day impermanent loss")
+    apyBase7d: Optional[float] = Field(None, description="7-day base APY")
+    apyMean30d: Optional[float] = Field(None, description="30-day mean APY")
+    volumeUsd1d: Optional[float] = Field(None, description="24h volume in USD")
+    volumeUsd7d: Optional[float] = Field(None, description="7-day volume in USD")
+    apyBaseInception: Optional[float] = Field(
+        None, description="Base APY since inception"
+    )
+
+
+class FetchPoolsResponse(BaseModel):
+    """Response schema for pool data."""
+
+    status: str = Field("success", description="Response status")
+    data: list[PoolData] = Field(default_factory=list, description="List of pool data")
+    error: Optional[str] = Field(None, description="Error message if any")
+
+
+class DefiLlamaFetchPools(DefiLlamaBaseTool):
+    """Tool for fetching pool data from DeFi Llama.
+
+    This tool retrieves comprehensive data about yield-generating pools,
+    including TVL, APYs, risk metrics, and predictions.
+
+    Example:
+        pools_tool = DefiLlamaFetchPools(
+            skill_store=store,
+            agent_id="agent_123",
+            agent_store=agent_store
+        )
+        result = await pools_tool._arun()
+    """
+
+    name: str = "defillama_fetch_pools"
+    description: str = FETCH_POOLS_PROMPT
+    args_schema: None = None  # No input parameters needed
+
+    async def _arun(self, config: RunnableConfig) -> FetchPoolsResponse:
+        """Fetch pool data.
+
+        Returns:
+            FetchPoolsResponse containing pool data or error
+        """
+        try:
+            # Check rate limiting
+            context = self.context_from_config(config)
+            is_rate_limited, error_msg = await self.check_rate_limit(context)
+            if is_rate_limited:
+                return FetchPoolsResponse(error=error_msg)
+
+            # Fetch pool data from API
+            result = await fetch_pools()
+
+            # Check for API errors
+            if isinstance(result, dict) and "error" in result:
+                return FetchPoolsResponse(error=result["error"])
+
+            # Return the response matching the API structure
+            return FetchPoolsResponse(**result)
+
+        except Exception as e:
+            return FetchPoolsResponse(error=str(e))