Docs

How Hooked works.

Everything a launcher or a holder needs to know: what a hook does, every rule and its settings, how launching and graduation work, and where the fees go.

What Hooked is

Hooked is a launchpad for Solana tokens with rules built into the token itself. You pick a rule when you launch, for example “no wallet can hold more than 1% of supply” or “it only moves wallet to wallet”, and the token enforces it on every transfer, forever or until it graduates. There is no bot to trust and no website that could stop enforcing it: Solana runs the check inside the transfer, and a transfer that breaks the rule simply fails.

Tokens launch on a Meteora bonding curve. Hooked never holds your keys: your wallet signs every step, and Hooked only records the launch in its public list after checking it on-chain.

How a hook works

Hooked tokens are Token-2022 tokens with a transfer hook: the mint names a program, and Solana calls that program on every single transfer of the token (every buy, every sell, every wallet-to-wallet send). The program can read the transfer (who is sending, who is receiving, how much, what they hold) and refuse it. If it refuses, the whole transaction fails and nothing moves.

One hook per token. A token can name only one hook program. Most tokens get one rule; the combined hook carries several rules in one program (see Combining rules).
It can't be switched off. Neither you nor Hooked can turn the rule off after launch. The only thing that removes it is graduation (see below), and only on a graduating curve.
Every rule has been tested on-chain. Each rule was launched on devnet and tested with real Meteora trades: the rule refusing what it should, allowing what it should, and holders being able to sell where the rule allows it.

Launching a token

Your token. Name, ticker, an image (required) and optional description and links (X, Telegram, website). Supply is fixed at 1,000,000,000.
Pick its rule and set it up. The launcher explains each setting in plain numbers as you change it.
Curve. Graduating (the default) or permanent, plus the starting and graduation market caps in dollars.
Sign. Your wallet signs: the metadata upload, the token and its Meteora pool, switching the rule on, and listing it on Hooked. Paired rules (Beacon + Entangled, Reactive pair) launch both tokens in one go.

Budget about 0.1 SOL for rent and network fees, plus anything the rule itself funds (for example a Buyer rewards vault). If a step fails, nothing is lost: press Launch again and it carries on from where it stopped.

Curves and graduation

Graduating curves move to a normal Meteora pool once they reach the graduation market cap. Meteora removes the token's hook in the same buy that fills the curve, so from then on the token trades like any other and the rule no longer applies. Rules that only make sense during launch (P2P-only) always graduate.

Permanent curves never graduate, so the rule runs for the life of the token.

Trading a hooked token

Most rules only need the token's own on-chain settings, so their tokens trade on any DEX or router that supports Token-2022 transfer hooks. A few rules need to know about the individual buyer (their vesting clock, their allowlist proof), and those trade through Hooked's own swap route; each rule below says which.

Every rule

Who can hold

Allowlist

Trades via the Hooked route

You upload a list of wallets at launch. Only those wallets can receive the token, checked against a Merkle root with a proof carried in the trade.

Hook program: · Solscan ↗

Holder-gated

Trades via the Hooked route

To receive this token a wallet must already hold a token you pick: a membership token, an NFT or another coin. The hook checks the receiving wallet's balance of it on every buy and transfer.

Gate token mint: wallets must hold this token to receive. an address you enter

Hook program: · Solscan ↗

When you can sell

Holder vesting

Trades via the Hooked route

Each wallet's tokens unlock on their own clock from the moment it buys: nothing during the cliff, then a fixed share every period, from every hour to once a week. Vest every wallet, or only the ones that buy early, like a presale. A wallet can only sell what it has unlocked.

Only vest early buyers: 0 = every wallet vests. Otherwise only wallets whose first buy lands within this many hours of launch vest; later buyers are free. 0 hours by default (0 to 168)
Cliff: no tokens unlock until this long after a wallet's first buy. 24 hours by default (0 to 168)
Unlock each period: how much of a wallet's bag unlocks every period after the cliff. 10 % by default (0.1 to 100)
Unlock period: how often an unlock happens: 1 = hourly, 24 = daily, 168 = weekly. 24 hours by default (1 to 168)
Slot-rent pool: pre-funds the per-wallet slots created on each first buy (~0.0014 SOL each). 0.5 SOL by default (0.1 to 10)
Minimum qualifying buy: anti-drain: a buy must be at least this big to open a slot. 0.05 % supply by default (0.001 to 1)

Hook program: · Solscan ↗

Anti-dump caps

Trades on any DEX

