# DexScreener Top Boosts Tool

#### DexScreener Top Boosts Tool (`dexscreener_top_boosts_tool`)

Fetches a list of tokens that currently have the most active "boosts" on DexScreener. This can indicate trending projects or tokens gaining community attention across various blockchains.

{% hint style="info" %}
**Input:** Accepts an optional `limit` for the number of boosted tokens to retrieve.
{% endhint %}

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

***

**Key Functionality:**

* Retrieves the top boosted tokens from the `api.dexscreener.com`.
* For each token, it provides the chain, token address, total boost amount, a brief description, and associated links (like website or socials).
* The number of results can be specified using `limit`, up to a maximum of 30.

***

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

* "What are the top boosted tokens on DexScreener right now?"
* "Show me the 15 most boosted tokens via DexScreener."
* "Get DexScreener's list of top token boosts."
* "Which tokens are currently being boosted heavily on DexScreener?"
* "Fetch the top boosted tokens with a limit of 5 from DexScreener."
* "List projects with the most active boosts on DexScreener."
* "Can you show me DexScreener's top boosts?"

***

```python
class DexScreenerTopBoostsTool(BaseTool):
    name: ClassVar[str] = "dexscreener_top_boosts_tool"
    description: ClassVar[str] = "Get the tokens with most active boosts on DexScreener..."
    args_schema: ClassVar[Type[BaseModel]] = DexScreenerTopBoostsInput
```

***

**Important:**

* This tool operates primarily **asynchronously** (`_arun`). The synchronous version returns an informational message.
* Relies on the external DexScreener API (`api.dexscreener.com`); its functionality and data accuracy depend on this third-party service.
* The `limit` parameter defaults to 10 and is capped at a maximum of 30 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/dexscreener-top-boosts-tool.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.