# BIG Pair Bot

## W**hy BIG Pair Bot?**

Tracking Uniswap token pairs manually can be time-consuming and unreliable. Traders need a quick way to fetch real-time token prices, liquidity, and market data without navigating multiple platforms.

💡 **The Solution:** BIG Pair Bot offers instant token pair data from Uniswap V2 and V3, enabling users to access real-time prices, liquidity, total token holders, and market cap details directly in Telegram with a simple command.

***

## **Features**

✅ **Supports Uniswap V2 & V3** → Fetch token data from both Uniswap versions.\
✅ **Instant Price Fetching** → Get real-time token price in ETH & USD.\
✅ **Liquidity Pool Data** → View total liquidity and pooled tokens.\
✅ **Market Cap & FDV** → Monitor circulating market cap and fully diluted valuation.\
✅ **Minimal Setup** → Just enter the Uniswap pair address to get data instantly.\
✅ **Rate-Limited for Fair Use →** Only one message per command is allowed every minute.<br>

***

## **How It Works**

1️⃣ **User types** `/price@BIG_Pair_Bot` **in the chat.**\
2️⃣ **The bot fetches real-time pair data and replies with:**

* **Token Name & Ticker**
* **Price in ETH & USD**
* **Total Liquidity & Pooled Tokens**
* **Market Cap & Fully Diluted Valuation (FDV)**
* **Whether the token is on Uniswap V2 or V3**

#### **Example Price Check Notification:**

```
📊 Token Details 📊  
🔹 Token Name: Connect  
🔹 Ticker: CNCT  
🔹 Uniswap Version: V3  

💰 **Pooled Liquidity**  
🔹 Pooled CNCT: 7,455,415  
🔹 Pooled WETH: 26.30  

🔄 **Exchange Rates**  
🔹 1 WETH = 283,504 CNCT  
🔹 1 CNCT = 0.00000353 ETH  
🔹 1 CNCT = $0.0078 USD  
🔹 ETH Price: $2,214  

📈 **Market Metrics**  
🔹 Circulating Supply: 80,000,000 CNCT  
🔹 Total Supply: 100,000,000 CNCT  
🔹 Market Cap: $624,624  
🔹 FDV: $780,780  

Powered by: BIG Ecosystem  

```

**Simplified version**

1️⃣ **User types** `/sprice@BIG_Pair_Bot` **in the chat.**\
2️⃣ **The bot fetches real-time pair data and replies with:**

* **Token Name**
* **Total Holders**
* **Token Price**
* **Market Cap**&#x20;

#### **Example** Simplified **Price Check Notification:**

```
🪙 Token Name: Connect
👥 Holders: 976
💰 Token Price: $0.006569
🏦 Market Cap: $656,875

Powered by: BIG Ecosystem  
```

***

## **Getting Started**

{% stepper %}
{% step %}

#### **Invite the Bot**

