BlockchainLaunchSniper User Guide

Here you can find all the information you need to setup and use BlockchainLaunchSniper. Current guide has been updated for BlockchainLaunchSniper v2.0.6 Beta.

Prerequisites

A Windows, Mac, or Linux computer
A reasonably fast internet connection
An ethereum-based wallet address and private key (not seed phrase)
A blockchain node (either use a free node or a private/full node)
Enough crypto in your wallet to snipe tokens / pay gas fees (and other paired tokens if you choose a different liquidity pair address, eg. BUSD)
A tier (if you haven’t got a tier yet, get one here).

Make sure that the wallet you are using is the same wallet that you have used to buy a tier.

How to install / run

Download the latest version of the bot from the downloads page if you haven’t done so already.
Unzip the bot files into a new folder.
Windows:
- Edit the config.json file with your parameters.
- In command prompt, navigate to the bot folder and run: BlockchainLaunchSniper-<version>.exe
Mac:
- Edit the config.json file with your parameters.
- In terminal, navigate to the bot folder and run: ./BlockchainLaunchSniper-<version>
- (If you have permission issues, you may need to go into Security and Privacy in system preferences and allow the BlockchainLaunchSniper to run)
Linux:
- Edit the config.json file with your parameters.
- Navigate to the bot folder in terminal and run: ./BlockchainLaunchSniper-<version>

Replace <version> with the executable version you are using, for example: ./BlockchainLaunchSniper-macos-arm64

Config settings

Parameter	Meaning
walletAddress	Your wallet’s address.
walletPrivateKey	Private key for your wallet.
blockchainNode	Blockchain node URL.
routerAddress	Router address of the exchange you wish to snipe on (to find router addresses, go to supported blockchains / DEXs).
txType	The transaction type identifier. TX types 0 and 2 are currently supported - use 0 for more basic networks like BSC, 2 for networks that support EIP-1559 standard like Polygon and Ethereum.
(0) autoFeeCalculation	Automatically determine best gas price - overrides buyGasPrice, set to true to enable.
(0) buyGasPrice	The gas price to pay for buy transactions, measured in gwei.
(0) buyGasLimit	The gas limit for buy transactions.
(0) sellGasPrice	The gas price to pay for sell transactions, measured in gwei.
(0) sellGasLimit	The gas limit for sell transactions.
(2) autoFeeCalculation	Automatically determine best gas price - overrides buyGasPrice, set to true to enable.
(2) autoFeePriority	Determines how much gas you are willing to pay for TX. Acceptable values: 'LOW', 'MEDIUM', 'HIGH'.
(2) buyMaxPriorityFeePerGas	The maximum priority fee per gas for buy transactions using EIP-1559.
(2) buyMaxFeePerGas	The maximum fee per gas for buy transactions using EIP-1559.
(2) buyGasLimit	The gas limit for buy transactions.
(2) sellMaxPriorityFeePerGas	The maximum priority fee per gas for sell transactions using EIP-1559.
(2) sellMaxFeePerGas	The maximum fee per gas for sell transactions using EIP-1559.
(2) buyGasLimit	The gas limit for buy transactions.
liquidityPairAddress	Liquidity pair address to use for sniping, e.g., BNB, BUSD, ETH.
sellTokens	Set to true by default. Set to false if you only want the bot to buy tokens and sell later.
transactionRevertTime	Amount of time in seconds before a buy transaction will revert. Recommended to set to a low time period, e.g., 30 seconds.
slippagePercentage	Slippage amount for buy transactions. Acceptable value ranges from 0 to 100, 0 = no tolerance, 100 = full tolerance.
basicAutosell / stopLossMultiplier	Stop loss multiplier for basic autosell mode, e.g., if set to 0.5, the bot will sell tokens if the price goes below 0.5x.
basicAutoSell / autoSellMultiplier	Auto sell multiplier for basic autosell mode, e.g., if set to 2, the bot will sell tokens if the price goes above 2x.
sellAfterTimeDelay / blocksToWait	Amount of blocks to wait after buy TX until selling - block time depends on the network, e.g., for BSC, 10 = 30 seconds.
trailingStopLoss / minMultiplier	Minimum price multiplier before TSL will activate, e.g., if set to 2 then TSL will not work until the price is at least 2x.
trailingStopLoss / trailMultiplierAmount	Trail amount in price multiplier amount, e.g., if set to 0.5 and the price goes from 5x to below 0.45x, the bot would auto sell.
trailingStopLoss / hardcap	Price multiplier hardcap, e.g., if set to 10 and the price hits 10x, the bot will sell - set to -1 to disable (no hardcap).
addLiquidityFunctionHashes	List of function hashes that will trigger the bot to buy when mempool sniping. Default should be fine in most cases.
tradingCheckerSettings / maxBuyFee	Max allowable buy fee for the token, e.g., if set to 25 then the token won’t be bought until the buy fee is under 25%.
tradingCheckerSettings / maxSellFee	Max allowable sell fee for the token, e.g., if set to 25 then the token won’t be bought until the sell fee is under 25%.
enableHotkeys	Enable hotkeys for sell mode 1 (manual selling), set to true unless you want to sell later on.
constantPriceLogging	If set to true, the bot will always log the price of the token for each block even if the price hasn’t changed. If set to false, the price will only be displayed again if the price has changed.

