Home

BlueClaw Documentation

Getting Started

BlueClaw is a Telegram bot that tracks PumpFun token graduations and provides real-time on-chain signals. Follow these steps to set up BlueClaw in your group.

Step 1: Add the Bot

Click the button below to open BlueClaw in Telegram, then add it to your group.

Add @BlueClawCallsBot

Step 2: Promote to Admin

BlueClaw needs admin permissions to post signals. Go to your group settings and promote the bot:

  • Open Group Info → Administrators
  • Add @BlueClawCallsBot as admin
  • Enable "Post Messages" permission

Step 3: Configure Settings

Use the /config command to customize your settings:

/config
You're all set! BlueClaw will now scan for PumpFun graduations and send signals to your group based on your configured policy.

Commands Reference

Complete list of all available BlueClaw commands.

/start

Initialize the bot and display welcome message

/help

Show all available commands and their descriptions

/scan

Manually scan for new PumpFun graduations

/alpha

Get the latest high-confidence alpha signal

/signals

View recent signals posted by the bot

/lastcall

Display the most recent call made

/status

Check bot status, uptime, and configuration

/config

Open configuration panel with inline buttons

/setrisk <1-10>

Set minimum confidence score for signals

/autopost

Toggle automatic signal posting on/off

/policy

View and change policy presets

/mute

Temporarily mute all signals

/unmute

Resume signal posting

Signal Analysis Commands

Advanced on-chain analysis commands for deeper token insights.

/whale <mint>

Track whale wallet activity for any token. Shows accumulation patterns, distribution signals, and large holder movements.

/whale So11111111111111111111111111111111111111112
Output includes: Top 10 holder concentration, whale accumulation/distribution status, largest holder size, and time since last major movement.

/holders <mint>

Deep dive into token holder distribution. Analyze holder growth, concentration risk, and LP status.

/holders EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

/fresh

List the most recent PumpFun graduations within the last 15 minutes. Perfect for catching early entries.

/fresh

/momentum <mint>

Technical momentum analysis including volume trends, price action, and buy/sell ratios.

/momentum TokenMintAddress123

/risk <mint>

Comprehensive risk assessment including LP lock status, mint authority, freeze authority, and holder concentration.

/risk TokenMintAddress123

Policy Presets

BlueClaw includes 6 pre-configured policy presets optimized for different trading styles.

Default

Medium Risk

Balanced settings for most groups. Good mix of opportunity and safety.

Min Score: 7/10Max Age: 30m

Aggressive

High Risk

Early entry focus. Higher risk tolerance for potentially bigger gains.

Min Score: 5/10Max Age: 45m

Conservative

Low Risk

Safety first. Only signals tokens with proven metrics and lower risk.

Min Score: 8/10Max Age: 20m

Degen

Very High Risk

Maximum exposure. Catches everything, relies on speed over safety.

Min Score: 4/10Max Age: 60m

Sniper

Medium-High Risk

Quick entries on fresh grads only. Time-sensitive signals.

Min Score: 6/10Max Age: 15m

Whale

Medium Risk

Focuses on tokens with significant whale accumulation patterns.

Min Score: 7/10Max Age: 30m
Change your policy anytime using /policy. The new settings apply immediately to all future signals.

Autopost System

BlueClaw continuously scans for PumpFun graduations and automatically posts signals that match your configured policy.

How It Works

  1. 1
    Continuous Scanning

    BlueClaw monitors DexScreener for new PumpFun token graduations 24/7.

  2. 2
    Scoring & Filtering

    Each token is scored based on liquidity, holder distribution, volume, and on-chain metrics.

  3. 3
    Policy Matching

    Tokens that meet your policy's minimum score and filters are sent as signals.

  4. 4
    Signal Delivery

    Formatted call cards are posted to your group with all relevant data and quick-action buttons.

Rate Limits: To prevent spam, autopost has a cooldown period between signals. High-quality signals are prioritized.

Scoring Algorithm

Every token receives a confidence score from 1-10 based on multiple on-chain factors.

FactorWeightDescription
Liquidity25%Total liquidity in USD and LP token distribution
Holder Distribution20%Top holder concentration and growth rate
Volume20%24h trading volume and buy/sell ratio
Token Age15%Time since graduation (fresher = higher score)
Security10%Mint/freeze authority, LP lock status
Social Signals10%Website, Twitter, Telegram presence

Admin Configuration

Only group admins can modify BlueClaw settings. Here's how to configure your bot.

Configuration Options

/setrisk 8

Set minimum score to 8/10. Only high-confidence signals will be posted.

/autopost

Toggle automatic posting. Disable to only receive manual scans.

/policy

Switch between preset policies (Default, Aggressive, Conservative, etc.)

/mute

Temporarily pause all signals without changing settings.

API Reference

BlueClaw exposes a webhook endpoint for receiving Telegram updates. For custom integrations, contact us on Telegram.

Webhook Endpoint

POST /api/telegram/webhook

The webhook receives updates from Telegram and processes commands. Authentication is handled via the X-Telegram-Bot-Api-Secret-Token header.

Coming Soon: Public API for querying token scores, graduation history, and whale tracking data. Join our Telegram for updates.