How to setup and launch your own airdrop



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, the easiest way is to simple download their installer & follow the steps.
  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, if you have any feedback for how our tool works please let us know here: Airdrop tool feedback & suggestions.

Help! Something went wrong?
Read the error output, though it may look scary in most cases it will tell you what went wrong. For example, it may indicate you do not have enough ETH or ETC to pay for the required gas fees. But if you can't figure it out, feel free to ask & we will be happy to assist you.

Happy Airdropping!

Introducing: Candy Classic
Airdrop Tool Guides
BCash Classic (BCHC) AirDrop ! *Sign Up Thread*
How do I post OTC orders for ERC223 tokens?
Bcash Classic Token

This is the bomb! Fastest, Cheapest and Easiest way to airdrop to your communities!

thanks for this amazing tool guys!
Saturn to the moon!


Wow, very well done team! You guys never fail to impress!


Is there an easy way to get a large list of addresses into this JSON format? Or must I build? Thanks. I will probably build something just for the fun of it. There appears to be a tool _ will try it. _


You can use a programming language like python or javascript. Or you can use excel and this csv-to-json tool to some degree. Or you can manually open Notepad and start typing symbol by symbol.

It’s all up to you and depends on your skill level and what tools you are familiar with. At the end of the day no matter what tool you use you end up with the same file!


Love the line when the code runs… " Airdropping Like It’s Hot" Thanks for the script. Just did a test run. Very nicely done.


If you use terminal with unicode support, like Hyper, you’ll also see :fire:


@Neuron can we only use Saturn or Metamask wallet to send Airdrop tokens? Is it ok to rename an existing Saturn “Account 1” to “Account 2” and then import as new “Account 1” to send the airdrop tokens from?


yes you can rename things as much as you want, but the tokens and ETC need to be in the first account, regardless of what it’s called. The airdrop tool doesn’t know about how you named it in your wallet.

You can use a private key instead of a mnemonic as well - if things are too confusing you can make a MEW account with a private key and use that for airdrops. I personally think that using first account in Saturn Wallet is just easier.


@Neuron I have done a couple of test airdrops and they have partially completed. Each airdrop was just 10 tokens to a single address and same receiving address both times. The 20 tokens in total have left my Account 1 but they have not been received by the recipient and they are not available for the receiver to Claim on your network.

Is there a time delay for the tokens to go through your system?


@Neuron correction the tokens did arrive on your network for claiming. I was forgetting that you have to select the “hamburger” menu to see them. Maybe an idea to add them to the dashboard?


You mean that you need to open the airdrop page?


Hmm I mean I feel like airdrops and trading is pretty different, not sure if they should really appear on the same dashboard. And it is step one in our how to claim guide:

How would you see it looking?


I was thinking of all the DEX visitors that don’t come via this forum.