Documentation

Everything you need to know about setting up and using TG Sniper.

Getting Started

TG Sniper automatically buys Solana tokens the moment a contract address (CA) is posted in a Telegram channel or group you're monitoring. The entire pipeline — from message detection to on-chain trade — is lightning fast, powered by Jito bundles.

Quick start in 4 steps:

1
Create an account
Sign up with your email and password at tgsniper.xyz.
2
Connect Telegram
Link your Telegram account via phone number verification. This lets TG Sniper read messages from your channels and groups.
3
Set up a wallet
Create a new Solana wallet or import an existing one. Fund it with SOL for trading.
4
Create a sniper job
Pick channels/groups to monitor, configure buy amount and exit strategy, then activate. TG Sniper does the rest.

Connecting Telegram

TG Sniper uses your Telegram account to monitor channels and groups in real-time. You connect once, and your session stays active until you disconnect.

How it works

You enter your phone number, receive a verification code on Telegram, and enter it on TG Sniper. If you have two-factor authentication (2FA) enabled, you'll also enter your password. That's it — one-time setup.

Session storage

Your Telegram session is encrypted with AES-256-GCM and stored securely. TG Sniper can only read messages — it never sends messages, joins channels, or modifies your account in any way.

Disconnecting

You can disconnect your Telegram account at any time from the Telegram settings page. This immediately stops all monitoring and deletes the stored session.

Note: You must be a member of the channels and groups you want to monitor. TG Sniper reads messages through your account, so it can only see what you can see.

Wallet Management

TG Sniper needs a Solana wallet to execute trades. You can create a fresh wallet or import an existing one using its private key.

Create wallet

Generates a new Solana keypair. The private key is encrypted with AES-256-GCM before being stored. You'll need to fund this wallet with SOL before trading.

Import wallet

Paste a base58-encoded private key to import an existing wallet. The key is encrypted immediately — it is never stored in plain text.

Withdrawing SOL

You can withdraw SOL from any wallet to an external address. Click Withdraw on the wallet page, verify your account password, enter the recipient address and amount (or tap 100% to send the full balance minus rent). A small rent-exempt reserve is always preserved to keep the account active on Solana.

Sniper Jobs

A sniper job is a configured task that monitors specific Telegram channels or groups and automatically buys tokens when a contract address is detected.

Job configuration

Buy Amount (SOL)
How much SOL to spend on each token buy.
Slippage
Maximum price slippage allowed for the trade. Higher slippage means more likely to fill but at a worse price. Default is 50%.
Jito Tip
SOL tip sent to Jito validators to prioritize your transaction in the block. Higher tip means faster inclusion.
Channels & Groups
Select which Telegram channels and groups to monitor. See the Channels & Groups section for details.
Exit Strategy
Optional automatic sell after a configurable delay. See Exit Strategies for details.
Duplicate Protection
Scrapes channel history on startup so you never buy a token that was previously called. See Duplicate Protection.

Tip: Jobs are created in a paused state. Review your settings on the confirmation screen, then activate when ready. You can pause and resume jobs at any time.

Channels & Groups

TG Sniper supports monitoring both broadcast channels and group chats. The detection method is automatically selected based on the channel type — you don't need to configure anything.

📢 Broadcast Channels

Channels where only admins can post (like alpha call channels). These are monitored using Telegram's difference API, which polls for new messages at high speed.

Examples: alpha call channels, signal channels, announcement channels

👥 Group Chats

Groups where multiple users can chat. These are monitored using real-time event delivery — messages are detected the instant they are sent, with zero delay.

Examples: trading groups, community chats, degen groups

How detection works

When a message is posted, TG Sniper scans it for Solana contract addresses (base58-encoded strings of 32–44 characters). It checks the message text, captions on photos/videos, embedded URLs, and webpage previews. If a valid CA is found and hasn't been seen before, the buy engine is triggered immediately.

User Filtering

For group chats, you can filter which users' messages trigger a buy. This is useful when you only want to follow specific callers in a busy group.