The hook tells buys from sells and caps each side separately, so people can buy freely while no single trade can dump a big bag.

Max per buy: the largest amount one buy can acquire (0 = no buy cap). 2 % supply by default (0 to 5)
Max per sell: the largest amount one sell can offload — set this tighter than the buy cap for anti-dump. 0.25 % supply by default (0.1 to 2)

Hook program: · Solscan ↗

Graduated sell caps

Trades on any DEX

Small holders sell freely, but the bigger a wallet's bag, the smaller its per-sell cap, down to a floor. A whale can build a position but can't dump it in one sell. Nothing to fund and no minimum buy: the hook reads the bag straight from the sell.

Sell cap for small holders: the most a small holder can sell in one go. 1 % supply by default (0.05 to 5)
Sell cap for the biggest bags: the least any wallet can sell in one go. 0.1 % supply by default (0.01 to 1)
Bag size that gets the smallest cap: a wallet holding this much or more can only sell the smallest cap at a time. 3 % supply by default (0.5 to 10)

Hook program: · Solscan ↗

Fair launch

Max per wallet

Trades on any DEX

After every buy or transfer the hook checks what the receiving wallet now holds, and refuses the trade if it would go over your cap, for example 1% of supply. The Meteora pool and your own wallet are exempt. Nothing to fund and no per-wallet setup.

Max per wallet: 1 % supply by default (0.1 to 5)

Hook program: · Solscan ↗

Chapters

Trades on any DEX

A max per wallet that grows with the token. It starts small, for example 1% of supply, and doubles every time the total volume traded crosses another chapter, for example every 10,000,000 tokens. Selling back into the pool always works.

Starting max per wallet: 1 % supply by default (0.1 to 5)
Volume per chapter: the cap doubles every time this many more tokens have traded. 10,000,000 tokens traded by default (1,000,000 to 100,000,000)

Hook program: · Solscan ↗

Trade guard

Trades on any DEX

Every buy, sell and transfer is capped at the same share of supply, for example 0.5%. Anything bigger is refused inside the swap, so no whale can grab or dump a big bag in one trade.

Max per trade: 0.5 % supply by default (0.05 to 10)

Hook program: · Solscan ↗

Anti-bundle

Trades on any DEX

The hook counts trades in each Solana block and refuses any past your limit. A bundler packing many buys into one block gets the first few at most, so nobody can buy up the launch in a single shot.

Max trades per block: 3 trades by default (1 to 20)

Hook program: · Solscan ↗

Where it trades

Venue-locked

Trades on any DEX

Trades only through its Meteora pool. A plain wallet-to-wallet transfer is refused, so every trade hits your official liquidity and nobody can move the token quietly off-market between wallets.

Hook program: · Solscan ↗

DEX-only

Trades on any DEX

Moves only when a program moves it, like a swap on the Meteora pool. A plain wallet-to-wallet send is refused, so the token can't be passed around off-market. Buying and selling through the pool work normally.

Hook program: · Solscan ↗

FOMO-only buys

Trades on any DEX

It can only be bought through the FOMO app. The hook checks that FOMO's own signing wallet co-signed each buy and refuses any buy that didn't come through FOMO. Launching includes a required dev buy. The dev wallet is also permanently whitelisted, so you can buy anywhere with it. Everyone else can only buy on FOMO. This lets the dev open up the pool on FOMO, which takes a few buys to trigger. Selling and sending always work, and the rule ends when the curve graduates.

Dev buy: required: your first buy from the curve, made right after the rule is switched on. 0.1 SOL by default (0.01 to 10)

Hook program: · Solscan ↗

Pump App only

Trades on any DEX

It can only be bought in the Pump app. The hook checks that each buy runs inside the Pump app's own program and refuses any buy that doesn't, including ones through pump.fun's shared router or other apps. Launching includes a required dev buy, and the dev wallet is permanently whitelisted, so you can buy anywhere with it. Selling and sending always work, and the rule ends when the curve graduates.

Dev buy: required: your first buy from the curve, made right after the rule is switched on. 0.1 SOL by default (0.01 to 10)

Hook program: · Solscan ↗

P2P-only

Trades on any DEX

The opposite of Venue-locked: it moves only wallet to wallet, and nobody can buy or sell it on a market. Only you can buy from the bonding curve, even all of it, and hand tokens out. When the curve fills up it graduates, the rule switches off, and it trades normally.

This rule always uses a graduating curve.

Hook program: · Solscan ↗

Who gets paid

Buyer rewards

Trades via the Hooked route

