# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://www.lumolabs.ai/tools/birdeye-token-trending.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.