How to Setup and Launch your own Airdrop

Airdrop Tool Guides | Saturn Network
How to manage token airdrops easily? Airdrop Tool can be used to automate erc20, erc223, ETH and ETC airdrops to hundreds of wallet addresses.

Table Of Contents

  1. Requirements
    1.1 Before you proceed
  2. How to use airdrop-tool
    2.1 Check node.js has been installed
    2.2 Setting up your JSON Airdrop details file
    2.3 On Ethereum you will need a private node
  3. Launch your airdrop!

1. Requirements:

  1. You need to install node.js, but don't worry we have a full tutorial on how to do that: How to install node.js?
  2. Our airdrop tool is entirely command line based, which means you need to have access to a terminal:
    • If you are on Linux or macOS then probably this is nothing new for you.
    • For Windows users your default terminal is called "Windows Powershell" you can search for it in your start menu.
    • Altenatively, I recommend using Hyper as it supports any OS.
  3. You will need a list of wallets to use for your airdrop, if you do not have any you could always consider airdropping Saturn Network's genesis block investors.

1.1 Before you proceed

  • Our Airdrop Tool will be making transactions for you so will need you to enter in your seed phrase or private key. Consider making a new wallet just for your airdropping needs.
  • If you are doing a token airdrop, then these tokens need to be in your wallet. You will also need some ETH or ETC in your wallet to pay for gas fees.
  • If you have created your wallet in Saturn Wallet or MetaMask, your tokens and coin need to be in Account 1.
  • If you have not already done so, follow our Asset Self Listing guide to submit your token's logo and additional information:

2. How to use our airdrop tool?

We will now go through the correct steps you need to take to make sure your airdrop is setup and executed succesfully using our tool.

2.1 Checking that node.js has been installed & our tool will work

Launch your preferred terminal, and type in the following 3 commands pressing enter between each one:

node -v
npm -v
npx airdrop-tool -h

If everything has been installed correctly then your terminal should look something like this:


What to do if you received an error?
If you are Windows, navigate to Node.js in your Start Menu & click "Install Aditionnal Tools for Node.js" before trying again. For any other OS, please tryreinstalling node.js as outlined here.

2.2 Setting up your Airdrop JSON details file

This file is very important as it sets the wallet addresses to be included in your airdrop and also the amount of tokens or coin they will receive, so open up your favourite text editor and paste in the following & amend as necessary:

You need to save your file as "Your Filename".json

    "address": "WALLET_ADDRESS_ONE",
    "tokens": Amount of tokens/coin taking into account decimals.
    "address": "WALLET_ADDRESS_TWO",
    "tokens": 24934675001
    "address": "WALLET_ADDRESS_THREE",
    "tokens": 20017500004939

Remember to take into account your token's decimals when setting the amount, in the example above if your token has 8 decimals then 24934675001 equals 249.34675001 tokens and 20017500004939 equals 200175.00004939

You can enter in as many wallet addresses as you want, just remember after the last } there is no , before the closing bracket ]. What you can do to quickly make sure your JSON file is in a valid format is to paste it into a json validator like jsonlint.

2.3 For Ethereum You Need To Use A Private Node

If your airdrop is anything bigger than 10 wallets on Ethereum, you will need to use a private node for it to be successful. If you do not have one set up, you can register with and get one for free.

  1. Sign-up or login and click "Create Project."
  2. Set up a name for your project.
  3. Copy down the endpoint which will look something like as you will need it in the next section.

3. Launching Your Airdrop!

Now for the fun part, you should now be ready to launch your airdrop and announce it's completion to your happy community! All in just a couple of minutes, magic? No it's powered by Saturn Network.

Here is the main command you will need to type into your terminal broken down, remember if you are on Ethereum to include your rpcnode endpoint that you just created with infura:

npx airdrop-tool -c Chain -s Standard -m "Wallet 12 word seed phrase" -t token's contract address -j "Filepath for Airdrop.json" -n rpcnode(optional)

So for example, if I would like to airdrop Saturn Classic which is an ERC223 token on Ethereum Classic and therefore does not need a private node:

npx airdrop-tool -c ETC -s ERC223 -m "Saturn Network Airdrop Suite Tool Is Better Than Sliced Bread Itself Amen" -t 0xac55641cbb734bdf6510d1bbd62e240c2409040f -j "D:\Saturn Network\airdropSATURN.json"

If everything happened successfully then your terminal will display the following:


The bar will show you the progress of your airdrop on your terminal, here we can see my airdrop was very small to 4 wallets. It has marked down 4/4 100% which means that all four transactions have been submitted to the blockchain succesfully.

If you check the wallet address you are using in a blockchain explorer then you should see the transactions being made. Once a transaction is confirmed, it will appear on our website's airdrop page for your users to claim.

Congratulations! You have succesfully airdropped your tokens.

You can share the following guide to teach your community how to claim their airdrop:

How to claim your airdrop | Saturn Crypto Learning
How to claim your cryptocurrency airdrop on Saturn Network? Airdrop tools supports erc20, erc223, ETH, and ETC. Claim your tokens easily in one click.

If you need any help setting up your Airdrop requirements, please reach out via email:

[email protected]

We also offer Airdrop services built around our tool, which you can read about here:

Airdrop Services | Saturn Network
Saturn’s Airdrop Service takes away the headaches of token airdrops. From curated wallet lists to full airdrop management.

Happy Airdropping!