Fill a vault with any token or with NFTs. Every qualifying buy earns the buyer a reward, which they collect on Hooked, even if they've never held that token. Buys only earn while the vault can cover them. You can withdraw anything not already owed to buyers.

Minimum buy to earn: smaller buys earn nothing, so dust buys can't drain the vault. 0.05 % supply by default (0.001 to 1)
Reward-record rent pool: pays the one-time rent for each new buyer's reward record (about 0.0011 SOL each); you can withdraw what's unused. 0.05 SOL by default (0.01 to 5)

Hook program: · Solscan ↗

Tithe

Trades via the Hooked route

The same enforcement as a royalty, but the payment goes to a cause you name: a charity, a treasury, a public-goods fund.

Recipient address: the wallet every trade donates to (a charity or treasury). an address you enter
Donation per trade: 0.005 SOL by default (0.001 to 0.5)

Hook program: · Solscan ↗

Linked tokens

Reactive pair

Trades on any DEX

Two tokens that watch each other. Each one's per-buy cap loosens while the other is being bought and tightens while it's being sold, so momentum in one opens the door in the other. Sells are never capped. Launch the two together.

Partner token mint: an address you enter
Base cap: the per-buy cap when the partner is flat. 1 % supply per buy by default (0.1 to 10)
Sensitivity: how far the cap moves for each 1% of the partner's supply bought (or sold) on net, as a share of the base cap. 25 % by default (1 to 100)

Hook program: · Solscan ↗

Entangled

Trades on any DEX

Stays locked until its Beacon token's market cap reaches the target you set, for example $20,000. Then it unlocks for good, even if the Beacon falls back later. Launch the two as a pair.

Beacon token mint: an address you enter
Unlocks when the Beacon's market cap reaches: $20,000 by default, from $1,000

Hook program: · Solscan ↗

Beacon

Trades on any DEX

Trades freely with no cap. Its hook remembers the highest market cap it has reached, and hitting the target is what unlocks its Entangled partner.

Hook program: · Solscan ↗

Combining rules

Switch the launcher to Combine rules to put two or more rules on one token. They run inside a single hook program, the combined hook, which checks every rule you picked on each transfer and skips the rest. Each rule behaves exactly like its single-rule version, with the same settings.

Rules you can combine: Trade guard, Anti-dump caps, Graduated sell caps, Max per wallet, Chapters, Anti-bundle, DEX-only, FOMO-only buys.
Pairs you can't: Trade guard with Anti-dump caps (both cap the size of a trade); Anti-dump caps with Graduated sell caps (both cap the size of a sell); Max per wallet with Chapters (both cap how much one wallet holds). Pick one of each pair.
Your wallet is exempt from Max per wallet, Chapters and FOMO-only, so the dev buy works. It is not exempt from the per-trade caps, so keep the dev buy under them.
Fixed at launch. The set of rules and their settings can't be changed later, and combined tokens trade on any DEX, like the single rules they're made of.

These rules stay single-rule only: Holder vesting, Allowlist token, Holder-gated, Venue-locked, P2P-only, Buyer rewards, Tithe token, Reactive pair, Beacon, Entangled. They either need Hooked's own swap route, pay out on trades, or launch as a pair.

Combined hook program: · Solscan ↗

Fees and the flywheel

Every trade on a Hooked bonding curve pays a 1% fee. It all goes to the platform flywheel, not the token's creator. The flywheel runs every 10 minutes and:

collects the fees from every Hooked pool,
sends 15% to the dev wallet ,
uses the other 85% to buy the Hooked token on the market and burns everything it buys.

Until the Hooked token is trading, the buyback share is held and spent on the first run that can buy it. When a curve graduates, the platform's share of Meteora's migration fee goes through the flywheel too, and so do the trading fees earned by the platform's permanently locked liquidity in the graduated pool, for the life of the token.

Flywheel wallet: · Solscan ↗

Loading the burn numbers…

What you're trusting

Your keys stay yours. Every transaction is built in your browser and signed by your wallet.
The rule is enforced by Solana, not by Hooked. Once a token is live, Hooked's website and servers could disappear and the rule would keep running.
The hook programs can still be upgraded by Hooked's deploy wallet, so bugs can be fixed. That is a trust assumption, and we'll say so clearly if that ever changes.
Some rules give the creator a lever, and each one says so: Max per wallet lets the creator exempt up to 15 extra wallets, and Reactive pair lets the creator retune its settings.
Everything here runs on Solana mainnet. Every program address above links to Solscan so you can check it yourself.

Launch a token