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.

Where to configure it​

In the webapp: Open your workspace, select the Telegram group under Channels in the sidebar, then select Web3, then the Price Feeds tab. Changes save with the Save bar at the bottom of the page.

In Telegram (bot menu): the /settings menus described below still work.

Overview​

Track token prices in your group: members can ask for a price on command, the agent can post updates on an interval, and you can set price alerts. Each token's price message can use placeholders, media and buttons.

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 Settings → Manage 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