05 / docs

How a hook
actually works.

A hook is a published fee policy attached to your coin at mint. This page is explicit about which parts a contract enforces and which parts you execute.

1 · Where creator fees come from

A pump.fun launch earns the creator a share of trading fees for as long as people trade the coin. Normally that stream lands in one wallet and no buyer ever finds out what happens to it.

2 · What a hook adds

When you launch through Routed you pick one of the ten hooks — or write your own — and the routing rule is serialised into the token's metadata before the mint transaction is signed. It travels with the coin, so anyone reading the metadata sees the policy.

3 · What is and is not enforced

Read this part. The mint is real: the coin is created on pump.fun through PumpPortal's local API and signed by your own wallet on Solana mainnet. The hook, however, is a published policy recorded in metadata. Executing it is an action you take from Positions — claiming the fees and sending the transactions. The pump.fun bonding-curve contract does not enforce it, and nothing on-chain forces the fees to move that way. Treat any coin's hook as a stated, timestamped commitment — not a trustless guarantee.

We would rather say that plainly than imply a guarantee that does not exist. Contract-level enforcement is the direction, not the current state.

4 · Running a hook

From Positions, Run this hook does four things: claims your accumulated creator fees, measures what actually arrived, converts the split into concrete amounts, and executes each leg.

Shares below roughly 0.002 SOL are skipped — a transfer that small costs more in fees than it delivers.

5 · Writing a custom hook

The custom box takes plain language and compiles it into a normalised split. It reads shares (half, a quarter, 40%, the rest), destinations (burn, holders, liquidity, jackpot, buyback, treasury, referrers, airdrop, creator, marketing) and cadence (hourly, daily, every 6 hours, each trade).

Anything unclaimed falls back to liquidity and the result is always normalised to exactly 100%, so a launch can never carry a broken split. It runs in your browser and is deterministic — no model call, so it cannot stall or invent a destination you did not name. It does not understand conditions: “burn if we hit 100k” compiles to a plain burn.

6 · Cost

Routed takes no cut at mint. You pay Solana network fees and whatever optional dev buy you set. The creator share your hook defines is yours to route.