All users (default)
Any CA posted by any user in the group will trigger a buy.
Specific users
Only CAs posted by users you specify will trigger a buy. Add up to 5 Telegram usernames per group (e.g., @username). Messages from all other users are ignored.

Note: User filtering is only available for groups, not broadcast channels. In broadcast channels, only admins can post, so filtering isn't needed.

Exit Strategies

Each sniper job can have an automatic exit strategy that sells the token after a configurable delay.

Delay
How long to wait after buying before selling. Can be set in seconds, minutes, or hours.
Sell percentage
What percentage of the token position to sell. 100% sells everything, or sell a portion and keep the rest.
Sell slippage
Maximum slippage for the sell transaction. Default is 50%.

Tip: If you disable the exit strategy, you can sell manually at any time through your wallet or any Solana DEX.

Duplicate Protection

TG Sniper makes sure you never buy the same token twice from the same job.

History scraping
When a job is activated, TG Sniper scrapes up to 60 days of message history from each monitored channel and group. Any CAs found are marked as “already seen” so they won't trigger a buy.
Live deduplication
While running, every CA is tracked per job. If the same token is posted again — even across different channels in the same job — it is skipped automatically.

DEX Support

TG Sniper automatically detects which DEX a token is on and routes the trade accordingly. No manual configuration needed.

PumpSwap

Tokens that have graduated from the bonding curve and are trading on PumpSwap pools. TG Sniper reads pool accounts and executes swaps directly.

Pump.fun Bonding Curve

Tokens still on the Pump.fun bonding curve. TG Sniper detects this automatically and buys directly from the bonding curve contract.

How routing works

When a CA is detected, the buy engine fetches the token's accounts in a single RPC call. If a PumpSwap pool exists, it routes through PumpSwap. If only a bonding curve is found, it buys from the bonding curve. This detection adds minimal overhead to the trade.

Trade History

Every trade executed by TG Sniper is logged with full details.

Each trade record includes:

Token contract address
Buy or sell action
SOL amount
Platform fee
Transaction signature
Solscan link
Timestamp
Associated job

Filter trades by job or action type (buy/sell) and paginate through your full history.

Referral Program

Earn SOL by inviting others to TG Sniper. When someone signs up through your referral link and trades, you earn 50% of their trading fees — forever.

How it works

1
Activate referrals
Go to the Referral page and click “Activate Referrals”. A unique referral link is generated for your account.
2
Share your link
Send your referral link to friends. When they register through your link, their account is permanently linked to yours.
3
Earn fees
Every time a referred user makes a trade, 50% of the trading fee is credited to your referral balance automatically.
4
Claim earnings
Withdraw your referral balance to any Solana wallet at any time. Minimum claim is 0.001 SOL.

Details

Fee share
50% of trading fees
Duration
Lifetime — never expires
Minimum claim
0.001 SOL
Payout
Instant to any Solana wallet

Note: Referral earnings are tracked as a virtual balance and paid out from the platform fee wallet when you claim. The link between referrer and referred user is permanent and cannot be changed.

Fees & Limits

Trading fee

TG Sniper charges a 1% fee on every buy and sell transaction. This fee is added as a SOL transfer instruction within the same Jito bundle — there is no separate transaction. There are no subscription fees, no monthly charges, and no minimum balance requirements. You only pay when you trade.

Account limits

Sniper jobs
3 per account
Broadcast channels (total across all jobs)
3
Groups (total across all jobs)
10
User filters per group
5

Security

TG Sniper is built with security as a priority.

Encrypted storage
All wallet private keys and Telegram sessions are encrypted with AES-256-GCM before being stored in the database.
Password hashing
Account passwords are hashed with bcrypt. They are never stored in plain text.
Rate limiting
Login, registration, Telegram connection, and withdrawal endpoints are all rate limited to prevent abuse.
Withdrawal protection
Every withdrawal requires your account password. Withdrawals are rate limited.
HTTPS only
All traffic is encrypted with SSL/TLS. Security headers including HSTS, CSP, and X-Frame-Options are enforced.