Overview
Quick Start Guide
Welcome to HODL Club for Solana projects. Ready to send your project to the moon? Dive into our Telegram bot with no-brainer step-by-step guides or kick back and let our video tutorials show you the ropes.
Get started in a few simple steps:
- Create your Club and Reward structure first. Then prep your content for each.
- Install the HODLClub_bot
- Run the setup command to add your project token and other details.
- Setup and link your HODL Clubs
- Add reward bonuses
- Announce it to your community.
- Watch the good times roll
Upgrade to HODLClub Pro
Ready to moon your crypto project? Strap in, fella. Want extra HODL Clubs or bonus reward milestones? Pro’s got your name on it. It even upgrades wallet verifications to every two weeks and then some.
Just run /hodl_pro and stock up on credits with SOL or $HODAI. Credits run $1 each or score 25% off with $HODAI. Flip on Pro for 1 credit per day. Need daily wallet checks? Add that on for 1 extra credit a day.
(video goes here)
-
How are wallets verified?
HODLClub will confirm each member with a quick, one-time transaction for each wallet.
Your community can simply use the /hodl_verify command, which will ask them to send $1 of your token to a specific wallet address and then reply with the Signature (Tx hash ID) from SolScan.
This transaction checks their token balance on-chain, making sure everything is secure and accurate without ever revealing their private keys or wallet info.
Simply put, no sketchy wallet connections.
-
How do automated reward airdrops work?
Upon initial setup you are able to fund your reward wallet with your TOKEN and SOL for transaction fees.
HODL Club keeps an eye on how long each verified member holds their tokens and gives them rewards when they hit important milestones. You can set up custom milestones, like 30, 60, or 90 days, and decide on the reward amounts.
When a member reaches a milestone, the bot automatically sends tokens straight to them, so no need for manual tracking. Plus, club multipliers can give extra rewards to members in higher tiers.
-
What's the difference between paying with SOL vs. $HODAI?
Paying with SOL costs $1 per credit, while paying with $HODai offers a 25% discount, costing just $0.75 per credit.
Additionally, when you pay with $HODai, a portion of those tokens are burned at certain milestones, permanently reducing the total supply. This deflationary mechanic benefits the $HODai project by increasing scarcity, adding long-term value for holders.
Choosing $HODai not only saves you money but also strengthens the ecosystem.
-
How does the club automation work?
When you create a HODL Club, just pick how many tokens someone needs to flex for access and perks.
Once they verify their wallet, the bot will auto-invite them into the right club. If they sell or dip below the required amount, the next verification cycle will boot them out and trigger the Shame post if you have that turned on.
-
Where does the $1 verification fee go?
Good question! In short, it goes to support the ongoing development of the bot as well as pay for API calls, server costs, and more that rack up over time.
-
What if a whale has multiple wallets?
No worries! Every member of your Telegram community can verify all the wallets they own. So, even if they've spread their assets across different wallets like a savvy whale, they can still join the club.
Setup Process
Step 1: Preparation
Before you unleash HODLClub you’ll want to do a little prep to juice your project.
First, map out your club tiers. Pick token thresholds that push your community to buy more and HODL harder. For each tier choose a name, upload a custom image, write a snappy description, set the token requirement and reward multiplier.
Next, design your reward roadmap so you can pay back the real ones. Pro users can stack multiple milestones and watch loyalty skyrocket.
Now for the fun part: Auto Flex & Shame posts. Upload your own graphics and craft hilarious captions for every whale sighting or paper-hands moment.
Do your homework up front and you’ll have HODLClub up and running in no time.
You can visit the Template Library to get ideas.
Bot Installation
Here’s the easy part. Make sure you’re an admin or owner so you can add members and grant admin rights. First, invite @HODLClub_bot into your main group, then promote it to admin and turn on all required permissions.
Next, go into each Club Group Chat you’ve set up and do the same: add the bot as a member, make it an admin, and enable those permissions.
Once that’s done you’re all set.
Initial Setup
In your main group chat run the /hodl_setup command. The bot will then DM you to finish the setup.
First, set your community’s $TOKEN. You’ll be prompted to paste your Solana contract address, so have it ready.
Next, pick a killer name for your crew. Upload a custom promo image or stick with the default if you’re feeling lazy. Then drop in some hype text to get everyone amped for HODLClubs and Rewards.
If you plan on using the reward feature (which you definitely should), fund your reward wallet next. This wallet is all yours, so treat it like your private stash. Load it up with enough project tokens and a bit of SOL for those auto-airdrops. Give it a minute after funding before you check the balance.
Finally, set the minimum token amount required for wallet verification. Pro tip: don’t make it too low or too high since every verified wallet will qualify for your rewards.
Admin Seats
Need your crew to help set up or manage HODLClub? We’ve got you covered. Run /hodl_access and you’ll see a list of your current Telegram admins. Pick who gets the power to use HODLClub commands.
Next, choose their rank:
-
Super Admin gets full control.
-
Normal Admin can do everything except touch the Reward Wallet so your private keys stay locked down.
Create Clubs
Here’s the fun part... Creating your HODL Clubs. In your main group run /hodl_club and follow the DM prompts.
- Basic communities get 1 club.
- Pro communities get up to 5 clubs.
Before you dive in, create a new private Telegram group for your club hangout.
In the DM click “Add Club,” pick a badass name, upload a custom image, write some hype copy, set your token threshold and optional reward multiplier.
Preview it to make sure it slaps.
Then in your private group (make sure @HODLClub_bot is added as admin) run /hodl_club_link, select your main community name and pick the club you built.
Boom you have a club.
Create Rewards
Creating rewards for HODLing is a killer way to pump up your whole community—not just club members but everyone stacking bags. More HODLing equals more hype.
In your main group run /hodl_reward and follow the DM prompts to set it up.
- Basic plan gets 1 reward
- Pro plan gets up to 10 rewards
First fund your reward wallet so the bot actually has tokens to drop. Then click Add Reward. For each reward give it a name like “3-DAY HODL Streak,” upload an image and write a hype description. Set how long members must HODL to earn the airdrop and choose the reward amount.
Once someone verifies their wallet the countdown begins.
Set Flex Messages
Everyone loves a subtle flex so let your top HODLers show off when they unlock your exclusive HODLClubs.
Flex messages crank the hype and fuel FOMO.
In your main group run /hodl_flex and follow the DM prompts.
-
Basic plan gets 2 flexes
-
Pro plan gets up to 10 flexes
You can trigger flexes on club entries or reward milestones. Mixing multiple flexes across different clubs and rewards keeps things fresh.
When you create a flex:
-
Pick your trigger (club or reward) and assign it to the correct club or milestone
-
Upload an eye-catching image and write a punchy headline
-
Drop in some hype text and use {mention} to tag the legend who just flexed
Set Shame Messages
Everyone loves a little tough love. Keep paper hands in check with HODLClub’s Shame feature.
Run /hodl_shame and follow the DM prompts to set it up. Pick your trigger, then upload a custom image or GIF, write a savage headline and description, and use {mention} to call out the culprit.
Shame posts fire off when the next wallet check runs (monthly on Basic, bi-monthly on Pro, or daily if you’ve added that upgrade). We’ll space them out so you don’t get spammed when a bunch of jeets dump their bags.
User Commands
Wallet Verification
To join HODL Clubs or earn Rewards you need to verify your wallet(s). Run /hodl_verify in the main group and complete the setup in DM. If you have multiple wallets just click “Verify Wallet” for each address.
You will be asked to send a small amount (about $1 worth) of your token to the dev wallet. Then paste the transaction signature (Tx hash) to confirm. Wait about 20 seconds for the transaction to process before copying it.
Once verified the bot totals your token balances across all linked wallets and automatically invites you to any HODL Clubs you qualify for. You can check the status of your wallet(s) at any time to view your club memberships and see how many days until your next reward.