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

# Alerts

> Fired trading alerts — by mint, most recent, and top ranked

All alert queries return the same `Alert` shape:

```graphql theme={null}
type Alert {
  id: String!
  mint: String!
  createdAt: String
  totalVolumeSol: Float!
  tradeCount: Int!
  priceChangePercentage: Float!
  avgPrice: Float!
  platform: String
  name: String
  symbol: String
  uri: String
}
```

***

## `alertsByMint`

Historical alerts fired for a specific mint, newest first.

### Arguments

| Name     | Type     | Required | Description                      |
| -------- | -------- | -------- | -------------------------------- |
| `mint`   | `String` | yes      | Token mint address (≥ 32 chars). |
| `limit`  | `Int`    | no       | Default `100`, max `1000`.       |
| `offset` | `Int`    | no       | Default `0`.                     |

### Example

```graphql theme={null}
query {
  alertsByMint(mint: "So11111111111111111111111111111111111111112", limit: 20) {
    id createdAt totalVolumeSol tradeCount priceChangePercentage
  }
}
```

***

## `recentAlerts`

Most recent alerts across all mints.

### Arguments

| Name     | Type  | Required | Description                |
| -------- | ----- | -------- | -------------------------- |
| `limit`  | `Int` | no       | Default `100`, max `1000`. |
| `offset` | `Int` | no       | Default `0`.               |

### Example

```graphql theme={null}
query {
  recentAlerts(limit: 50) {
    id mint name symbol createdAt totalVolumeSol priceChangePercentage
  }
}
```

***

## `topAlerts`

Highest-ranked alerts by volume / impact over a fixed period. Omit `period` for the all-time top list.

### Arguments

| Name     | Type     | Required | Description                                               |
| -------- | -------- | -------- | --------------------------------------------------------- |
| `limit`  | `Int`    | no       | Default `100`, max `1000`.                                |
| `period` | `String` | no       | `"daily"`, `"weekly"`, or `"monthly"`. Omit for all-time. |

### Example

```graphql theme={null}
query {
  topAlerts(limit: 20, period: "daily") {
    id mint name symbol totalVolumeSol tradeCount
  }
}
```