feat: enso api prices

skills/enso/__init__.py

@@ -1,6 +1,7 @@
 """Enso skills."""
 from abstracts.skill import SkillStoreABC
 from skills.enso.base import EnsoBaseTool
+from skills.enso.prices import EnsoGetPrices
 from skills.enso.tokens import EnsoGetTokens
 
 
@@ -12,6 +13,8 @@ def get_enso_skill(
 
     if name == "get_tokens":
         return EnsoGetTokens(api_token=api_token, main_tokens=main_tokens, store=store, agent_id=agent_id)
+    if name == "get_prices":
+        return EnsoGetPrices(api_token=api_token, main_tokens=main_tokens, store=store, agent_id=agent_id)
 
     else:
         raise ValueError(f"Unknown Enso skill: {name}")

skills/enso/prices.py

@@ -0,0 +1,87 @@
+from typing import Optional, Type
+
+import httpx
+from pydantic import BaseModel, Field
+
+from .base import EnsoBaseTool, base_url
+
+
+class EnsoGetPricesInput(BaseModel):
+    chainId: int = Field(1, description="Blockchain chain ID of the token")
+    address: str = Field("0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee", description="Contract address of the token")
+
+
+class PriceInfo(BaseModel):
+    decimals: int | None = Field(None, ge=0, description="Number of decimals")
+    price: float | None = Field(None, gt=0, description="Price in the smallest unit")
+    address: str | None = Field(None, description="Contract address")
+    symbol: str | None = Field(None, description="Token symbol")
+    timestamp: int | None = Field(None, ge=0, description="Timestamp in seconds")
+    chainId: int | None = Field(None, ge=0, description="Chain ID")
+
+
+class EnsoGetPricesOutput(BaseModel):
+    res: PriceInfo | None = Field(None, description="Price information of the requested token")
+    error: str | None = Field(None, description="Error message if price retrieval fails")
+
+
+class EnsoGetPrices(EnsoBaseTool):
+    """
+    Tool allows fetching the price in USD for a given blockchain's token.
+
+    Attributes:
+        name (str): Name of the tool, specifically "enso_get_tokens".
+        description (str): Comprehensive description of the tool's purpose and functionality.
+        args_schema (Type[BaseModel]): Schema for input arguments, specifying expected parameters.
+    """
+
+    name: str = "enso_get_prices"
+    description: str = "Retrieve the price of a token by chain ID and contract address"
+    args_schema: Type[BaseModel] = EnsoGetPricesInput
+
+    def _run(self,
+             chainId: int = 1,
+             address: str = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee") -> EnsoGetPricesOutput:
+        """
+        Asynchronous function to request the token price from the API.
+
+        Args:
+            chainId (int): The blockchain's chain ID.
+            address (str): Contract address of the token.
+
+        Returns:
+            EnsoGetPricesOutput: Token price response or error message.
+        """
+        url = f"{base_url}/api/v1/prices/{str(chainId)}/{address}"
+
+        headers = {
+            "accept": "application/json",
+            "Authorization": f"Bearer {self.api_token}",
+        }
+
+        with httpx.Client() as client:
+            try:
+                response = client.get(url, headers=headers)
+                response.raise_for_status()
+                json_dict = response.json()
+
+                # Parse the response into a `PriceInfo` object
+                price_info = PriceInfo(**json_dict)
+
+                # Return the parsed response
+                return EnsoGetPricesOutput(res=price_info, error=None)
+            except httpx.RequestError as req_err:
+                return EnsoGetPricesOutput(res=None, error=f"Request error: {req_err}")
+            except httpx.HTTPStatusError as http_err:
+                return EnsoGetPricesOutput(res=None, error=f"HTTP error: {http_err}")
+            except Exception as e:
+                return EnsoGetPricesOutput(res=None, error=str(e))
+
+    async def _arun(self,
+                    chainId: int = 1,
+                    address: str = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee") -> EnsoGetPricesOutput:
+        """Async implementation of the tool.
+
+        This tool doesn't have a native async implementation, so we call the sync version.
+        """
+        return self._run(chainId, address)