Hummingbot Academy

Liquidity Mining Quick Start

This guide shows users how to create an account on Hummingbot Miners and connect their Binance accounts to the Hummingbot Miner app in order to participate in liquidity mining campaigns and earn token rewards.

Note that users earn rewards for trading, creating orders, and running trading bots for the tokens in the respective liquidity mining campaigns. This is not covered in this guide; to learn more about setting up trading bots, go here: Hummingbot Quickstart.


1. Create a read-only Binance API Key

Creating an API Key requires 2FA-enabled.

  1. Navigate to API Management in your Binance account:

binance-set read only

  1. Enter a name for your new API Key
  2. Verify the new key

binance-name key

  1. Store your API Key and Secret Key, then select Edit restrictions
  2. Unselect Enable Spot & Margin Trading
  3. Hit Save

binance-set read only

new content

2. Add read-only API key to Miner

[add content]

3. Install Hummingbot (macOS or Windows installer)

[add content]

4. Add trade API key to Hummingbot

[add content]

5. Run Bot and see rewards on Miner

end new content

2. Create a Hummingobt Miner account

  1. Navigate to Hummingbot Miner, and click on Log in

  2. Select Sign up

  3. Enter your email address, read and agree to the Terms of Service, then click on Create account

  4. Check your email to confirm your account

  5. On the Hummingbot Miner email, click on Log in to Hummingbot Miner

  6. � You should now be logged into Hummingbot Miner with your new account.

3. Connect your Binance account to Hummingbot Miner

  1. Go to the Settings tab and select Connect binance
  2. Input your read-only API keys �

4. Enter a wallet address for your rewards

Each campaign has different reward terms and may pay out in different tokens. For campaigns that you are participating in, make sure you enter your respective wallet address. For example, if you are participating in a campaign that is paying out in ERC20 tokens, enter a valid Ethereum wallet address to receive your rewards.

  1. Under the Connect wallets section, choose the wallet you want to input and select Connect.
  2. Enter the wallet address �

How are liquidity mining rewards earned?

Liquidity mining rewards are earned by users for creating maker orders and contributing to the order book depth for specific tokens and trading pairs.

  1. Rewards for a campaign are distributed equally into each minute during a reward period. There is a fixed amount of token rewards that is shared by participating miners for each minute snapshot.
  2. Users can participate in a snapshot by having outstanding maker orders in that snapshot; the more snapshots a miner participates in, the more rewards they are able to accumulate.
  3. Within each snapshot, participating miners are allocated a portion of the reward pool. Their allocation depends on (1) how tight their order spreads are, and (2) how large their order sizes are, relative to all other miner.
  • The tighter a miner's order spreads are, the more weight their orders get
  • The larger order size, the larger the weight.

For a more detailed discussion, please view this blog post: Demystifying liquidity mining rewards.


View your rewards

Go to the Dashboard tab in Hummingbot Miner and the Rewards sub-tab to view your rewards:

  1. Your total rewards (shown in ~USD value) for the current reward period. This card also shows the time remaining in the current reward period
  2. Your rewards earned in the previous reward period, and the time remaining until those rewards are to be paid out
  3. Total rewards all-time
  4. View a graph of recent rewards by trading pair; mouse-over shows reward breakdown for a specific snapshot
  5. Table of rewards earned from recent snapshots
  6. Clicking on a period rewards shows a breakdown of rewards as was as the actual amount of tokens earned in that snapshot

Reward payouts

Go to the Dashboard tab and the Payouts sub-tab view your payout details:

Rewards are calculated in weekly periods and paid out 3 days after the end of each weekly period.

  1. The rewards earned in the previous that are due to be paid out. This card also shows the time remaining until the rewards are to be paid out
  2. Amount of rewards earned but yet to be paid
  3. Token amounts earned
  4. Due to rising gas prices for Ethereum, ERC20-based rewards are subject to a minimum payment threshold. Only once the minimum has been reached will the earned rewards be paid out; otherwise, the rewards continue to accrue and accumulate
  5. USD value of rewards earned each week
  6. Amount of rewards each week that have been accrued but not yet paid out
  7. Historical amounts of rewards paid out

Payout wallets

The reward token for liquidity mining campaigns may vary by campaign. Make sure to enter your reward wallet addresses in Hummingbot Miner: settings. If you have not yet provided a valid wallet address for a liquidity mining campaign, the rewards will accrue and be paid out only after you have provided a wallet address.

DISCLAIMER: The websites located at https://hummingbot.io, https://docs.hummingbot.io, https://miners.hummingbot.io (collectively, the "Site") are copyrighted works belonging to CoinAlpha, Inc. ("Company", "us", "our", and "we"). Certain features of the Site may be subject to additional guidelines, terms, or rules, which will be posted on the Site in connection with such features. All such additional terms, guidelines, and rules are incorporated by reference into these Terms. These terms of use (these "Terms") set forth the legally binding terms and conditions that govern your use of the Site. By accessing or using the Site, you are accepting these Terms (on behalf of yourself or the entity that you represent), and you represent and warrant that you have the right, authority, and capacity to enter into these terms (on behalf of yourself or the entity that you represent). You may not access or use the Site or accept the terms if you are not at least 18 years old. If you do not agree with all of the provisions of these terms, do not access and/or use the Site.