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 Botarrow-up-right 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.

circle-exclamation

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
circle-check

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

triangle-exclamation

🔹 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 Uniswaparrow-up-right. ✅ Try again after a few minutes in case of temporary API issues.

triangle-exclamation

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

triangle-exclamation
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.

triangle-exclamation

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

triangle-exclamation

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.

triangle-exclamation

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.

triangle-exclamation

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

triangle-exclamation

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


🔗 Go to Bot: BIG Pair Botarrow-up-right

📲Scan Barcode

Scan to Launch the Bot 🚀
circle-info

Need Help? Contact the bot adminarrow-up-right or check the BIG Ecosystemarrow-up-right channels for feature requests or issues.

Last updated