> ## Documentation Index
> Fetch the complete documentation index at: https://docs.b3os.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Boosted Tokens

Retrieve the top boosted tokens from DEX Screener ranked by total boost amount. Returns token address, chain, description, links, and boost amounts. Optionally filter by chain ID and limit results (max 100). Ideal for: discovering trending tokens, monitoring promotional activity, identifying tokens with high community engagement.

![Get Boosted Tokens logo](https://ai-icon.b3.fun/logo/dexscreener)
Catalog action Blockchain Data

Retrieve the top boosted tokens from DEX Screener ranked by total boost amount. Returns token address, chain, description, links, and boost amounts. Optionally filter by chain ID and limit results (max 100). Ideal for: discovering trending tokens, monitoring promotional activity, identifying tokens with high community engagement.


## At a Glance

| Field | Value |
| --- | --- |
| Action ID | `dexscreener-get-boosted-tokens` |
| Category | Blockchain Data |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | `dex`, `token`, `trending`, `market`, `read` |

## Payload Schema

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `chainId` | `string` | No | Filter by chain ID \(e.g. 'base', 'solana', 'bsc'\). If omitted, returns all chains. |
| `limit` | `number` | No | Maximum number of results to return \(1-100, default: 20\) |

## Result Schema

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `tokens` | `array` | Yes | Array of top boosted tokens |

## Examples

**Workflow node**

```json
{
  "type": "dexscreener-get-boosted-tokens",
  "payload": {
    "chainId": "8453",
    "limit": 20
  },
  "children": []
}
```
  **Test with API**

```bash
curl -X POST "https://api.b3os.org/v1/actions/dexscreener-get-boosted-tokens/test" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "inputs": {
    "chainId": "8453",
    "limit": 20
  }
}'
```

**Use expressions for dynamic values**

Payload fields can use workflow expressions such as `{{$trigger.body.amount}}`, `{{$nodes.fetch.result.price}}`, and `{{$props.asset}}` when the value should come from a trigger, prior node, or reusable workflow prop.