Add [**BIG Pair Bot**](https://t.me/BIG_Pair_Bot) to your Telegram group or use it in a private chat.
{% 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/gXPJbN9vKkP5Y6Zm46OW" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### **Start the Bot**

```
/start@BIG_Pair_Bot
```

<figure><img src="/files/VaNiNRMuoWO3LR865HAP" alt=""><figcaption><p>Bot started</p></figcaption></figure>

* Press on `/get_pair` to trigger `/getpair@BIG_Pair_Bot`

<figure><img src="/files/8t3mYo925urMHD41rati" alt=""><figcaption><p>Uniswap pair and not Contract Address</p></figcaption></figure>

* Reply to the message with the pair address and v2 or v3.&#x20;

{% hint style="warning" %}
Mind the space between the <mark style="color:red;">**PAIR ADDRESS**</mark> and the v2 or v3
{% endhint %}

0x4df1c47ecfbac8482a4811d373128e2acc007d02  `v2` <mark style="background-color:red;">v3 if your token is on V3</mark>

<figure><img src="/files/0qShd71qTpRyEfAQUEwA" alt=""><figcaption><p>Total Supply visible on Dextools or in your project tokenomics</p></figcaption></figure>

* Reply to the previous message with the total supply message.

`10000000`  <mark style="background-color:red;">No points or commas</mark>

<figure><img src="/files/gaxrvDD26yZMiesLMD3j" alt=""><figcaption><p>Circulating Supply visible on Dextools or in your project tokenomics</p></figcaption></figure>

* Reply to the previous message with the circulating supply.

`10000000`  <mark style="background-color:red;">No points or commas</mark>
{% endstep %}

{% step %}
**Confirmation Data**&#x20;

<figure><img src="/files/VpHsEnppEIod6SIUPYg7" alt=""><figcaption><p>Bot /price output</p></figcaption></figure>
{% endstep %}

{% step %}

### Want to fetch the price again?

```
/price@BIG_Pair_Bot
```

<figure><img src="/files/VpHsEnppEIod6SIUPYg7" alt=""><figcaption><p>Call output once again</p></figcaption></figure>
{% endstep %}

{% step %}

### Simplified price version

<pre><code><strong>/sprice@BIG_Pair_Bot
</strong></code></pre>

<figure><img src="/files/oXBUpYf4KX8naBdIFhfZ" alt=""><figcaption><p>Simplified price command output</p></figcaption></figure>
{% endstep %}

{% step %}
The bot is **rate-limited** to prevent spam.

<figure><img src="/files/7ECYCiFuAqqddsVGITJo" alt=""><figcaption><p>One request per minute</p></figcaption></figure>
{% endstep %}

{% step %}

### Other Commands

```
/cancel@BIG_Pair_Bot
```

* To cancel any ongoing process.

```
/clear_config@BIG_Pair_Bot
```

* To reset any previous configurations and start all over.

```
/help@BIG_Pair_Bot
```

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

{% step %}

### Need more help `/docs@BIG_Pair_Bot`

<figure><img src="/files/WwgBqSBKwFf6GASayPr5" alt=""><figcaption><p>Go to Documentations</p></figcaption></figure>

{% hint style="success" %}
That’s it! The bot is ready to **deliver instant Uniswap V2 & V3 token pair insights**.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## **Usage Limits**

To prevent spam and ensure fair usage among all groups:

* Each visualization command (`/price` or `/sprice`) can only be used once every minute 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** <a href="#administration-and-management" id="administration-and-management"></a>

📌 **Removing the Bot**

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

***

## **Troubleshooting & Support**

{% hint style="danger" %}
**Invalid pair address or no data found. Please try again /get\_pair.**
{% endhint %}

🔹 **Cause:**

* The Uniswap pair address entered is incorrect.
* The token pair does not exist on Uniswap V2 or V3.

🔹 **Solution:**\
✅ Make sure you enter the **correct** Uniswap pair address using this format:

```
0xYourPairAddress v2  
0xYourPairAddress v3
```

✅ Verify that the pair exists on **Uniswap** by searching it on [Uniswap](https://app.uniswap.org/).\
✅ Try again after a few minutes in case of temporary API issues.

{% hint style="danger" %}
**Invalid input. Please provide the pair address and version (e.g., '0x... v2' or '0x... v3').**
{% endhint %}

🔹 **Cause:**

* The format used for entering the pair address is incorrect.
* Missing Uniswap version (`v2` or `v3`).

🔹 **Solution:**\
✅ Reply with the correct format when after pressing on `/get_pair`:

```
0xYourPairAddress v2  
0xYourPairAddress v3
```

✅ Ensure there are **no spaces before or after** the pair address.

{% hint style="danger" %}
**Not Valid address!**
{% endhint %}

<figure><img src="/files/gzekX3ciSM8hDB118acC" alt=""><figcaption><p>Not valid warning</p></figcaption></figure>

🔹 **Cause:**

* The address provided is incorrect.
* The address you provided is a <mark style="color:red;">**contract address**</mark> and not a <mark style="color:green;background-color:red;">**pair address**</mark>

🔹 **Solution:**\
✅ Double check the address you provided. Use only a pair address.&#x20;

{% hint style="danger" %}
**No Uniswap pair address or version was found. Please provide one using the /get\_pair command first.**&#x20;
{% endhint %}

🔹 **Cause:**

* The provided pair address does not exist on Uniswap or is not supported.
* The bot does not have a stored pair address for the user.
* The user is trying to check the price without setting up a pair.

🔹 **Solution:**\
✅ Confirm the pair is available on **Uniswap** before entering it.\
✅ `/start@BIG_Pair_Bot` Press on `/get_pair` command again, and enter a new pair of addresses.

{% hint style="danger" %}

#### **Market Cap & FDV Not Showing Correctly.**

{% endhint %}

**Issue:**

* The Market Cap or Fully Diluted Valuation (FDV) values appear incorrect.
* The token price seems off compared to Uniswap.

🔹 **Cause:**

* Incorrect **total supply** or **circulating supply** entered by the user.
* Uniswap API updates may cause data delays.

🔹 **Solution:**\
✅ When asked for total supply and circulating supply, enter the **correct** values.\
✅ If incorrect data is displayed, reset the configuration using `/clear_config@BIG_Pair_Bot` and enter the values again.

{% hint style="danger" %}

#### **Bot Not Responding to Commands.**

{% endhint %}

🔹 **Cause:**

* Telegram is experiencing downtime.
* The command is mistyped or not recognized.
* The user has not set a pair before using `/price@BIG_Pair_Bot`.
* Check if administrative privileges have been granted.

🔹 **Solution:**\
✅ Restart the bot using `/start@BIG_Pair_Bot`.\
✅ Ensure the command is spelled correctly:

```
/price@BIG_Pair_Bot
```

✅ Set up a pair address first by pressing `/get_pair` before using `/price@BIG_Pair_Bot`.

{% hint style="danger" %}

#### **"**&#x4F;peration canceled. ⚠️ No configuration found to clear.

{% endhint %}

🔹 **Cause:**

* The user tried to cancel when there was no active process.
* No pair address was set before using `/clear_config@BIG_Pair_Bot`.

🔹 **Solution:**\
✅ If entering a pair, **follow the entire process** and enter all required details.\
✅ If using `/clear_config@BIG_Pair_Bot`, ensure you set a pair before clearing the configuration.

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

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

<figure><img src="/files/cDn82gwwFJTwq7pJ5o4j" alt=""><figcaption><p>groups only message</p></figcaption></figure>

***

## **Future Improvements**

* [x] Add token holders.
* [x] Display the token chart along with the data when the `/price` function is called.
* [x] Create a shorter version of the`/price` command with less data.
* [ ] Auto-Pair Detection → Automatically find the pair address even if the CA of a token is provided.
* [ ] Price Alerts → Notify users when a token crosses a specific price threshold.
* [ ] Multi-DEX Support → Expand beyond Uniswap to include SushiSwap, PancakeSwap, etc.
* [ ] Liquidity Trend Analysis → Track liquidity changes over time.
* [ ] Integration with other BIG Ecosystem bots.
* [ ] Ads Integration.

***

## **Links**

🔗 **Go to Bot:** [BIG Pair Bot](https://t.me/BIG_Pair_Bot)

#### 📲Scan Barcode

<div align="left"><figure><img src="/files/2Z5My5xFPLVPUaEbSDSY" alt="" width="188"><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/market-and-price-tracking/big-pair-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.