Gas prices fluctuate frequently for each network. To get a good idea of what gas price to use, use a gas price checker tool such as CoinTool.app.

Bot interface

After the launch sniper has loaded and your configuration is correct, you will see a menu with multiple options:

1 - Snipe token when token address is provided.
2 - Snipe token when liquidity is added.
3 - Snipe token at certain time.

1: Will snipe a token as soon as the token address is entered. Using this mode, you can also enable the trading checker so the bot will not buy until trading is enabled. Note though that this method isn’t as fast as mempool sniping.

2: This option uses mempool sniping to snipe a token as soon as liquidity is added. Using the mode, you can buy the token in the same block as the add liquidity transaction and if you use enough gas you can be the first buyer. Please note that you will need a private node for this and you must use a websocket node URL (ws:// or wss://), or the bot will not work.

3: You can use this mode to snipe a token at a certain time. For example, if a token is due to launch at 12pm, then you can make the bot buy the token at 12:00:00. Please note however that if liquidity is not added by the time the bot buys then the buy TX will fail.

Troubleshooting

Incorrectly configured config.json file: if you encounter issues with the config.json file, you can use a JSON formatter/validator like CuriousConcept JSON formatter. Paste the contents of your config.json file into the validator, click on Process, and it will identify any issues. Make sure you have used the correct symbols, such as double quotes (“), single quotes (‘), braces ({ }), brackets ([ ]), etc. Also, ensure that you save the config.json file with the correct encoding (ANSI).

Strategies

Although the launch sniper does not guarantee profits, if you use the right strategy you can increase your chances of making good profits. Here are some key tips for maximising profit and sniping quickly:

A fast computer or virtual private server (VPS).
A fast and reliable internet connection.
A private node: It is recommended to build your own node, such as a geth node, or use a reliable hosting service like Hetzner (eg. AX61-Nvme).
A sufficient investment amount: While you can invest any amount, investing 0.1 BNB or more (equivalent) generally yields better profits.
High gas fees: Higher gas fees, specifically a high gas price for buying, allow you to prioritise transactions and secure purchases at lower prices.
Trailing stop loss is recommended when selling to maximise profits.

How to spot / avoid scams

Crypto is unfortunately full of scams, however with some basic knowledge you can avoid the majority of them.

The most common scam is a rugpull, where after the token has been active liquidity is withdrawn, resulting in loss of funds for everyone except the scammer. There are typically two ways this can happen:

Removing liquidity: assuming there is no liquidity lock, the token developer sends a remove liquidity transaction, all the liquidity gets removed and all the funds end up in the scammer’s wallet.
Token minting: assuming there is a function in the token contract to mint (create) new tokens, the scammer will mint new tokens which goes to his address. This means that in relation to everyone else, the scammer will hold the vast majority of the total tokens available (eg. 99.99%). The scammer will sell all his newly minted tokens and he will get all or almost all of the remaining liquidity as his share of token supply is huge compared to everyone else.

Another variation is a honeypot, where tokens can be bought but not sold, effectively trapping your funds so you can’t sell. The token will then likely be rug pulled later.

To avoid scams:

Check if the token contract address is available in the associated Telegram (TG) channel. Look for the pinned message and make sure it comes from an admin. 
Use a blockchain explorer (eg. etherscan.io, bscscan.com) to check if the token’s contract is verified.
Use tools like rugpulldetector.com to analyse the token’s code for any red flags. 
Be cautious of tokens without locked liquidity, as they are susceptible to rugpulls. 
It’s recommended to stay away from tokens if the contract address is unavailable before launch as people will not have enough time to audit the token and could easily fall for a scam.

Additional tools to help detect and avoid scams:

rugpulldetector.com
honeypot.is
app.staysafu.org/scanner
bscheck.eu

Please bear in mind that these checks may not be 100% accurate all the time and you should use careful judgement when choosing what token to snipe.