← Back to site

Documentation

Everything HODL$ does, and how to check it yourself.

Overview

HODL$ is a Solana token built around one idea: every trade pays the people who didn't sell. A 3% fee on every trade fills a shared reward vault. That vault is airdropped back to holders on a fixed schedule — but not evenly. Your share depends on how many tokens you hold and how long you've held them without selling or moving them out of your wallet.

The site is a read-only dashboard. There's no swap widget, no staking, no claim button to click — early airdrops are sent directly to holders' wallets. You don't need to connect a wallet or sign anything to use it.

The vault

3% of every buy and sell is collected automatically at the trade level and routed into the reward vault. The vault balance, in SOL, is visible live on the homepage stats bar. Nothing in the vault goes to a team wallet, marketing wallet, or anywhere else — it exists to be paid back out to holders.

How your score is calculated

Your score for a given epoch is:

score = balance × minutes held × tier multiplier

Your share of that epoch's pool is your score divided by the sum of every holder's score. This is why a wallet holding a small bag for weeks can out-earn a wallet holding a much larger bag that trades in and out — time is weighted just as heavily as size.

The reset rule

Selling or transferring any amount of HODL$ out of your wallet resets your hold timer to zero. It doesn't matter if you sell one token or your entire bag — the clock restarts from that moment, and you drop back to the "Paper" tier with no multiplier.

This is deliberate. The mechanic only works if holding has a real, growing cost of leaving. Moving tokens between two wallets you own still counts as a transfer out — there's no way to preserve hold time by hopping wallets.

Loyalty tiers

Multipliers apply from launch, based on your current (unbroken) holding streak:

Epoch schedule

An epoch is one payout cycle. Early epochs are short so holders see the mechanic working right away; the cadence stretches out as the token matures:

The countdown on the homepage always shows time to the next epoch boundary, resynced against server time on every refresh — it doesn't trust your device's clock.

Leaderboard

Each epoch shows the top 10 highest-scoring wallets ("diamond hands") and the 5 most recent wallets to reset their clock by selling ("paper hands"). All wallets are shown truncated (first 5 / last 5 characters) — this data is derived entirely from public on-chain activity, nothing private is exposed.

Verifying payouts

Every epoch publishes a permanent, plain JSON record at /epochs/epoch-<n>.json containing the exact pool size, every recipient wallet, their score, their share, and the lamports they were paid. The "verify the math" link next to each row in the epoch history table opens that file directly. Nothing about a payout is trust-based — anyone can re-derive every wallet's share from balance × hold time and check it against what was actually paid.

Checking your wallet

Paste any Solana address into the panel on the homepage. It looks up that address's current balance, hold time, tier, score, and projected next payout. This is read-only — pasting an address never grants the site any access to that wallet, because there's nothing to grant. No signature, no approval, no wallet connection is required at any point.

API reference

The dashboard is powered by static JSON files, polled every 15–30 seconds. No websocket, no backend session, no auth.

GET /api/stats.json

Vault balance, total paid out, holder count, 24h volume, current epoch number, and the next epoch's timestamp.

GET /api/holders.json

Keyed by wallet address. Each entry has balance, hold-start timestamp, minutes held, tier, multiplier, score, epoch share %, and estimated next payout.

GET /api/leaderboard.json

The current epoch's top diamond hands and most recent paper hands.

GET /epochs/epoch-<n>.json

The permanent, immutable record of one completed epoch: pool size, mode, and every wallet's individual payout.

All lamport and SOL values in the API are lamport strings (divide by 1e9 to display SOL). Token balances use 6 decimals (divide by 1e6).

FAQ

Do I need to claim my airdrop?

No. Early epochs send SOL directly to holders' wallets — there's nothing to claim.

What counts as "selling"?

Any outbound transfer of HODL$ from your wallet — a sale on a DEX, or a transfer to another address, including your own.

Can I buy back in after a reset?

Yes. Your hold clock simply restarts from zero the moment you hold again.

Is this audited?

Contract and audit details will be published here once finalized. Always verify the contract address on the homepage before trading.