---
name: dexscreener-trends
description: List the tokens with the most active boosts on DexScreener, with live price, 24h volume, 24h price change and liquidity. Use when the user asks what is trending, hot or being promoted on DexScreener, optionally for one chain.
---

# DexScreener trends

Reads DexScreener's public "top token boosts" list and enriches each token with its most
liquid trading pair. Read-only, free, no API key.

## Run

```bash
node scripts/trends.mjs                 # all chains, top 10
node scripts/trends.mjs --chain solana  # one chain (solana, base, ethereum, bsc, ...)
node scripts/trends.mjs --limit 20      # up to 30
```

Bun works too: `bun scripts/trends.mjs`.

## Output

JSON on stdout:

```json
{ "source": "dexscreener", "fetchedAt": "<ISO time>", "chain": "solana | all",
  "tokens": [ { "rank": 1, "chainId": "", "address": "", "symbol": "", "name": "",
    "boosts": 0, "priceUsd": 0, "change24hPct": 0, "volume24hUsd": 0,
    "liquidityUsd": 0, "marketCapUsd": 0, "pairUrl": "" } ] }
```

## Notes for the agent

- "Boosts" are paid promotions on DexScreener. Say so when you present the list: a boosted
  token is being promoted, which is not the same as being safe or popular.
- Tokens without a trading pair come back with `null` market fields.
- On an error the script exits with code 1 and prints `{ "error": "..." }`.