Shitcoin
This module snipes tokens from Raydium pools which match your task criteria
Two different files are used to load shitcoin task configuration: shitcoin.csv and qt_shitcoin.csv . Below are the fields which are expected.
Mode
There are three possible values which can be entered here: default , jito, bloxroute
Default: Sends transactions using the RPC selected when running the module.
Jito: Send transactions using Jito's client, loaded by selecting the block engines upon prompt. Transactions are only forwarded when a Jito validator is the leader node, which at the time of writing this document, represents a 30-40% of total available Solana validators. It therefore doesn't guarantee early block buys, but it can help with them if the first blocks are Jito validators.
bloXroute: Send transactions using bloXroute's client, which at the moment presents a fast and cheap method of landing transactions. For setup please read bloXroute Api Key
Marketplace
This allows you to select which marketplaces to use for sniping:
Raydium: This is the most common market and is where most pools will drop.
Meteora: This is a new market which has dynamic pool pricing.
PumpFun: Upcoming marketplace for lowkey/safe shitcoin drops. Once a pool on their platform reaches a specific market cap, it gets released on Raydium. To run you will need to run a buy slippage below 100. ~80-90 is okay.
To run multiple marketplaces, you can enter them as a list separated by ; i.e: Raydium;PumpFun
Wallet Name
This is the alias for the wallet name of your solana_wallets.csv file. In case you have multiple wallets in the solana_wallets.csv file with the same alias, it will use the FIRST one, so make sure to use different aliases.
Token In
Enter the token you want to use to snipe your target Token Out. This can be wSOL (Wrapped SOL), USDC or any other token.
As an example for wSOL: you can either enter the abbreviated wsol, sol, or full address like So11111111111111111111111111111111111111112 . If you want to enter USDC, you would enter its token address: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
Token Out
Enter the token address you want to snipe. This token will be bought using your balance from Token In. If you want to run AFK mode, you should enter afk here.
Pool Id (Optional)
In some cases, you can know in advance the Pool Id for the pool you want to snipe. If that's the case you should enter its address here and the bot will use that for swaps.
If you don't know the pool, just leave this value empty, the bot will find a pool which has a pair Token In - Token Out and matches your other criteria like minimum liquidity, skip abused pools, etc.
Amount
The amount of Token In units you want to pay for Token Out.
If you enter 1, and Token In is wSOL, then that task will spend 1 wSOL buying your specified Token In is wSOL, then that task will spend 1 wSOL buying your specified Token Out. 50 for USDC will be 50 USDC spent per task, same follows with other tokens entered.
Min Liquidity (Token In)
This is the minimum amount of liquidity of Token In that the pool needs to have in order to be considered. You want to use this to filter out any unwanted or not liquid pools, which are likely to rug pull.
Min Liquidity (Token Out)
Same as above, except this filters out the minimum liquidity required for Token Out pool balance.
Buy TxAmount
This is the amount of buy transactions which should be sent for sniping.
A Buy TxAmount of 10 for sniping with 5 wSOL will mean it will try to buy 5 wSOL, but send 10 different transactions if Pre Create Ata field (see below) is set to false. If this field is set to true it will send a same buy transaction 10 times. This is done to ensure no matter how many buy transactions you submit, you will only be buying the target token one time, per buy operation.
Sell TxAmount
This is the amount of sell transactions which should be sent when selling a sniped token.
A Sell TxAmount of 50 will send 50 different sell transactions if Auto Sell Token Percentage field is 100, otherwise a same sell transaction will be sent 50 times. This is done to ensure no matter how many sell transactions you submit, you will only be selling the target token one time, per sell operation.
Auto Sell Profit Margin
This is the profit percentage after which the bot should auto sell tokens.
Specifying 200 here means that it will auto sell after 3x aka 200% price increase. 500 will mean after a price increase of 500% or 6x. If you don't want tokens to be auto sold based on profit, keep this value at 0.
Auto Sell Stop Loss
This is the loss percentage after which the bot should auto sell tokens.
Specifying 80 here means that it will auto sell after a -80% loss of the tokens you bought. If you don't want tokens to be auto sold based on loss, keep this value at 0.
Auto Sell Trailing Stop Loss
This is the trailing stop loss percentage up to where the bot will auto sell tokens.
Specifying 50 here means that if the value of the token loses a 50% of its value at any given time, the bot will sell the tokens according to the Auto Sell Percentage you specified.
Auto Sell Percentage
This is the amount of tokens which should be sold when a sell operation has been triggered.
Sell operations can be triggered on the following cases:
profit for sniped token exceeds auto sell profit margin
loss for sniped token exceeds auto sell stop loss margin
trailing stop loss when sniped token exceeds auto trailing stop loss margin
Auto Sell Delay (seconds)(see below) have passed since a buy operation was sent
The bot yields better results when selling if this value is set to 100 as different transactions will be sent, thus increasing sell success rate.
Buy Slippage
This is the allowed percentage value you permit the task to buy coins under the current price.
A value of 10 means that the minimum amount of tokens out can be at maximum a 10% decrease of the current price.
STRONGLY suggested to have a value of 100 here, having a very strict buy slippage such as 0 can cause the transaction to fail if price varies by very little.
Buy Min Amount Out
This setting overrides the previous Buy Slippage. It allows you to decide the minimum number of tokens you want to obtain per swap transaction for this task.
For example, if you are buying a pool with USDC - $BONK for example, you have a Amount of 10, and you want to ensure a maximum buying price of $0.1 per token, you should enter 100 here. Which will guarantee you will obtain at least 100 $BONK tokens per swap transaction.
Sell Slippage
This is the allowed percentage value you permit the task to buy coins under the current price.
A value of 10 means that the minimum amount of tokens out can be at maximum a 10% decrease of the current price.
STRONGLY suggested to have a value of 100 here, having a very strict buy slippage such as 0 can cause the transaction to fail if price varies by very little.
Pre Create Ata
This tells the bot if it should create an empty token account in your wallet for the token that you want to buy.
Keep this by default to false, as it speeds up the bot much more. If you know you have a previously created token account for that shitcoin, then set it to true.
Buy Priority Fee
Defines the priority fee you want to pay for buy transactions, in SOL value.
Sell Priority Fee
Defines the priority fee you want to pay for sell transactions, in SOL value.
Buy Jito Tip
Defines the Jito Tip you want to pay for buy transactions, in SOL value.
Sell Jito Tip
Defines the Jito Tip you want to pay for sell transactions, in SOL value.
Buy bloXroute Tip
Defines the tip to send to bloXroute for buy transactions, in SOL value. Something like 0.001 is a good default.
Sell bloXroute Tip
Defines the tip to send to bloXroute for sell transactions, in SOL value. Something like 0.001 is a good default.
Auto Sell Delay
Defines the time in seconds to wait between sending buy transactions and start selling sell transactions, without taking into consideration Auto Sell Profit Margin nor Auto Sell Stop Loss . Decimals are accepted too, i.e: 0.5 = 500 ms, will start sending sell transactions 500 milliseconds after sending buy transactions.
This ONLY works properly if you have an Auto Sell Percentage value of 100.
Pre Spam Openbook
This setting will tell the bot if you want it to pre-spam a pool before it is live, once a market for it has been created. It will send as many buy transactions as Buy TxAmount setting you have. Put it to true to enable it. The bot will be sending one buy transaction then sleep for Tx Delay seconds (see below).
Examples for running would be:
Running for 1 minute from market created on OpenBook:
60 buy tx amount, 1 tx delay: you will get 1 tx/second average
120 buy tx amount, 0.5 tx delay: you will get 2 tx/second average
180 buy tx amount, 0.333 tx delay, you will get 3 tx/second averag
240 buy tx amount, 0.25 tx delay, you will get 4 tx/second average
etc.
Running for 5 minutes from market created on OpenBook:
300 buy tx amount, 1 tx delay: you will get 1 tx/second average
600 buy tx amount, 0.5 tx delay: you will get 2 tx/second average
900 buy tx amount, 0.333 tx delay, you will get 3 tx/second averag
1200 buy tx amount, 0.25 tx delay, you will get 4 tx/second average
etc.
Running for 10 minutes from market created on OpenBook:
600 buy tx amount, 1 tx delay: you will get 1 tx/second average
1200 buy tx amount, 0.5 tx delay: you will get 2 tx/second average
1800 buy tx amount, 0.333 tx delay, you will get 3 tx/second averag
2400 buy tx amount, 0.25 tx delay, you will get 4 tx/second average
etc.
Note: Sending all this many buy transactions which most of them will fail, will drain your SOL balance in fees, so it is important you consider a reasonable setup.
Tx Delay (seconds)
Used exclusively when sniping with Pre Spam Openbook set to true OR when there is a pool dropping as a scheduled drop.
When running pre-spam, if you are running 100 Buy TxAmount with a Tx Delay of 0.5. Then the bot will run for 50 seconds, sending one buy transaction every 0.5 seconds. Same applies for Sell TxAmount, once a market for a potential pool has been created through OpenBook, it will start trying to sell it if your Auto Sell Percentage is set to 100, using the same methodology.
On the case where you are running for a scheduled drop, this delay will also be applied to your buy transactions. This is done so that if you are running a pre-start to send buy transactions before pool has actually opened, you can space out your buy transactions.
Skip Abused Pools
This setting allows you to filter out pools which have been created to be rugged. They are made with a market creation of 0.3 SOL instead of standard 2.8 SOL.
To activate set this value to true
Max Token Holding Percentage
This setting allows you to define the maximum percentage of total supply of tokens you allow any specific holder to own. For speed considerations, it is only checked when all tasks are running Pre Spam Openbook
For example, if you set a value of 50 and there's a token holder of the pool which owns more than 50% of the total token supply, the pool will be skipped. If you don't care how many tokens are being held by a single owner, and want to ignore this check, keep this value to 100 .
Min Bonding Curve Progress
PumpFun specific field, allows you to set the minimum bonding curve progress you want to buy tokens from in AFK mode.
If you enter a value of 0 here and you are running AFK mode, then you will only buy new tokens.
i.e: 90 here will ensure you are only buying from Pools where the bonding curve progress is 90% or greater.
Min Initial Buy In SOL Amount (Pump Fun)
PumpFun specific field, allows you to set the minimum allowed buy in SOL amount by the dev on the creation tx of the coin.
i.e: 1 here means you want to avoid sniping any coin where the dev bought off initially less than 1 SOL worth of its own tokens.
Max Initial Buy In SOL Amount (Pump Fun)
PumpFun specific field, allows you to set the maximum allowed buy in SOL amount by the dev on the creation tx of the coin.
i.e: 3 here means you want to avoid sniping any coin where the dev bought off initially 3 SOL worth of its own tokens.
Target Tickers
Here you can enter a list of tickers to target for sniping. If the list is empty it will allow any ticker to be sniped. They should be stored line by line under the file shitcoins/target_tickers.txt
Blacklisted Tickers
Here you can enter a list of tickers to avoid sniping. If the list is empty it will allow any ticker to be sniped. They should be stored line by line under the file shitcoins/blacklisted_tickers.txt
Target Names
Here you can enter a list of coin names for sniping. If the list is empty it will any coin name to be sniped. They should be stored line by line under the file shitcoins/target_names.txt
Coins which partially include some of the names on this file will also be sniped, for example "the dog" will snipe coins such as "billy the dog".
Blacklisted Names
Here you can enter a list of coin names to avoid sniping. If the list is empty it will allow any coin name to be sniped. They should be stored line by line under the file shitcoins/blacklisted_names.txt
Coins which partially include some of the blacklisted names on this file will not be sniped, for example "the cat" will avoid sniping coins such as "tom the cat".
Whitelisted Dev Wallets (PumpFun)
This is a list of dev wallets you want to target for sniping. They should be stored line by line under the file shitcoins/dev_wallets.txt
If you want to include dev addresses which have launched coins which previously reached Raydium and were completed, you should add a line on this file which says completed
Blacklisted Dev Wallets (PumpFun)
This is a list of dev wallets you want to avoid sniping coins from. They should be stored line by line under the file shitcoins/blacklisted_wallets.txt
Sell After Dev Sells (PumpFun)
This adds a monitor to the dev (deployer) wallet address of the coin you are sniping. If they sell their coins, your tasks will automatically trigger a sell operation too.
If you want to activate it, just set it to: true or if you don't want to, set it to false .
Check Dev Address On Pump IT Pro (Pump Fun)
API Key required which must be loaded on your Pump IT Pro Api Key. If set to true it will use their API to check if a coin should be sniped according to the deployer address. Other filters such as Min Initial Buy In SOL Amount (Pump Fun) will still be applied on top.
Skip Non Vanity Addresses (Pump Fun)
Coin addresses launched through https://pump.fun official's website will always have the suffix "pump". This setting allows you to skip any coins which have not been launched through it, which don't have a suffix ending in "pump". This is a good filter to avoid coins which have been launched via self bundling.
Solana Pre Start
This value is not stored under the shitcoin.csv nor qt_shitcoin.csv but rather on the config file. It is only used in pools which are loaded and are not live yet, but releasing on a future time. It helps you control how early you want to start sending buy transactions for the pool, to help you get transactions in as fast as possible.
Last updated