> For the complete documentation index, see [llms.txt](https://big-ecosystem-bots.gitbook.io/big-ecosystem-bots-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://big-ecosystem-bots.gitbook.io/big-ecosystem-bots-docs/market-and-price-tracking/big-pair-bot.md).

# 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 %}