search_token_details
Retrieve detailed information about a specific token by searching its symbol or address. Includes data like market cap, liquidity, and transaction volume, sorted by customizable parameters. Ideal for blockchain analysis and trading strategies.
Instructions
Search and retrieve details about single token.
If only address or symbol is needed, use get_official_token_address first.
Expects a TokenSearchRequest, returns a list of TokenDetailsResponse.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| token_search_requests | Yes |
Implementation Reference
- armor_crypto_mcp/armor_mcp.py:225-239 (handler)MCP tool handler function for 'search_token_details'. Decorated with @mcp.tool() for registration and executes the tool logic by calling the ArmorWalletAPIClient's search_token method.@mcp.tool() async def search_token_details(token_search_requests: TokenSearchRequest) -> TokenSearchResponseContainer: """ Search and retrieve details about single token. If only address or symbol is needed, use get_official_token_address first. Expects a TokenSearchRequest, returns a list of TokenDetailsResponse. """ if not armor_client: return [{"error": "Not logged in"}] try: result: TokenSearchResponseContainer = await armor_client.search_token(token_search_requests) return result except Exception as e: return [{"error": str(e)}]
- Pydantic model defining the input parameters for the search_token_details tool.class TokenSearchRequest(BaseModel): query: str = Field(description="token symbol or address") sort_by: Optional[Literal['decimals', 'holders', 'jupiter', 'verified', 'liquidityUsd', 'marketCapUsd', 'priceUsd', 'totalBuys', 'totalSells', 'totalTransactions', 'volume_5m', 'volume', 'volume_15m', 'volume_30m', 'volume_1h', 'volume_6h', 'volume_12h', 'volume_24h']] = Field(description="Sort token data results by this field") sort_order: Optional[Literal['asc', 'desc']] = Field(default='desc', description="The order of the sorted results") limit: Optional[int] = Field(default=10, description="The number of results to return from the search. Use default unless specified. Should not be over 30 if looking up multiple tokens.")
- Pydantic model defining the detailed response structure for token search results.class TokenSearchResponse(BaseModel): name: str = Field(description="name of the token") symbol: str = Field(description="symbol of the token") mint_address: Optional[str] = Field(description="mint address of the token") decimals: Optional[int] = Field(description="number of decimals of the token, returns only if include_details is True") image: Optional[str] = Field(description="image url of the token, returns only if include_details is True") holders: Optional[int] = Field(description="number of holders of the token, returns only if include_details is True") jupiter: Optional[bool] = Field(description="whether the token is supported by Jupiter, returns only if include_details is True") verified: Optional[bool] = Field(description="whether the token is verified, returns only if include_details is True") liquidityUsd: Optional[float] = Field(description="liquidity of the token in USD, returns only if include_details is True") marketCapUsd: Optional[float] = Field(description="market cap of the token in USD, returns only if include_details is True") priceUsd: Optional[float] = Field(description="price of the token in USD, returns only if include_details is True") lpBurn: Optional[float] = Field(description="lp burn of the token, returns only if include_details is True") market: Optional[str] = Field(description="market of the token, returns only if include_details is True") freezeAuthority: Optional[str] = Field(description="freeze authority of the token, returns only if include_details is True") mintAuthority: Optional[str] = Field(description="mint authority of the token, returns only if include_details is True") poolAddress: Optional[str] = Field(description="pool address of the token, returns only if include_details is True") totalBuys: Optional[int] = Field(description="total number of buys of the token, returns only if include_details is True") totalSells: Optional[int] = Field(description="total number of sells of the token, returns only if include_details is True") totalTransactions: Optional[int] = Field(description="total number of transactions of the token, returns only if include_details is True") volume: Optional[float] = Field(description="volume of the token, returns only if include_details is True") volume_5m: Optional[float] = Field(description="volume of the token in the last 5 minutes, returns only if include_details is True") volume_15m: Optional[float] = Field(description="volume of the token in the last 15 minutes, returns only if include_details is True") volume_30m: Optional[float] = Field(description="volume of the token in the last 30 minutes, returns only if include_details is True") volume_1h: Optional[float] = Field(description="volume of the token in the last 1 hour, returns only if include_details is True") volume_6h: Optional[float] = Field(description="volume of the token in the last 6 hours, returns only if include_details is True") volume_12h: Optional[float] = Field(description="volume of the token in the last 12 hours, returns only if include_details is True") volume_24h: Optional[float] = Field(description="volume of the token in the last 24 hours, returns only if include_details is True")
- Pydantic container model for the list of TokenSearchResponse in the tool output.class TokenSearchResponseContainer(BaseModel): token_search_responses: List[TokenSearchResponse]
- Supporting method in ArmorWalletAPIClient that handles the actual API call for token search, used by the MCP handler.async def search_token(self, data: TokenSearchRequest) -> TokenSearchResponseContainer: """Get details of a token.""" payload = data.model_dump(exclude_none=True) return await self._api_call("POST", "tokens/search-token/", payload)