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

# Trending Token Events

> Trending Token events trigger when a newly-launched token graduates from a launchpad and meets strict performance criteria. Get notified of high-potential tokens with built-in audit filters and advanced analytics.

<Tip>
  Trending Token Events are currently in beta. Contact us at [hello@dialect.to](mailto:hello@dialect.to) for early access or to discuss specific requirements.
</Tip>

## Webhooks

Webhooks for trending tokens can be delivered to power custom behavior in your infrastructure and apps. Reach out to the Dialect team for early access using the form above.

### Webhook Payload

When trending token events are detected, you'll receive a webhook with an array structure. Each individual event within the array has this structure:

```json theme={null}
{
  "events": [
    {
      "event": "trending_token",
      "timestamp": "2025-08-05T12:45:30Z",
      "token": {
        "symbol": "BOSS",
        "address": "GUy9Tu8YtvvHoL3DcXLJxXvEN8PqEus6mWQUEchcbonk"
      },
      "trigger": {
        "type": "launchpad_graduated"
      },
      "metrics": {
        "graduatedAt": "2025-08-05T12:31:03Z",
        "marketCap": 9866748.92,
        "liquidity": 850000,
        "holders": 20324,
        "price": 0.0106,
        "launchpad": "raydium",
        "mintAuthorityDisabled": true,
        "freezeAuthorityDisabled": true,
        "topHoldersPercentage": 15.2,
        "socialCount": 1,
        "priceChange1h": -2.1,
        "priceChange6h": 8.5,
        "priceChange24h": 12.3
      }
    }
  ]
}
```

#### Field Details

**Event Information**

* **event**: Always `"trending_token"` for trending token events
* **timestamp**: ISO 8601 timestamp when the event was detected

**Token Details**

* **symbol**: Token symbol (e.g., "BOSS")
* **address**: Solana token mint address

**Trigger Information**

* **type**: Always `"launchpad_graduated"` indicating token graduated from launchpad

**Token Metrics**

* **graduatedAt**: ISO 8601 timestamp when token graduated from launchpad
* **marketCap**: Current market capitalization in USD
* **liquidity**: Current liquidity pool value in USD
* **holders**: Number of unique token holders
* **price**: Current token price in USD
* **launchpad**: Name of the launchpad platform (e.g., "raydium, pump\_fun, etc.")
* **mintAuthorityDisabled**: `true` if mint authority revoked, `false` otherwise
* **freezeAuthorityDisabled**: `true` if freeze authority revoked, `false` otherwise
* **topHoldersPercentage**: Percentage of total supply held by top 10 holders
* **socialCount**: Number of verified social media accounts
* **priceChange1h**: Price change percentage over 1 hour window
* **priceChange6h**: Price change percentage over 6 hour window
* **priceChange24h**: Price change percentage over 24 hour window

## Data Sources

### Supported launchpads

New token events support the 40+ launchpads available on [Jupiter Pro](https://jup.ag/pro?tab=launchpads), including:

* pump.fun
* Letsbonk.fun
* BAGS
* Jupiter Studio
* & 40 more

## Detection Criteria

A variety of criteria must be met for an event to trigger, including familiar community "audit" filters, as well as additional analyses we have developed in-house to set a higher bar. Hundreds of tokens satisfy the audit criteria every day. Our added analysis sets a higher bar to just two to five daily.

### Community Audit Filters

All events must meet the familiar community "audit" filters:

* **✅ Mint Authority**: Revoked to prevent unlimited token creation.
* **✅ Freeze Authority**: Revoked to prevent account freezing.
* **✅ LP Burned**: Liquidity provider tokens burned for permanent liquidity.
* **✅ Holder Distribution**: Top 10 holders hold less than 20% of the total supply.
* **✅ Social Presence**: At least one verified social media account.

*Note: "Audit" refers to community trading terminology, not formal security audits.*

### Advanced Criteria

We employ an additional set of more advanced, in-house criteria to further filter the number of new token events per day. These include:

* **✅ Market cap**
* **✅ Liquidity**
* **✅ Price change**
* **✅ Trading volume change**

If you'd like to better understand what criteria we have in place, please reach out.

### Top-Down Tuning

Using the criteria above, we then apply a "top-down" tuning approach to achieve an ideal number of events per day, in this case two to five.