# BirdEye Token Trending

#### BirdEye Token Trending Tool (`birdeye_token_trending_tool`)

Fetches a list of the top trending tokens on the Solana network directly from the BirdEye API, providing insights into current market movers.

***

```python
class BirdeyeTokenTrendingInput(BaseModel):
    limit: int = 10 # Number of tokens (default 10, max 20)
```

**Key Functionality:**

* Retrieves top trending Solana tokens from `public-api.birdeye.so`.
* Includes key metrics for each token: price, 24h price change (with visual emoji), market cap, 24h volume, liquidity, and contract address.
* The number of results can be specified (up to a maximum of 20).

***

**Sample Usage Queries (How an AI might use it):**

* "What are the top 10 trending tokens on Solana right now according to BirdEye?"
* "Show me the 5 hottest tokens on Solana."
* "Get BirdEye's trending list for Solana tokens."
* "List the top trending tokens with a limit of 15."
* "Which tokens are currently trending on Solana via BirdEye?"
* "Fetch the top 20 trending Solana coins from BirdEye."
* "Can you show me BirdEye's trending tokens?"
* "What's hot on Solana according to BirdEye?"

***

**Quick Code Glance:**

```python
class BirdeyeTokenTrendingTool(BaseTool):
    name: ClassVar[str] = "birdeye_token_trending_tool"
    description: ClassVar[str] = "Get a list of top trending tokens on Solana..."
    args_schema: ClassVar[Type[BaseModel]] = BirdeyeTokenTrendingInput
```

***

**Important:**

* This tool operates **asynchronously** (`_arun`) only.
* Requires a valid BirdEye API key (`CONFIG.BIRDEYE_API_KEY`) to be configured in the backend.
* The `limit` parameter defaults to 10 and is capped at a maximum of 20 tokens.