# Raidboard

The **Raidboard** is designed to track and showcase community-driven engagement efforts outside the Telegram group, particularly on X (Twitter). It works similarly to the [Leaderboard](/tgmetrics-bot/markdown.md) in terms of how to use it and the available filters, but it focuses on tracking interactions on X rather than Telegram messages. It allows communities to measure engagement beyond Telegram and recognize members who actively promote the project.

<figure><img src="/files/AcYBuSmjXj7YvWbEly5y" alt="" width="406"><figcaption><p>Today's raidboard</p></figcaption></figure>

### How it works

* The bot monitors users participating in X raids—likes, retweets, and mentions supporting the community.
* To access the Raidboard, use the command `/raidboard` in your Telegram group. You'll instantly see the ranking of top contributors for today.
* Want to check the Raidboard for a specific date? Use `/raidboard YYYY-MM-DD` (e.g., `/raidboard 2025-02-21`).
* Need an overview of a date range? Use `/raidboard YYYY-MM-DD YYYY-MM-DD` (e.g., `/raidboard 2025-01-01 2025-01-20`) to see the total points accumulated over that period.
* The Raidboard ranks members based on their contribution to these external activities.
* This feature helps community owners measure and incentivize outreach efforts beyond Telegram.
* To check the Raidboard, use the command: `/raidboard`.

### How Raidboard Points Are Calculated

To ensure fairness and accuracy, we assign points based on different types of engagement:

* **2 points** for comments on X (Twitter).
* **3 points** for retweets.

### Important :warning:

To ensure that the TgMetrics bot detects when a raid has started, always use the raid bot command alongside the X post. We understand that some bots can identify when an X post is sent in the chat and automatically trigger a raid. However, TgMetrics only processes posts that are used in conjunction with the raid command for these bots.

{% hint style="info" %}
Please note that the Raidboard can take up to **12 hours** to reflect new interactions.
{% endhint %}

We are continuously refining this scoring system to provide better engagement tracking and reward meaningful contributions effectively.


---

# 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://docs.tgmetrics.ai/tgmetrics-bot/images-and-media.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.