How to use PriceWatch Bot

Saturn PriceWatch Bot is able to monitor any token market for you on Ethereum or Ethereum Classic, if a a buy or sell order is created at the price you have set or better then PriceWatch Bot will execute the trade for you.

This guide is on how you can set up the configuration file & launch the trading bot using npm, if you are a developer and want to have a look at the source code. You can find it published on our Github:

saturn-network/pricewatch-bot
Watch a price of a given token on Saturn Network and auto buy/sell - saturn-network/pricewatch-bot
PriceWatch Bot Source Code

Table of Contents

  1. Before launching your PriceWatch Bot
  2. How to configure PriceWatch Bot
  3. How to run PricWatch Bot

Before launching your pricewatch bot

  1. You need to install node.js to run our crypto trading bot, also we recommend you install Hyper. You can follow the guide below to learn how to install node.js on Windows, Linux or macOS.
How to install Node.js | Saturn Crypto Learning
Here we will go through how to install necessary JavaScript runtimes to use our tools and trading bots. Learn how to install node.js on Windows, Linux and macOS.
Tutorial to install Hyper and node.js (JavaScript runtimes)
  1. Create a new wallet address to use only with your trading bot, you can name your new wallet address appropriately in Saturn Wallet so easily know which wallet is being used by your trading bot & track your balances.

PriceWatch-Bot-Saturn-Network-1

  1. Send the funds you are going to use to your new account, as always you will need coin to pay for Gas fees also.

  2. Export your new wallet's private key as you will need it when you launch your trading bot.

  3. Pricewatch Bot is unable to submit an ERC20 Approve transaction. If you wish to use it to monitor an ERC20 token market, then first proceed to make one manual trade with your wallet to complete the ERC20 Approve transaction for the token.

If you would like to learn more about ERC20 Approve you can read our detailed article around the subject linked below.

ERC20 Approve Explained
Here we explain what is an ERC20 Approve transaction, and provide an overview of how it is displayed on Saturn Network when trading ERC20 tokens.

How to configure Pricewatch Bot

  1. Once you have node.js installed, run the following command in Hyper: npx @saturnnetwork/pricewatch-bot -h it should return the following if you have everything set up correctly:

PriceWatch-Bot-Saturn-Learning-2

  1. The .JSON file is the important part where you set up your Pricewatch trading bot configuration so open up your favourite text editor. Here is an example:
[
  {
    "token": "0xac55641cbb734bdf6510d1bbd62e240c2409040f",
    "blockchain": "ETC",
    "action": "buy",
    "price": "0.000051",
    "houretherlimit": "0.0005"
  },
  {
    "token": "0xac55641cbb734bdf6510d1bbd62e240c2409040f",
    "blockchain": "ETC",
    "action": "sell",
    "price": "0.00006",
    "houretherlimit": "0.5"
  },
  {
    "token": "0xb9440022a095343b440d590fcd2d7a3794bd76c8",
    "blockchain": "ETH",
    "action": "buy",
    "price": "0.00001389",
    "houretherlimit": "0.0005"
  }
]

The above configuration has three different strategies that will load up on launch which are separated by curly brackets.

  • The first instructions will buy Saturn Classic (which you set with the token contract which is 0xac55641cbb734bdf6510d1bbd62e240c2409040f & blockchain which is ETC) if there is an order at the price of 0.000051 or better. The price parameter is your threshold for buying or selling, so in the above example the bot will continue buying Saturn Classic from the best available orders up to the price of 0.000051 ETC but never higher. Also note the houretherlimit parameter this allows you to set a limit to the amount of coin your bot can use per hour. In this example, once the bot spends 0.0005 ETC it will stop buying until the next hour. If you do not want your bot to have any limits then you can simply set this number very high like 9999.

  • The second instruction is also for Saturn Classic, but this time it is a sell strategy. If the price is 0.00006 or better. So this means we have automated the oldest trading strategy that will never fail: buy low & sell high.

  • Then we can see by the third strategy that this trading bot is also runnin is to buy Saturn DAO Tokens on Ethereum ( 0xb9440022a095343b440d590fcd2d7a3794bd76c8 ), note how Blockchain is set to ETH, if an order comes up at the price of 0.00001389 ETH or better.

How to run Pricewatch Bot

  1. Once you are happy with your configuration file, make sure you save it as a .json file with a filepath you can easily find on your system or server. This is where you will need your wallet's private key you exported earlier. In Hyper type the following command:
npx @saturnnetwork/pricewatch-bot -p YOUR_PRIVATE_KEY_HERE -j 'C:\Example\myfirsttradingbot.json'

Note that for your .json filepath, you may not need any brackets ' or your system may need " brackets. If pricewatch bot cannot find your .json file it will display a message couldn't get the module.

If you prefer, you can launch the bot using your 12 word seed phrase but you will need to know your wallet's ID (if it is Account 1, Account 2 or Account 3) in Saturn Wallet and if you have many accounts already well you have probably lost track. Here is an example of how to do this:

npx @saturnnetwork/pricewatch-bot -m "radar blur cabbage chef fix engine embark joy scheme fiction master release" -i 4 -j 'C:\Example\myfirsttradingbot.json'

You use the -i to set your account ID, in the example above I would be using Account 4 by default it is set to 2 so if you leave it blank it will use Account 2 in Saturn Wallet.

  1. And here is the outcome using the configuration file above:

PriceWatch-Bot-Saturn-Learning-3

You can see the trading bot displays the wallet address it is using and also lists the strategies you have set in the configuration file. As we can see it has spotted two opportunities to buy & is executing them. And once it has completed those trades, we can see it knows there are still buy opportunities but we have reached the hourly ether limit that was set:

PriceWatch-Bot-Saturn-Learning-4

For the moment there are no buy orders for Saturn Classic at the price of 0.00006 ETC or better so the bot is not trying to sell. But as soon as one does appear in the orderbook, as we can see Pricewatch bot is able to execute it:

PriceWatch-Bot-Saturn-Learning-5

There you have it! That was a quick tutorial to get you started. If you have any queries or need any help setting it up please reach out via our Reddit community for any support.

Learn More