Skip to main content

📈 Crypto Price Feed

The Crypto Price Feed feature allows your community to track token prices and set alerts for specific price levels. It supports customization of price update messages and offers flexible posting modes to keep your community informed about market movements.

Overview

Crypto Price Feed provides:

  • Real-Time Price Tracking: Monitor cryptocurrency prices across thousands of tokens
  • Custom Price Messages: Design branded price updates with placeholders and media
  • Flexible Posting Modes: On-command or automated interval updates
  • Price Alerts: Get notified when tokens reach specific price thresholds
  • Multi-Token Support: Track multiple tokens simultaneously
  • Interactive Messages: Add buttons and links to price updates
Price Data Source

Price data is sourced from reliable market data providers and updated in real-time, covering thousands of cryptocurrencies across major exchanges.

How to Configure the Crypto Price Feed

Admins can open price-feed configuration with /price_feeds. Members typically request spot checks with /price (when you enable on-command mode).

To access Crypto Price Feed settings:

  1. Use the /settings command in your chat
  2. Navigate to 🌐 Web3📈 Crypto Price Feed
  3. Toggle the feature 🟢 Enabled or 🔴 Disabled
  4. Configure tokens and their settings

Adding a Token

Add a new token to track its price and receive updates.

Steps:

  1. Navigate to Price SettingsManage Feeds➕ Add Token
  2. Enter the token symbol (e.g., btc, eth, sol)
  3. Press Enter to confirm

Token symbol examples:

btc - Bitcoin
eth - Ethereum
bnb - Binance Coin
sol - Solana
matic - Polygon
ada - Cardano
dot - Polkadot
Finding Token Symbols

Visit coingecko: https://www.coingecko.com/ for symbol lookup

If token is not found:

Token not found.

Common issues:

  • Incorrect symbol spelling
  • Token not listed on major exchanges
  • Using full name instead of symbol (or vice versa)
  • Including prefixes that should be omitted

Tip: For wrapped tokens, remove the "w" prefix (e.g., enter btc instead of wbtc).

Managing Tokens

Once a token is added, you can configure its settings and behavior.

To manage tokens:

  1. Navigate to Manage Feeds
  2. Select the token you want to configure
  3. Choose from the following options:

Viewing Current Tokens

The main screen displays all tracked tokens:

Example display:

ETH

Click on a token to access its management options.

Token Configuration Options

Toggle the token 🟢 Enabled or 🔴 Disabled

Activate or deactivate scheduled price updates for this token.

Set Price Message

Define the format of the price update message with custom branding and dynamic placeholders.

Steps:

  1. Select your token from Manage Tokens
  2. Click Set Price Message
  3. Compose your custom message

Dynamic Placeholders:

  • {ticker} or {token} - ticker for this token.
  • {price} - current price.
  • {market_cap} - market capitalization (formatted).
  • {volume_24h} - 24h trading volume (formatted).
  • {change_24h} - 24h price change percentage.
  • {change_1h} - 1h price change percentage.
  • {change_7d} - 7d price change percentage.
  • {rank} - market rank.

Message customization options:

  • Text: Write any text around the placeholders
  • Media: Include images or videos
  • Formatting: Use Telegram markdown (bold, italic, etc.)
  • Buttons: Add interactive buttons with links
  • Emojis: Enhance visual appeal

Example price messages:

Simple:

`{token_symbol}` is currently `${price}`

Branded:

📊 `{token_symbol}` Price Update

Current Price: `${price}`

Stay informed with our price feed!

With emoji and formatting:

🚀 **`{token_symbol}`** Price Alert!

💰 Current: `${price}`
📈 Track more at our website!
Professional Messages

Create branded price messages that match your community's aesthetic. Include your project logo as an image and add buttons linking to your website, DEX, or trading page.

Adding buttons: Include inline buttons with your message for quick access:

Label | URL

🔗 Buy on Uniswap | https://uniswap.org
📊 View Chart |https://dextools.io

Interval

Set the bot to post updates automatically at regular intervals.

How it works:

  1. Configure posting interval (e.g., every hour)
  2. Bot automatically posts price updates
  3. Updates appear at scheduled times
  4. No member action required

Set Alert

Configure an alert for when the token price meets a specific level.

Alert types: Format: above price or below price (e.g., above 30000). Example: above 20000 means alert me if price goes above $20,000.

Price Above Threshold:

Alert when `{token_symbol}` > $50,000
→ Triggers when price rises above $50,000

Price Below Threshold:

Alert when `{token_symbol}` < $40,000
→ Triggers when price drops below $40,000

Multiple Alerts: Set multiple price alerts for the same token:

  • Upper threshold: Alert at $50,000
  • Lower threshold: Alert at $40,000
  • Result: Get notified of significant movements in either direction

Remove Token

Remove the token from the price feed if it's no longer needed.

Steps:

  1. Select your token from Manage Feed
  2. Click Remove Token
  3. Confirm deletion

Set Default Token

Set a default token for the /price command. When set, users can use /price without specifying a token.

Admin Commands

CommandDescription
/price [ticker]Show the current price for a token (e.g., /price btc)
/price_feedsOpen the price feed configuration panel
Troubleshooting

Token not found when adding?

  • Verify symbol spelling (case-insensitive)
  • Try alternative symbol names
  • Remove prefixes (e.g., use btc not wbtc)
  • Search CoinGecko for exact symbol
  • Try token full name instead of symbol

Price updates not posting?

  • Check bot has permission to post messages
  • Ensure bot is not restricted or muted
  • Test with command mode
  • Review interval setting if using Interval mode
  • Verify price message template is valid

Alerts not triggering?

  • Check alert threshold is set correctly
  • Verify price has actually crossed the threshold
  • Ensure bot has posting permissions in target location
  • Review alert configuration for the token
  • Test with easily achievable threshold first

Price message looks broken?

  • Check placeholders are spelled correctly: {token_symbol} or {price}
  • Verify markdown formatting is valid
  • Test without media first, then add images
  • Ensure button syntax is correct

Wrong price being displayed?

  • Verify correct token symbol is configured
  • Check token hasn't been delisted or renamed
  • Compare with CoinGecko/CoinMarketCap
  • Remove and re-add token if necessary