Bots EcosystemBIG Telegram
Page cover

🤖BIG Pair Bot

Why 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.

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:

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

Example Simplified Price Check Notification:

Getting Started

1

Invite the Bot

Add BIG Pair Bot to your Telegram group or use it in a private chat.

2

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.

3

Start the Bot

Bot started

  • Press on /get_pair to trigger /getpair@BIG_Pair_Bot

Uniswap pair and not Contract Address

  • Reply to the message with the pair address and v2 or v3.

Mind the space between the PAIR ADDRESS and the v2 or v3

0x4df1c47ecfbac8482a4811d373128e2acc007d02 v2 v3 if your token is on V3

Total Supply visible on Dextools or in your project tokenomics

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

10000000 No points or commas

Circulating Supply visible on Dextools or in your project tokenomics

  • Reply to the previous message with the circulating supply.

10000000 No points or commas

4

Confirmation Data

Bot /price output
5

Want to fetch the price again?

Call output once again
6

Simplified price version

Simplified price command output
7

The bot is rate-limited to prevent spam.

One request per minute
8

Other Commands

  • To cancel any ongoing process.

  • To reset any previous configurations and start all over.

Help menu
9

Need more help /docs@BIG_Pair_Bot

Go to Documentations

That’s it! The bot is ready to deliver instant Uniswap V2 & V3 token pair insights.

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

📌 Removing the Bot

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

Troubleshooting & Support

Invalid pair address or no data found. Please try again /get_pair.

🔹 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:

✅ Verify that the pair exists on Uniswap by searching it on Uniswap. ✅ Try again after a few minutes in case of temporary API issues.

Invalid input. Please provide the pair address and version (e.g., '0x... v2' or '0x... v3').

🔹 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:

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

Not Valid address!

Not valid warning

🔹 Cause:

  • The address provided is incorrect.

  • The address you provided is a contract address and not a pair address

🔹 Solution: ✅ Double check the address you provided. Use only a pair address.

No Uniswap pair address or version was found. Please provide one using the /get_pair command first.

🔹 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.

Market Cap & FDV Not Showing Correctly.

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.

Bot Not Responding to Commands.

🔹 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:

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

"Operation canceled. ⚠️ No configuration found to clear.

🔹 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.

This bot is designed for groups only.

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

groups only message

Future Improvements

Links

🔗 Go to Bot: BIG Pair Bot

📲Scan Barcode

Scan to Launch the Bot 🚀

Need Help? Contact the bot admin or check the BIG Ecosystem channels for feature requests or issues.

Last updated