# BIG Crypto Heatmap Bot

## **Why BIG Crypto Heatmap Bot?**

Visualizing cryptocurrency market trends across hundreds of tokens can be challenging. Tracking price movements, market capitalization, and dominance shifts require checking multiple platforms and analyzing complex data, making it difficult to get an immediate sense of market conditions.

💡 **The Solution:** BIG Crypto Heatmap Bot delivers intuitive visual representations of the crypto market directly in Telegram. Users can instantly view color-coded heatmaps and treemaps showing price movements, market dominance, and relative token sizes with simple commands, providing immediate visual insights without leaving the platform.

***

## **Features**

✅ **Circular Heatmap** → 60 visual bubble charts showing cryptos as circles with sizes based on market cap and colors indicating price changes.\
✅ **Rectangular Treemap** → 40 hierarchical visualizations showing market sectors with proportional sizing based on dominance.\
✅ **Real-time Market Data** → Up-to-date data from CoinGecko API.\
✅ **Color-Coded Indicators** → Intuitive color gradients show price movements (green for gains, red for losses).\
✅ **Market Dominance Metrics** → Visual representation of cryptocurrency market dominance.\
✅ **Group-Optimized Design** → Specifically designed for use in Telegram groups.

***

## **How It Works**

1️⃣ **Add the bot to your group and give it appropriate permissions.**\
2️⃣ **Use one of the visualization commands:**

* `/heat@BIG_HEATMAP_BOT` - Generate circular heatmap
* `/rheat@BIG_HEATMAP_BOT` - Generate rectangular treemap

3️⃣ **The bot processes market data and generates a high-quality visualization image showing:**

* Cryptocurrency symbols, prices, and 24-hour changes
* Visual representation of market capitalization through size
* Color-coding indicating market movements
* Market dominance percentages for top cryptocurrencies

#### **Example Reply:**

#### **Circular Heatmap (**`/heat@BIG_HEATMAP_BOT`**)**

The circular heatmap displays cryptocurrencies as bubbles where:

* **Size** represents market capitalization
* **Position** places larger cryptocurrencies toward the center
* **Color** indicates 24-hour price change:

<figure><img src="/files/F3f2ab3jl06EF1gE5ecF" alt="" width="563"><figcaption><p>Color indicators</p></figcaption></figure>

#### **Rectangular Treemap (**`/rheat@BIG_HEATMAP_BOT`**)**

The treemap organizes the market into rectangles where:

* **Size** represents market capitalization
* **Layout** places major cryptocurrencies (BTC, ETH) in prominent positions
* **Color** uses the same coding system as the heatmap
* **Text** shows the symbol, price, change percentage, and dominance for major cryptocurrencies

***

## **Getting Started**

{% stepper %}
{% step %}

#### **Invite the Bot**

* Add [**BIG Crypto Heatmap Bot**](https://t.me/BIG_HEATMAP_BOT) to your Telegram group.
  {% endstep %}

{% step %}

#### **Minimum Administrative Privileges Required**

*Grant only the minimum necessary permissions to prevent the bot from being deleted or banned by other bots.*

* The bot will automatically ask for the required permissions.
* Add the bot as an admin and confirm.
* The bot is at risk without admin rights.

<figure><img src="/files/I4ko6LHqtMbOpLwDkn5w" alt="" width="269"><figcaption><p>Required permissions</p></figcaption></figure>
{% endstep %}

{% step %}

#### **Start the Bot**

```
/start@BIG_HEATMAP_BOT
```

<figure><img src="/files/UJTG3f5WNrXNu733fa2H" alt=""><figcaption><p>Bot Started</p></figcaption></figure>

**Generate Visualizations**

```
/heat@BIG_HEATMAP_BOT
```

<figure><img src="/files/ZAMHdQ7R8IpnGKBxpnW6" alt=""><figcaption><p>Circular cryptocurrency market heatmap</p></figcaption></figure>

or

```
/rheat@BIG_HEATMAP_BOT
```

<figure><img src="/files/MuawMP8TRFfsubcV6PRV" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
That's it! The bot will now provide market visualizations on demand.
{% endhint %}
{% endstep %}

{% step %}

#### **Need more help?**

```
/help@BIG_HEATMAP_BOT
```

<figure><img src="/files/XDOccdWumtDv4KlVA9Y7" alt=""><figcaption><p>Help menu</p></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## **Usage Limits**

To prevent spam and ensure fair usage among all groups:

* Each visualization command (`/heat` or `/rheat`) can only be used once every 15 minutes in a given group
* If you attempt to use a command before the cooldown period has elapsed, the bot will inform you how much time remains

***

## **Administration & Management**

📌 **Removing the Bot**

* Any **admin** can remove the bot in the same way they would remove a regular member.

***

## **Troubleshooting & Support**

{% hint style="danger" %}
**Bot not responding?**
{% endhint %}

* Check if the bot has **been started** with `/start@BIG_HEATMAP_BOT`
* Check if administrative privileges have been granted.

{% hint style="danger" %}
**This bot is designed for groups only.**
{% endhint %}

* This bot functions primarily in groups. Create a group to add the bot or invite it to any of your existing groups.

<figure><img src="/files/7WDQ1kIDdVddGX4XGRye" alt=""><figcaption><p>Groups only message</p></figcaption></figure>

{% hint style="danger" %}
**Is visualizationVisualization not appearing?**
{% endhint %}

* Try again later, as there might be temporary API connectivity issues.
* Contact the bot developer or the BIG Ecosystem team.

{% hint style="danger" %}
**Outdated data?**
{% endhint %}

* The bot fetches real-time data from CoinGecko; temporary delays may occur during high market volatility.

{% hint style="danger" %}
**Bot still not replying?**
{% endhint %}

* Note that the bot can only be configured by admins or group owners.
* Contact the [bot developer](https://t.me/MalkaKing) or the [BIG Ecosystem team](https://t.me/BigEcosystemOfficial).

***

## **Technical Information**

* Data Source: CoinGecko API (updated in real-time).
* Visualization: Generated using matplotlib.
* The top 60 cryptocurrencies by market capitalization are included.
* Sixty tokens are shown using circles, and 40 using a tree map.
* Images are generated with the highest resolution possible on Telegram for better readability.

***

## **Future Improvements**

* [ ] Customizable Visualizations → Choose specific tokens or market sectors to highlight.
* [ ] Daily Summary Images → Scheduled market visualizations at set intervals.
* [ ] DeFi-Focused Views → Specialized visualizations for DeFi protocols.
* [x] Integration with other BIG Ecosystem bots. Check [@BIG\_Analysis\_Bot](/big-ecosystem-bots-docs/sentiment-and-analysis/big-analysis.md)
* [ ] Ads Integration.

***

## **Links** <a href="#links" id="links"></a>

🔗 **Go to Bot:** [BIG Heat Map Bot](https://t.me/BIG_HEATMAP_BOT)

**📲Scan Barcode**

<div align="left"><figure><img src="/files/4ILNHJ54k6kNBrkXBq9P" alt="" width="203"><figcaption><p><strong>Scan to Launch the Bot</strong> 🚀</p></figcaption></figure></div>

{% hint style="info" %}
***Need Help?** Contact the bot* [*admin*](https://t.me/MalkaKing) *or check the* [*BIG Ecosystem*](https://t.me/BigEcosystemOfficial) *channels for feature requests or issues.*
{% endhint %}


---

# 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://big-ecosystem-bots.gitbook.io/big-ecosystem-bots-docs/big-crypto-heatmap-bot.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.