Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/earthskyorg/sniper-bot

Sniper Bot - Solana | About Proof of Concept, an automated trading bot, featuring real-time token event monitoring, auto-buy/sell, and customizable configurations. Future updates include rug detection and live PnL dashboard.
https://github.com/earthskyorg/sniper-bot

auto-trading crypto raydium-bot raydium-sniper-bot solana solana-sniperbot solana-token-bot

Last synced: about 1 month ago
JSON representation

Sniper Bot - Solana | About Proof of Concept, an automated trading bot, featuring real-time token event monitoring, auto-buy/sell, and customizable configurations. Future updates include rug detection and live PnL dashboard.

Awesome Lists containing this project

README 

        
# Solana Trading Bot



The Solana Trading Bot is a software tool designed to automate the buying and selling of tokens on the Solana blockchain.

It is configured to execute trades based on predefined parameters and strategies set by the user.



The bot can monitor market conditions in real-time, such as pool burn, mint renounced and other factors, and it will execute trades when these conditions are fulfilled.



## Setup



To run the script you need to:



- Create a new empty Solana wallet

- Transfer some SOL to it.

- Convert some SOL to USDC or WSOL.

  - You need USDC or WSOL depending on the configuration set below.

- Configure the script by updating `.env.copy` file (remove the .copy from the file name when done).

  - Check [Configuration](#configuration) section bellow

- Install dependencies by typing: `npm install`

- Run the script by typing: `npm run start` in terminal



You should see the following output:  

![output](readme/output.png)



### Configuration



#### Connection



- `RPC_ENDPOINT` - HTTPS RPC endpoint for interacting with the Solana network.

- `RPC_WEBSOCKET_ENDPOINT` - WebSocket RPC endpoint for real-time updates from the Solana network.

- `COMMITMENT_LEVEL`- The commitment level of transactions (e.g., "finalized" for the highest level of security).



#### Bot



- `LOG_LEVEL` - Set logging level, e.g., `info`, `debug`, `trace`, etc.

- `MAX_TOKENS_AT_A_TIME` - Set to `1` to process buying one token at a time.

- `COMPUTE_UNIT_LIMIT` - Compute limit used to calculate fees.

- `COMPUTE_UNIT_PRICE` - Compute price used to calculate fees.

- `PRE_LOAD_EXISTING_MARKETS` - Bot will load all existing markets in memory on start.

  - This option should not be used with public RPC.

- `CACHE_NEW_MARKETS` - Set to `true` to cache new markets.

  - This option should not be used with public RPC.

- `TRANSACTION_EXECUTOR` - Set to `warp` to use warp infrastructure for executing transactions, or set it to jito to use JSON-RPC jito executer

  - For more details checkout [warp](#warp-transactions-beta) section

- `CUSTOM_FEE` - If using warp or jito executors this value will be used for transaction fees instead of `COMPUTE_UNIT_LIMIT` and `COMPUTE_UNIT_LIMIT`

  - Minimum value is 0.0001 SOL, but we recommend using 0.006 SOL or above

  - On top of this fee, minimal solana network fee will be applied



#### Buy



- `QUOTE_MINT` - Which pools to snipe, USDC or WSOL.

- `QUOTE_AMOUNT` - Amount used to buy each new token.

- `AUTO_BUY_DELAY` - Delay in milliseconds before buying a token.

- `MAX_BUY_RETRIES` - Maximum number of retries for buying a token.

- `BUY_SLIPPAGE` - Slippage %



#### Sell



- `AUTO_SELL` - Set to `true` to enable automatic selling of tokens.

  - If you want to manually sell bought tokens, disable this option.

- `MAX_SELL_RETRIES` - Maximum number of retries for selling a token.

- `AUTO_SELL_DELAY` - Delay in milliseconds before auto-selling a token.

- `PRICE_CHECK_INTERVAL` - Interval in milliseconds for checking the take profit and stop loss conditions.

  - Set to zero to disable take profit and stop loss.

- `PRICE_CHECK_DURATION` - Time in milliseconds to wait for stop loss/take profit conditions.

  - If you don't reach profit or loss bot will auto sell after this time.

  - Set to zero to disable take profit and stop loss.

- `TAKE_PROFIT` - Percentage profit at which to take profit.

  - Take profit is calculated based on quote mint.

- `STOP_LOSS` - Percentage loss at which to stop the loss.

  - Stop loss is calculated based on quote mint.

- `TRAILING_STOP_LOSS` - Set to `true` to use trailing stop loss.

- `SKIP_SELLING_IF_LOST_MORE_THAN` - If token loses more than X% of value, bot will not try to sell

  - This config is useful if you find yourself in a situation when rugpull happen, and you failed to sell. In this case there is a big loss of value, and sometimes it's more beneficial to keep the token, instead of selling it for almost nothing.

- `SELL_SLIPPAGE` - Slippage %.



#### Snipe list



- `USE_SNIPE_LIST` - Set to `true` to enable buying only tokens listed in `snipe-list.txt`.

  - Pool must not exist before the bot starts.

  - If token can be traded before bot starts nothing will happen. Bot will not buy the token.

- `SNIPE_LIST_REFRESH_INTERVAL` - Interval in milliseconds to refresh the snipe list.

  - You can update snipe list while bot is running. It will pickup the new changes each time it does refresh.



Note: When using snipe list filters below will be disabled.



#### Filters



- `FILTER_CHECK_INTERVAL` - Interval in milliseconds for checking if pool match the filters.

  - Set to zero to disable filters.

- `FILTER_CHECK_DURATION` - Time in milliseconds to wait for pool to match the filters.

  - If pool doesn't match the filter buy will not happen.

  - Set to zero to disable filters.

- `CONSECUTIVE_FILTER_MATCHES` - How many times in a row pool needs to match the filters.

  - This is useful because when pool is burned (and rugged), other filters may not report the same behavior. eg. pool size may still have old value

- `CHECK_IF_MUTABLE` - Set to `true` to buy tokens only if their metadata are not mutable.

- `CHECK_IF_SOCIALS` - Set to `true` to buy tokens only if they have at least 1 social.

- `CHECK_IF_MINT_IS_RENOUNCED` - Set to `true` to buy tokens only if their mint is renounced.

- `CHECK_IF_FREEZABLE` - Set to `true` to buy tokens only if they are not freezable.

- `CHECK_IF_BURNED` - Set to `true` to buy tokens only if their liquidity pool is burned.

- `MIN_POOL_SIZE` - Bot will buy only if the pool size is greater than or equal the specified amount.

  - Set `0` to disable.

- `MAX_POOL_SIZE` - Bot will buy only if the pool size is less than or equal the specified amount.

  - Set `0` to disable.



## Warp transactions (beta)



In case you experience a lot of failed transactions or transaction performance is too slow, you can try using `warp` for executing transactions.

Warp is hosted service that executes transactions using integrations with third party providers.



Using warp for transactions supports the team behind this project.



### Security



When using warp, transaction is sent to the hosted service.

**Payload that is being sent will NOT contain your wallet private key**. Fee transaction is signed on your machine.

Each request is processed by hosted service and sent to third party provider.

**We don't store your transactions, nor we store your private key.**



Note: Warp transactions are disabled by default.



### Fees



When using warp for transactions, fee is distributed between developers of warp and third party providers.

In case TX fails, no fee will be taken from your account.



## Common issues



If you have an error which is not listed here, please create a new issue in this repository.

To collect more information on an issue, please change `LOG_LEVEL` to `debug`.



### Unsupported RPC node



- If you see following error in your log file:  

  `Error: 410 Gone:  {"jsonrpc":"2.0","error":{"code": 410, "message":"The RPC call or parameters have been disabled."}, "id": "986f3599-b2b7-47c4-b951-074c19842bad" }`  

  it means your RPC node doesn't support methods needed to execute script.

  - FIX: Change your RPC node. You can use Helius or Quicknode.



### No token account



- If you see following error in your log file:  

  `Error: No SOL token account found in wallet: `  

  it means that wallet you provided doesn't have USDC/WSOL token account.

  - FIX: Go to dex and swap some SOL to USDC/WSOL. For example when you swap sol to wsol you should see it in wallet as shown below:



![wsol](readme/wsol.png)



## Contact



John Criswick: discord id is johncriswick25 ( johncriswick25 )



- If you want to leave a tip, you can send it to the following address:

  `HFpwqb3J7VS7UUKa5qMQxSqqnxeZBaYRjWYKBb2Whr8E`



- If you need custom features or assistance, feel free to contact on discord for dedicated support.



## Disclaimer



The Solana Trading Bot is provided as is, for learning purposes.

Trading cryptocurrencies and tokens involves risk, and past performance is not indicative of future results.

The use of this bot is at your own risk, and we are not responsible for any losses incurred while using the bot.