# Hookr.fun: full agent reference > Hookr.fun is modular infrastructure for surfacing, composing and integrating custom Uniswap hooks on Robinhood Chain (chain id 4663), Monad, Arbitrum and Elysium. > New pools open on Hookr: one Uniswap v4 hook with Hook Blocks chosen per pool, for a new fixed-supply > token or a token that already trades, run on Hookr's shared hook or on a hook you deploy. > This document is a discovery aid, not deployment evidence, a transaction receipt, financial > advice, or a substitute for the checked-in release manifests and block-pinned contract reads. ## Canonical identity - Product: [Hookr.fun](https://hookr.fun/) - Official X account: [@hookrfun](https://x.com/hookrfun) - Account status: Hookr recovered and confirmed control of @hookrfun on August 25, 2026. - Networks: Robinhood Chain (chain id 4663), Monad (143), Arbitrum One (42161) and Elysium (99901); the rest of this document describes Robinhood Chain. - Token identity rule: a token is its contract address plus chain, never its ticker alone. - Affiliation boundary: Hookr uses a permissionless, pool-first model familiar from pools.trade, but Hookr is independent and is not affiliated with pools.trade. - Release boundary: source, local tests, candidate addresses, or UI copy do not prove a release. The applicable manifest, runtime identity, ordered receipts, canonical finality, and readback do. ## What Hookr is - Hookr is infrastructure for Uniswap v4 hooks. A Hook Block does one job and has settings the contracts bound; a pool runs the blocks its creator picked, as one hook. - Launching a token into pools is one use of the same Hook Blocks, beside integrating them with a project and surfacing any hook's pools. - Two ways to run a hook: on Hookr's shared hook, HookrRoot, with nothing to deploy, or on a hook you deploy that runs the same Hook Blocks, Exit Clock and Holder Pot aside (closed on the core it copies). A pool's hook is fixed when it opens. - The [builder](https://hookr.fun/builder) composes a hook from Hook Blocks and checks the combination; its output can be deployed as your own hook, handed to integrators, or launched with. - Hook Blocks Market, listed below, is where builders publish add-on blocks bonded in HOOKR; every swap in a pool that installs one pays its usage fee. ## Launch model - A launch goes through HookrLauncher. One transaction creates a new fixed-supply token, or names an existing one, and opens one to eight pools on HookrRoot, each with its own quote and Hook Blocks, frozen when the pool opens. - On Robinhood Chain, hookr.fun puts a new token's whole supply in its pools, the token alone from each pool's opening price up, at a $20,000 market cap unless a price is typed; several pools split it evenly as supply weights. The creator sends nothing beyond gas and keeps none of the supply, and buyers bring the quote, each buy moving the price up. An optional dev buy, one per pool within its per-block buy cap, leaves the creator at most 5% of the supply. hookr_build_launch opens its one pool the same way by default. - The creator controls the launch's positions, whose principal stays in its pools until the last launch guard ends, or a later block the launch chose. - A pool's quote is native ETH, one of the 22 catalog assets the registry lists, a Robinhood stock token or, shown as unreviewed, any other token. - A creator can also deploy a hook of their own, an owned root running Hookr's hook with the Hook Blocks of a saved hook. - Wallet Cap, on Hookr's hook, caps how much of the supply each paying wallet can buy while a pool's launch guard lasts, counted across every pool of the launch. It limits each paying wallet, not each person. - Right after a launch, the app offers to lock its liquidity for good in Hookr's launch lock. Pool pages, token pages and Discover say whether a launch's liquidity is locked for good, until a date, or not. ## Hook Blocks A pool's Hook Blocks are fixed when it opens. No owner function retunes them after the pool opens. Each page below states the block's settings and limits. - [Anti-Snipe](https://hookr.fun/hooks/anti-snipe): Caps early buys and charges a Snipe tax while the launch guard lasts - [Dynamic fees](https://hookr.fun/hooks/dynamic-fees): Fee scales with how far a swap moves the price - [Auto Burn](https://hookr.fun/hooks/auto-burn): Burns a share of actual buy output - [LP Rewards](https://hookr.fun/hooks/lp-rewards): Adds an LP fee on buys, paid to the LPs that filled them - [Wallet Cap](https://hookr.fun/hooks/wallet-cap): No wallet can buy more than a set share of the supply while the launch guard lasts - [Arbitrage recapture](https://hookr.fun/hooks/arb-recapture): Pool keeps price-gap profit. A Uniswap v4 Hook Block on Hookr's hook: 25% to What The Hook's executor, 15% to Hookr on pools on Hookr's core and 25% on the other Rules, the rest to the pool - [Market Guard](https://hookr.fun/hooks/market-guard): Swaps that stray from a live Chainlink price pay the pool's LPs a surcharge - [Market-hours fee](https://hookr.fun/hooks/market-hours-fee): A fee that follows the US stock market's sessions - [Managed fee](https://hookr.fun/hooks/managed-fee): A surcharge Hookr's keeper moves as the price moves, inside a cap you fix at launch - [Zap Relay source](https://hookr.fun/hooks/zap-relay-source): Routes a cut of every buy to a zap vault that buys another pool - [Zap Relay target](https://hookr.fun/hooks/zap-relay-target): Only zaps from its source pools may buy, and anyone may sell - [Swap Reward Mint](https://hookr.fun/hooks/swap-reward-mint): Pays traders a reward token for each swap, funded by a slice of the trade - [Usage fee](https://hookr.fun/hooks/usage-fee): Deploying soon. Hookr's Hook Blocks Market block: every swap pays a usage fee to its builder, its backers, Hookr and a reserve - [Pay Later](https://hookr.fun/hooks/pay-later): Buyers pay a premium now for the right to buy at a fixed price later - [Dev Drip](https://hookr.fun/hooks/dev-drip): Deploying soon. Release your allocation through the pool a slice per window, never faster - [Vesting Milestone](https://hookr.fun/hooks/vesting-milestone): Lock a team allocation that vests after a cliff, then in a straight line - [Limit orders](https://hookr.fun/hooks/limit-orders): Set a price and escrow the trade. Once the pool gets there, anyone can fill it, you included - [Best route](https://hookr.fun/hooks/best-route): Checks Uniswap pools for the same trade and offers a better route only when it clearly beats this pool - [Recovery reserve](https://hookr.fun/hooks/recovery-reserve): Money a pool's owner sets aside in public view after launch, filled by anyone's top-ups, that pays back LPs or traders after a reviewed incident - [Canonical Venue Token](https://hookr.fun/hooks/canonical-venue-token): A token that trades only on its own pool, for assets that must stay on one known venue - [Hook Blocks Market](https://hookr.fun/hooks/hook-blocks-market): Builders publish add-on blocks bonded in HOOKR, and every swap in a pool that installs one pays its usage fee - [Entry Ratio Guarantee](https://hookr.fun/hooks/entry-ratio-guarantee): LPs can lock in their entry amounts, paid for out of their fees - [Floor bid](https://hookr.fun/hooks/floor-bid): A treasury keeps a standing bid below the price - [Pool Mesh](https://hookr.fun/hooks/pool-mesh): One zap vault that feeds up to four Zap Relay targets on one quote, split by weight or toward the thinnest, from a cut of every buy on its source pools - [Fee Bridge](https://hookr.fun/hooks/fee-bridge): Takes a royalty or a tax and pays it, a capped drip at a time, to another pool's in-range LPs - [Family Pinger](https://hookr.fun/hooks/family-pinger): Runs every zap and payout a family has due in one call, for a tip from its own budget - [Dev buy and dev buy lock](https://hookr.fun/hooks/dev-buy): Buy at launch, and lock the pools' liquidity, 7 days by default - [Liquidity lock](https://hookr.fun/hooks/liquidity-lock): Lock the pools' liquidity for up to 100,000 blocks after launch, about 14 days, with or without a dev buy - [Supply you keep](https://hookr.fun/hooks/supply-you-keep): Declare on chain the most of the supply you hold when the launch returns - [Multi-pool launch](https://hookr.fun/hooks/multi-pool-launch): Open your token in up to 8 pools at once, each on its own quote - [Supply split](https://hookr.fun/hooks/supply-split): Seed each pool with an exact share of the supply, declared on chain - [Opening price check](https://hookr.fun/hooks/opening-price-check): The launch reverts if a pool opens off pool 1's price, converted through a pool you name - [Referrals](https://hookr.fun/hooks/referrals): Referral codes that credit the wallet that brought a trader - [Exit Clock](https://hookr.fun/hooks/exit-clock): Sellers pay a fee that falls as the pool ages, or with each seller's time held on a per-holder clock, so quick flips pay and nobody is locked in. A new token launched on Hookr from 1 November 2026 keeps its own hold time unless it follows a saved hook or opens on a hook of your own; on any other token the creator picks a clock for the whole pool or one per holder, and anyone can trim a holder's record for free - [Holder Pot](https://hookr.fun/hooks/holder-pot): Sandwich Guard's charges fill a pot each day, and it pays the wallets that held the token, by how much they held and for how long - [Swap Cut](https://hookr.fun/hooks/swap-cut): Takes a fixed cut of each buy and each sell, set at launch, for the pool's liquidity owner - [Sandwich Guard](https://hookr.fun/hooks/sandwich-guard): A swap that moves the price back toward where its window opened pays that move, so a sandwich around a trade loses - [Agent gate](https://hookr.fun/hooks/agent-gate): Only ERC-8004 agents, or wallets linked as an identity's agent wallet, can buy, sell or add liquidity, and where the pool's gate asks, a wallet with code links with a proof; removing is never gated. A creator can require a reviewer's score, Priors or its own, to enter or for the base fee, and a link of a set age to enter, 1 hour unless the creator sets it to 0 - [Storm Fee](https://hookr.fun/hooks/storm-fee): The pool fee rises by itself when the price gets choppy and falls back when it calms - [Buy/Sell Block](https://hookr.fun/hooks/buy-sell-block): Pauses buys and locks sells for a set time after launch - [King of the Pool](https://hookr.fun/hooks/king-of-the-pool): The biggest buy of each round takes the pot arbitrage recapture fills, up to half of Hookr's share of LP Rewards and Auto Burn on that buy - Not open on any new pool yet: [Tax + Conversion](https://hookr.fun/hooks/tax-conversion) (a new pool uses Swap Cut), [Creator royalty](https://hookr.fun/hooks/creator-royalty) (a share of LP Rewards paid to a recipient fixed at launch), [Revenue Router](https://hookr.fun/hooks/revenue-router) (shares a royalty among up to 8 payees, fixed at launch), and [Outside Fill](https://hookr.fun/hooks/outside-fill), deploying soon. Arbitrage recapture: What The Hook's executor runs the arbitrage recapture, and if it cannot, the trade goes through without it. Each profit pays 25% to What The Hook's executor, 15% to Hookr on pools on Hookr's core, where new tokens launch, 25% on the other Rules, and the rest to the pool. The split is fixed when the pool opens and is readable from the pool's own Rules. ## King of the Pool - [King of the Pool board](https://hookr.fun/kings): every round on Hookr, who held the crown at the end, the prize credited, and the kings of each quote. - The King of the Pool Hook Block, listed above, and [the docs page](https://hookr.fun/docs/pools/king-of-the-pool): the biggest buy of each round takes a prize from the pot that arbitrage recapture fills, up to half of Hookr's share of LP Rewards and Auto Burn on that buy; a creator sets the round length and the least buy that counts. ETH/HOOKR runs King of the Pool. ## HookrBook [HookrBook](https://hookr.fun/docs/hookrbook) is a set of worked setups. Each page names the pools, the Hook Blocks on each, what runs today, and every step in the builder, with a link that opens the launch floor on that launch. - [HookrBook: Build your own hook](https://hookr.fun/docs/hookrbook/build-your-own-hook): Build a hook from Hook Blocks, deploy it, integrate it and open pools on it, for a launchpad and for an app that manages liquidity. - [HookrBook: Constellation](https://hookr.fun/docs/hookrbook/constellation): Constellation: a HookrBook setup for a flagship launch that shows every way to trade one token. Its pools and the Hook Blocks on each. - [HookrBook: Binary Star](https://hookr.fun/docs/hookrbook/binary-star): Binary Star: a HookrBook setup for two teams launching sibling tokens: a duo, two sides of one game, a token and its DAO. - [HookrBook: Season Ladder](https://hookr.fun/docs/hookrbook/season-ladder): Season Ladder: a HookrBook setup for a project that wants its market to open in stages. Its pools, Hook Blocks and builder steps. - [HookrBook: Creator coin with fan perks](https://hookr.fun/docs/hookrbook/creator-coin-with-fan-perks): Creator coin with fan perks: a HookrBook setup for a streamer, artist or podcast. Its pools, Hook Blocks and builder steps. - [HookrBook: Session pools](https://hookr.fun/docs/hookrbook/session-pools): Session pools: a HookrBook setup for a community whose holders hold Robinhood Stock Tokens. Its pools, Hook Blocks and builder steps. - [HookrBook: Faction league](https://hookr.fun/docs/hookrbook/faction-league): Faction league: a HookrBook setup for a community game with four sides. Its pools, the Hook Blocks on each and every step to build it in the Hookr builder. - [HookrBook: Agent-run token](https://hookr.fun/docs/hookrbook/agent-run-token): Agent-run token: a HookrBook setup for an AI agent with its own treasury and on-chain income. Its pools, Hook Blocks and builder steps. - [HookrBook: Bot-resistant fair launch](https://hookr.fun/docs/hookrbook/bot-resistant-fair-launch): Bot-resistant fair launch: a HookrBook setup for a team that wants early bots to pay the people who stay. Its pools, Hook Blocks and builder steps. - [HookrBook: Game economy, GEM and GOLD](https://hookr.fun/docs/hookrbook/game-economy-gem-and-gold): Game economy, GEM and GOLD: a HookrBook setup for a game with an everyday currency and a premium one. Its pools, Hook Blocks and builder steps. - [HookrBook: DAO commons](https://hookr.fun/docs/hookrbook/dao-commons): DAO commons: a HookrBook setup for a community that launches as a DAO with a treasury. Its pools, Hook Blocks and builder steps. - [HookrBook: Buy-later launch](https://hookr.fun/docs/hookrbook/buy-later-launch): Buy-later launch: a HookrBook setup for a launch that wants buyers to commit before they pay full price. Its pools, Hook Blocks and builder steps. - [HookrBook: Public goods token](https://hookr.fun/docs/hookrbook/public-goods-token): Public goods token: a HookrBook setup for a token that funds public goods. Its pools, the Hook Blocks on each and every step to build it in the Hookr builder. - [HookrBook: Liquidity home](https://hookr.fun/docs/hookrbook/liquidity-home): Liquidity home: a HookrBook setup for an established Robinhood Chain token moving its main depth. Its pools, Hook Blocks and builder steps. - [HookrBook: Guarded ETH/USDG venue](https://hookr.fun/docs/hookrbook/guarded-eth-usdg-venue): Guarded ETH/USDG venue: a HookrBook setup for a market maker or a USDG-native desk. Its pools, Hook Blocks and builder steps. - [HookrBook: Loyalty points](https://hookr.fun/docs/hookrbook/loyalty-points): Loyalty points: a HookrBook setup for a token with a large, long-held community. Its pools, Hook Blocks and builder steps. - [HookrBook: Revenue buyback engine](https://hookr.fun/docs/hookrbook/revenue-buyback-engine): Revenue buyback engine: a HookrBook setup for an app or protocol with real revenue. Its pools, Hook Blocks and builder steps. - [HookrBook: Community bridge](https://hookr.fun/docs/hookrbook/community-bridge): Community bridge: a HookrBook setup for two communities that want a shared market. Its pools, Hook Blocks and builder steps. - [HookrBook: Treasury desk](https://hookr.fun/docs/hookrbook/treasury-desk): Treasury desk: a HookrBook setup for a DAO or foundation holding a large share of its own token. Its pools, Hook Blocks and builder steps. - [HookrBook: Protocol fee share](https://hookr.fun/docs/hookrbook/protocol-fee-share): Protocol fee share: a HookrBook setup for a protocol that wants its stakers paid from trading. Its pools, Hook Blocks and builder steps. - [HookrBook: Fair venue](https://hookr.fun/docs/hookrbook/fair-venue): Fair venue: a HookrBook setup for a high-volume token whose traders want MEV paid back. Its pools, Hook Blocks and builder steps. - [HookrBook: Builder token](https://hookr.fun/docs/hookrbook/builder-token): Builder token: a HookrBook setup for a team that builds Hook Blocks. Its pools and the Hook Blocks on each. - [HookrBook: Stock-hours expansion](https://hookr.fun/docs/hookrbook/stock-hours-expansion): Stock-hours expansion: a HookrBook setup for any token whose holders also hold Stock Tokens. Its pools, Hook Blocks and builder steps. - [HookrBook: Revival kit](https://hookr.fun/docs/hookrbook/revival-kit): Revival kit: a HookrBook setup for a drained or quiet token whose community wants a second run. Its pools, Hook Blocks and builder steps. - [HookrBook: Platform default launch](https://hookr.fun/docs/hookrbook/platform-default-family): Platform default launch: a HookrBook setup for an app or launch platform that wants a house style for its users. Its pools, Hook Blocks and builder steps. - [HookrBook: Fair launch, locked](https://hookr.fun/docs/hookrbook/fair-launch-locked): Fair launch, locked: a HookrBook setup for a team that wants early bots to pay its LPs, and extra rewards for the LPs who lock. - [HookrBook: DAO commons, locked](https://hookr.fun/docs/hookrbook/dao-commons-locked): DAO commons, locked: a HookrBook setup for a DAO that wants its trading tax to reward long-term LPs. Its pools and the Hook Blocks on each. - [HookrBook: Liquidity home, locked](https://hookr.fun/docs/hookrbook/liquidity-home-locked): Liquidity home, locked: a HookrBook setup for an established token that wants outside LPs to move in and stay. Its pools and the Hook Blocks on each. - [HookrBook: LP-first venue](https://hookr.fun/docs/hookrbook/lp-first-venue): LP-first venue: a HookrBook setup for a token that wants its pools to pay LPs every way they can, with extra for the LPs who lock. ## $HOOKR - [$HOOKR token](https://hookr.fun/token) shows $HOOKR's live price, supply and burn total, where the token sits and where it is used. Half of Hookr's treasury fees on Robinhood Chain fund HOOKR burns. - The only $HOOKR contract Hookr has issued is 0x18E674231A58c239Dc7DaeDcffE15Ec3A24cff5c on Robinhood Chain (4663). Any other contract or chain is not Hookr's. ## Public route inventory - [Landing](https://hookr.fun/): product overview, launch paths, Hook Blocks, safety boundaries, and frequently asked questions. - [Builder](https://hookr.fun/builder): compose and validate a hook from Hook Blocks before deploying it, handing it to integrators or launching with it. - [Launch](https://hookr.fun/launch): launch a new fixed-supply token, or open new pools for a token that already trades, with one to eight pools per launch, each with its own quote and Hook Blocks. It also launches a token on Pons whose creator fee pays a revenue token, with a Hookr pool beside it on ETH. Its start screen also leads to Tokenize, to turn fees or income into a revenue token, and to the builder. - [King of the Pool](https://hookr.fun/kings): the board of every round, its kings and its prizes. - [Hook Blocks](https://hookr.fun/hooks): every Hook Block, each on its own page, and hooks published for reuse. - [Discover](https://hookr.fun/app): browse Hookr pools and other Uniswap v4 custom-hook pools, with sorting by available 24-hour volume and TVL. Hookr launch summaries use indexed settled trades; pooled charts and volume use Hookr's pool index where it covers the pool, else live third-party market data; TVL on a Hookr pool is its own balances at current prices, or Not priced. - [Market activity](https://hookr.fun/scan): selected contract events and receipt links. - [Hook Analyzer](https://hookr.fun/scan): read-only analysis for a deployed hook address or pasted Solidity source. It separates pinned bytecode and address permissions, provider-verified source, visible behaviors, and coverage limits. It does not compile, execute, or audit code. - [Hookrs](https://hookr.fun/hookrs): a hookr is a person or agent who composes new market primitives from Uniswap v4 hooks. Registry-backed public creator directory. - [Integrations](https://hookr.fun/integrations): analyze or submit a hook and start a manual partner review. - [StonkBrokers hooks](https://hookr.fun/stonkbrokers): StonkBrokers' six official hooks on Robinhood Chain. Four outside hooks are listed on Hookr with an on-chain Hookr share and trade through Uniswap's Universal Router once the chain shows the share paying Hookr; one is a preset on Hookr's own hook; one is built and not deployed. - [Partner integration standard](https://hookr.fun/integrate/hooks): six typed partner tracks, private technical intake, pinned third-party source manifests, compatibility and risk boundaries, deployment evidence, and distinct Uniswap Hooklist and conditional routing-submission states. - [Listing tiers](https://hookr.fun/docs/integrations/partner-review#listing-tiers): Build on Hookr, Indexed (free), Listed, Integrated and a Custody add-on. Indexing a hook is free. Listing one on hookr.fun needs at least one Hookr route: the interface fee on swaps Hookr's app builds, an on-chain Hookr share, or pools opened through Hookr's launcher, each with a worked example. Hookr never takes the base LP fee and asks no HOOKR bond. - [Get Hookr for your agent](https://hookr.fun/agents): how an agent on Robinhood Chain reads, quotes, swaps, opens pools and claims over the MCP server or the skill file at https://hookr.fun/agents/SKILL.md; a new token's pool opened with one tool call, arbitrage recapture on unless the agent turns it off; a new ERC-8004 agent created from its own wallet, on the page or with `hookr_agent_pass`; the revenue token tools; and the ERC-8004 identity and reputation registries, at the same addresses on Monad, and USDG's EIP-3009 transfers, which x402 settles with. - [Hookr MCP server](https://hookr.fun/docs/mcp): a remote MCP server at https://hookr.fun/api/mcp (Streamable HTTP, POST only, no key). Forty-six tools: hookr_release, hookr_pools, hookr_pool, hookr_blocks, hookr_hook, hookr_kings, hookr_claims, hookr_quote, hookr_check_trade, hookr_open_orders, hookr_revenue_tokens, hookr_revenue_token, hookr_agent_gate, hookr_scan, hookr_docs, hookr_positions, hookr_recaptures, hookr_trades, hookr_token_prices, hookr_pool_chart, hookr_pool_depth, hookr_pool_yield, hookr_kings_history, hookr_lp_lock, hookr_protocol_stats, hookr_own_hooks, hookr_wallet_payouts, hookr_integrators, hookr_income and hookr_agent_pass only read; hookr_build_swap, hookr_build_claim, hookr_build_launch, hookr_build_fill, hookr_build_limit_order, hookr_build_cancel_order, hookr_build_revenue_claim, hookr_build_agent_link, hookr_build_reviewer_set, hookr_build_add_liquidity, hookr_build_remove_liquidity, hookr_build_collect_fees, hookr_build_tokenize, hookr_build_agent_links, hookr_build_agent_income and hookr_build_chop_log build unsigned calls that the wallet signs and sends. One call of hookr_build_launch opens a new token's pool with arbitrage recapture on unless `arbRecapture` is false. The server holds no key and never sends. Every quote states priceImpactBps; at or past 15% price impact, or on a token that is not the official one for its symbol, the answer is refused, an impact that did not read is unknown, and hookr_build_swap builds it only with acceptImpactBps or acceptToken. HOOKR is 0x18E674231A58c239Dc7DaeDcffE15Ec3A24cff5c; another token with the symbol HOOKR is not HOOKR. hookr_scan is HookrScan's screen of any hook address, not an audit, and every answer lists what it cannot see. hookr_positions lists a wallet's positions with the tokenId the liquidity builders take; hookr_recaptures and hookr_trades read a listed pool's arbitrage recapture ledger and newest trades; hookr_token_prices prices tokens in listed pools in USD; hookr_docs searches the docs. hookr_pool_chart, hookr_pool_depth and hookr_pool_yield read a listed pool's hourly price and volume, its liquidity by price and its LP yield; hookr_kings_history, hookr_lp_lock, hookr_protocol_stats, hookr_own_hooks and hookr_wallet_payouts read King of the Pool's past rounds, a pool's LP lock, Hookr's totals, the own hooks deployed through the factory and a wallet's vesting and payee splits; hookr_integrators says whether accounts are on the treasury's integrator list for integrator share, at what rate, and any change proposed. hookr_revenue_token gives a revenue token's price in its market's quote and in USD, and its ERC-8004 agent where the agent's record lists it; a price that did not read is unavailable with the reason. hookr_income is the income record of one revenue token, one wallet or one ERC-8004 agent over the last 1 to 30 days, each payment with its transaction; a part that did not read is unavailable, never zero. hookr_agent_pass reads one agent in one call, by its id or its wallet, and also returns the unsigned calls of the first step of its path that is not met. hookr_build_agent_income builds an ERC-8004 agent's own payments as a revenue token, one stage per call: the agent income door for the token's predicted address, the mint with USDG listed, then the link in the agent's record; pass the same terms on every call, and pay the door only once `doorTakesPayments` is true. hookr_build_chop_log opens a Chop log for a token through Hookr's lock and locks its LP, in up to three sends, one stage per call; Chop's upgrader key can change the logs, and Hookr takes 5% of each fee batch. hookr_build_agent_links builds the Agent gate's link for up to 25 agent ids, each sent by that agent's own wallet or its owner. hookr_blocks also names outside Hook Blocks, ones other builders wrote that Hookr reviewed, with what each charges and who is paid, and hookr_build_launch takes one by its `builder-` id at its defaults. - [Paid checks over x402](https://hookr.fun/docs/mcp#paid-checks): Hookr's two ERC-8004 agents on Robinhood Chain sell one check each, Pool Check 0.02 USDG and Pool Watch 0.01 USDG on Robinhood Chain (`eip155:4663`), x402 version 2, paid to the agent's own wallet and settled by Priors' facilitator; the docs page gives each link. Hookr Pool Check, agent 20322: the pool's frozen Hook Blocks and their settings, arbitrage recapture and caps, and with a wallet, a side (buy or sell) and an amount together, whether that wallet can make the trade. Hookr Pool Watch, agent 20323: every pool, the open limit orders with their bounties and the revenue tokens with their income as they stand now, or one pool and its orders. Each link answers 402 with the price until a payment comes; a buyer on the x402 SDK must allow USDG on `eip155:4663` in `spendControls.allowedAssets`. - [Launchpad tokens](https://hookr.fun/launchpads): every token launched on Pons or pools.trade, with a link to its Hookr pool or a way to open one for a token that does not have one yet. - [What is live on Hookr](https://hookr.fun/updates): what is live right now: Hook Blocks, revenue tokens, King of the Pool, agents, pool discovery, hook analysis, the Hook Score and publishing a hook. - [Learn](https://hookr.fun/learn): six plain-language, source-aligned explainers. - [Developer docs](https://hookr.fun/docs): guides for swapping, providing liquidity and launching on Hookr, with the Hook Blocks and the contract addresses behind them. Every docs page is listed below. - [Hookr guide](https://hookr.fun/docs/guides/hookr-guide): every Hook Block on Hookr, what creators set, worked examples, and what is live now. - [What you can do with Hookr](https://hookr.fun/docs/overview/what-you-can-do): the six things this app lets you do, each backed by the route or the guide that does it. - [Data and safety methodology](https://hookr.fun/methodology): source hierarchy, coverage, freshness, and fail-closed display rules. - [Security](https://hookr.fun/security): official domain, account, chain and token identity, the active impersonation warning, and safe reporting steps. - [Status](https://hookr.fun/status): dated identity and account-control status; this is not automated uptime telemetry. - [$HOOKR utilities](https://hookr.fun/token), [Privacy](https://hookr.fun/privacy), and [Terms](https://hookr.fun/terms). ## Documentation index: pools (Hookr) - [Hookr pools](https://hookr.fun/docs/pools/overview): What a Hookr pool can carry, each piece in one line with the page that covers it. - [Core Hook Blocks in Hookr's hook](https://hookr.fun/docs/pools/core-blocks): The Hook Blocks built into Hookr's hook, what a creator sets on each and the ranges the contracts accept. - [King of the Pool: rules, rounds and the pot](https://hookr.fun/docs/pools/king-of-the-pool): The biggest buy of each round takes the pot arbitrage recapture fills, up to half of Hookr's share of LP Rewards and Auto Burn on that buy: who can take the crown, how a round closes and where the pot goes. - [Wallet Cap: one share of the supply per wallet](https://hookr.fun/docs/pools/wallet-cap): No wallet can buy more than a set share of the supply while the launch guard lasts: what a creator sets, what counts and what it runs beside. - [Outside Fill: part of a swap from an outside venue](https://hookr.fun/docs/pools/outside-fill): A pool fills part of a swap from an outside venue when the venue beats it, and keeps its own liquidity: what it does, what was measured and what it costs. - [Launch-day Hook Blocks](https://hookr.fun/docs/pools/launch-day-blocks): The Hook Blocks a pool can carry, each with what it does and what it costs a swap. - [Multi-pool launch: one token, several pools](https://hookr.fun/docs/pools/multi-pool-launch): One token in several pools at once, one per quote asset: what a creator sets, which quotes a pool can take and how the pools trade. - [Dev buy and its lock](https://hookr.fun/docs/pools/dev-buy): The creator's first buy inside the launch, its limits and the liquidity lock it starts with. - [Launch lock: hold a launch's liquidity](https://hookr.fun/docs/pools/launch-lock): Hold a launch's liquidity in its pools until a block you pick, or for good, while a beneficiary collects every fee it earns. - [Fees and the arbitrage recapture split](https://hookr.fun/docs/pools/fees): How Hookr is paid on a pool: its share of block fees, integrators, and how every arbitrage recapture splits. - [The Hookr minimum fee on a swap](https://hookr.fun/docs/pools/hookr-minimum): When a pool pays Hookr a minimum of each swap, how much it is, and what replaces it. - [Saved hooks: named sets of Hook Blocks](https://hookr.fun/docs/pools/saved-hooks): A named set of Hook Blocks kept on chain for Hookr's hook: what it holds, how pools follow it, and its versions. - [Owned roots: deploy your own Hookr hook](https://hookr.fun/docs/pools/owned-roots): Use Hookr's hook with a saved hook of your own, or deploy a Hookr hook at an address of your own. - [Referrals: ref codes](https://hookr.fun/docs/pools/referrals): Claim a ref code and share it. Wallets that link to it count for you for 12 months once rewards open. - [Programs: creator rewards for traders and LPs](https://hookr.fun/docs/pools/programs): Creator points, cash, milestone NFTs and Hookr Bux for trading or liquidity on Hookr pools: the modes, what a creator sets and how a day pays. - [hookr-sdk: build launches, quotes and swaps](https://hookr.fun/docs/pools/sdk): The hookr-sdk package: the builders for launch, swap and quote calls, the release manifest, and how hookr.fun uses it. - [Hookr pools in explorers and indexers](https://hookr.fun/docs/pools/indexers): Every event by contract, which one credits an account and in which field, the claim that pays it, and the views that answer what events do not. ## Revenue tokens A revenue token is a fixed-supply ERC-20 with a fee right locked behind it; its holders share the fee right's income, released over the token's release period and claimable whenever they like. The Hookr Multi-stream Revenue Tokenizer on Robinhood Chain makes them, with no owner, and takes any Rules Hookr's registry admits on Hookr's root. - [Tokenize](https://hookr.fun/tokenize): Turn a fee right your wallet holds, Uniswap v4 or v3 positions, a pools.trade fee NFT, a Pons or Long fee right, an ERC-8004 agent's income, or a new pool into a revenue token. - [Revenue tokens](https://hookr.fun/revenue): Every revenue token and its income over the last 7 days. - [Agents with a revenue token](https://hookr.fun/revenue/agents): Agents with a revenue token, by income over the last 7 days. - [Hookr Multi-stream Revenue Tokenizer](https://hookr.fun/hooks/revenue-tokenizer): The tokenizer's Hook Blocks page: what it does, its risks and how income reaches holders. - [Hookr Multi-stream Revenue Tokenizer](https://hookr.fun/docs/revenue-tokenizer/overview): Lock a fee right and mint a fixed-supply token whose holders share the fee right's income: the pieces and one tokenization in order. - [Ways in](https://hookr.fun/docs/revenue-tokenizer/what-you-can-tokenize): Hookr launches, Uniswap v4 and v3 positions, pools.trade fee NFTs, Pons and Long fee rights, alone or as several streams in one token. - [How hooks fit](https://hookr.fun/docs/revenue-tokenizer/how-hooks-make-it-work): Why a Uniswap v4 hook lets a pool's LP fees, arbitrage recapture, royalty and Hook Block take pay a token, and how fee rights off the hook plug in. - [Terms and endings](https://hookr.fun/docs/revenue-tokenizer/terms-and-endings): Forever or a term of at least seven days, what happens at the end, how each stream's end shows, and Hookr's leg. - [Holding a token](https://hookr.fun/docs/revenue-tokenizer/holding-a-revenue-token): Sync, the release period, claims, bonuses, drops, signed claims, where never to send the token, and the add-ons. - [Time shares and day wrappers](https://hookr.fun/docs/revenue-tokenizer/time-shares): Lock revenue tokens for days, hand out or sell each day's income as time shares, and wrap a day as an ERC-20 a pool can list. - [Compound](https://hookr.fun/docs/revenue-tokenizer/compound): Held for now: hookr.fun opens no compounder. How its vault works. - [Fee Bridge for a revenue token](https://hookr.fun/docs/revenue-tokenizer/fee-bridge): Up to 20% of each sync's ETH, set at mint, dripped to the in-range LPs of the token's own market. - [Tokenize a held fee right, step by step](https://hookr.fun/docs/revenue-tokenizer/tokenize-a-fee-right-you-hold): On /tokenize: the Your wallet tab, tick your positions or fee NFTs, press Tokenize, set the terms and sign. - [FAQ and risks](https://hookr.fun/docs/revenue-tokenizer/faq-and-risks): A pool that stops trading, a stream that ends, never sending revenue tokens to a helper contract, and the fixed supply. - [Build on revenue tokens](https://hookr.fun/docs/revenue-tokenizer/build-on-revenue-tokens): The calls a contract or an app makes on a revenue token: sync, claims, the asset books, the earning supply, drops and signed actions. - [How income accrues](https://hookr.fun/docs/revenue-tokenizer/build-income-accounting): Arrival and release over the release period, what a transfer settles, who earns, and drops by the block before. - [Doors for new platforms](https://hookr.fun/docs/revenue-tokenizer/build-a-door): The interface a door answers, the rules it keeps, and how the tokenizer admits it at the mint. - [Add-ons and read APIs](https://hookr.fun/docs/revenue-tokenizer/build-examples-and-apis): The compounder's calls, held for now, and the read-only JSON hookr.fun serves. - [Ideas to build](https://hookr.fun/docs/revenue-tokenizer/ideas-to-build): What is live on revenue tokens and what anyone can build next, settled on income the token actually received. - [Integrate revenue tokens](https://hookr.fun/docs/revenue-tokenizer/integrations): Where an integration starts: the tokenizer's record, the two block numbers Robinhood Chain counts, and reading hookr.fun's routes from another app. - [Revenue tokens in wallets and portfolio apps](https://hookr.fun/docs/revenue-tokenizer/integrate-wallets): What a wallet shows and calls: balances, income per asset, drops, claims, signed claims and x402 payments, and the token's mark. - [Revenue tokens in explorers and indexers](https://hookr.fun/docs/revenue-tokenizer/integrate-indexers): Every event by contract, how to trace income to the door it came through, the stream and door numbering, and drops by the block before. - [Revenue tokens in DEXs, lending markets and vaults](https://hookr.fun/docs/revenue-tokenizer/integrate-markets-and-vaults): Who earns while revenue tokens sit in a pool, a router, a lending market or a vault, and the market each token opens at mint. - [Revenue tokens for launch platforms and partner apps](https://hookr.fun/docs/revenue-tokenizer/integrate-launch-platforms): Which tokenizer call mints which revenue token, the terms an app sets, who the creator is, and Hookr's leg. - [Keepers and bots for revenue tokens](https://hookr.fun/docs/revenue-tokenizer/integrate-keepers): Syncing revenue tokens for the tip: the 1% cap and the 0.001 ETH floor, pools.trade's collectFees first, gas per door, and syncSome. - [Revenue token walkthrough setup](https://hookr.fun/docs/revenue-tokenizer/walkthrough-setup): The viem client, the contracts' clock and the ABIs every walkthrough imports, as the deployed contracts declare them. - [Walkthrough: tokenize a pools.trade fee NFT](https://hookr.fun/docs/revenue-tokenizer/walkthrough-fee-nft): From /tokenize or a script: approve the tokenizer, then tokenize the fee NFT with its terms and a market; rHOOKR's fee NFT went in through the several-streams call. - [Walkthrough: tokenize Uniswap v4 positions](https://hookr.fun/docs/revenue-tokenizer/walkthrough-v4-positions): From /tokenize or a script: preview the positions, approve them or sign a permit, then tokenize them with a term. - [Walkthrough: launch a token with a revenue token](https://hookr.fun/docs/revenue-tokenizer/walkthrough-launch): From the launch floor or a script: predict the revenue token's address, point every royalty at it, then launch and tokenize in one transaction. - [Walkthrough: several fee rights in one token](https://hookr.fun/docs/revenue-tokenizer/walkthrough-several-streams): A Pons fee right, a pools.trade fee NFT and v4 positions in one token: predict its address, open the Pons door, then tokenize the three streams. - [Walkthrough: read a revenue token from a script](https://hookr.fun/docs/revenue-tokenizer/walkthrough-read): A script that reads a revenue token's record, streams, terms, income books, doors and a wallet's claimable income, run on rHOOKR. - [Walkthrough: claim income from a script](https://hookr.fun/docs/revenue-tokenizer/walkthrough-claim): A script that claims every asset and every drop for a holder, and a claim the holder signs and anyone sends. - [Walkthrough: run a sync keeper](https://hookr.fun/docs/revenue-tokenizer/walkthrough-keeper): A script that has pools.trade pay the fee NFT doors, quotes each sync's tip with an eth_call and syncs when the tip beats the gas. - [Walkthrough: show a revenue token](https://hookr.fun/docs/revenue-tokenizer/walkthrough-show-a-token): Tell a revenue token apart, then show its balance, income, drops, streams and when they end, its page and its mark. - [Revenue token contracts](https://hookr.fun/docs/revenue-tokenizer/contracts): The revenue tokenizer's contracts on Robinhood Chain, with its leg collector, door factories, time shares factory and the core a market binds. - Facts: a revenue token has a fixed supply, minted once; each arrival of income is released to holders over the token's release period, at once or over up to 14 days (the app offers 1 to 14 days, default 1); a fee right is locked for at least 7 days or forever; Hookr's leg is 0% on the Hookr hook and 5% otherwise, taken from each stream's income at the sync; a token has no limit on its doors. ## Documentation index: concepts - [Hookr architecture: the contract map](https://hookr.fun/docs/concepts/architecture): See Hookr's contracts on Robinhood Chain in one map, with each one's role, address and connections. - [Stock Tokens in Hookr pools](https://hookr.fun/docs/concepts/rwa-and-erc20-quotes): Read what a Robinhood Stock Token brings into a Hookr pool before you pair one. ## Documentation index: guides - [Hookr guide: every Hook Block and its fees](https://hookr.fun/docs/guides/hookr-guide): Read the Hookr guide: one Uniswap v4 hook, the Hook Blocks you build it from, their fees, and a screenshot of each part. - [Swapping and quoting](https://hookr.fun/docs/guides/swapping-and-quoting): Read how to route a swap through the Universal Router or the Hookr router, the price limit, and getting a matching quote. - [Providing liquidity](https://hookr.fun/docs/guides/providing-liquidity): Read how to mint, add to, move, split and withdraw a position through the v4 PositionManager, the way the Hookr app sends each one. - [Matched liquidity](https://hookr.fun/docs/guides/matched-liquidity): Hookr matches a token 1:1 in HOOKR on pools its Safe approves, for a 21-day term with no early exit, and the provider keeps 60% at the end; half is HOOKR, so a price move can leave the provider with less than holding; matching is not open yet, since no pool is approved. - [Integrating as a launcher](https://hookr.fun/docs/guides/integrating-as-a-launcher): Open pools from your launchpad on a hook of your own: the launch call, who may open pools, accepting ownership, integrators and arbitrage recapture. ## Documentation index: integrations - [Router and quoter integration for interfaces](https://hookr.fun/docs/integrations/sdk): Read about the two trusted integrations an interface calls into, what each one needs from it, and the approvals behind them. - [Uniswap hooklist and routing for Hookr's hook](https://hookr.fun/docs/integrations/hooklist-and-routing): Read the hooklist entry for the root hook, the exact flag spellings, and how Uniswap routing allowlisting works. - [Building an interface like the Hookr app](https://hookr.fun/docs/integrations/app-integration): Read how hookr.fun itself reads the deployment record, which writes are actually wired up, and what another interface should copy. - [Hookr MCP server: pools, quotes and swap calls](https://hookr.fun/docs/mcp): Connect an agent to Hookr over MCP: the address, the tools, why a build tool never sends, and the read limits. - [Jobs for agents](https://hookr.fun/docs/integrations/agent-jobs): Read the jobs Hookr's contracts pay agents for: filling limit orders for their bounty, over MCP or by hand, and relaying signed swaps for a trader's fee. - [Income record](https://hookr.fun/docs/integrations/income): Read what hookr_income answers for a revenue token, a wallet or an ERC-8004 agent: what counts as income, what does not, and what unavailable means. - [Build a Hook Block](https://hookr.fun/docs/integrations/build-a-hook-block): Build a new Hook Block as an advisory: the interface, the template, the conformance tests, the submission and what you earn. - [Publishing and partner review](https://hookr.fun/docs/integrations/partner-review): Read the review paths for a hook, a pool or a launchpad integration, the evidence each asks for, and the Hookr routes a listing needs. - [Routing a pool with arbitrage recapture](https://hookr.fun/docs/integrations/routing-an-arb-recapture-pool): Read what a router, an aggregator or an indexer has to change for a pool that triggers an arbitrage recapture: gas, the route's effect on the split, and the events. ## Documentation index: reference - [Hookr contracts and addresses](https://hookr.fun/docs/reference/contracts-and-addresses): Hookr's contract addresses, the upstream Uniswap contracts, and HOOKR, USDG, NFLX and AAPL on chain 4663. - [Where Hookr's numbers come from](https://hookr.fun/docs/reference/where-the-numbers-come-from): Read which figures on hookr.fun are read from chain, how often each surface refreshes, and what an unavailable or partial figure means. ## Dynamic route admission - `/t/{address}` receives a canonical and indexable metadata only when a live, block-pinned sweep proves exactly one owning Hookr release. Invalid, unknown, ambiguous, and unavailable states are noindex and are absent from the sitemap. - `/u/{address}` receives a canonical and indexable profile entity only with public profile or launch/hook registry evidence. Arbitrary address-shaped probes are noindex. - `/project/{address}` is indexable only for source-listed project tokens. - `/analyze/report/{address}` titles as " hook report" once the read- only analysis completes; a failed or incomplete analysis renders the same unavailable state the interactive analyzer shows, noindex, rather than publishing a fabricated score. - `/pools/{poolId}` titles as "/ Uniswap v4 pool", the launched asset before the quote asset, with the pool id's first bytes; a PoolId that does not resolve to a live, readable pool is noindex. - Sitemap generation admits launch and creator URLs only from successful registry reads. RPC failure removes an unproven URL instead of publishing a guess. - A sitemap `lastmod` is the day the page's own content last changed. The app screens and the pages built from chain reads carry none. ## Data and citation policy - Contract state and settled logs outrank indexers and editorial copy for transaction decisions. - Hookr launch activity and 24-hour launch summaries are first-party indexed from settled trades. Pooled charts and volume use Hookr's pool index where it covers the pool, and otherwise live third-party market data, which is not part of that durable index. TVL on a Hookr pool is its own balances at current prices, or Not priced. Failed data renders unavailable, never an inferred zero. - Price, FDV, volume, and burn values are mutable observations, not timeless product facts. Cite their source, block or observation time and coverage when quoting them. - Pool volume and TVL remain specific to the named pool, source, and window. Do not combine Hookr-indexed history with external-provider observations as if they were one first-party series. - A wallet confirmation is not a receipt. Separate request preparation, simulation, signature, broadcast, receipt, canonical finality, and postcondition readback. - Structured data intentionally omits prices, ratings, offers, performance claims, and invented counts. It mirrors facts visible on the page where it appears. ## Machine-readable surfaces - `GET https://hookr.fun/api/protocol-stats`: unauthenticated, cached, read-only JSON with block-pinned protocol metrics, `poolBlocks` among them: today's Hook Blocks with how many listed pools run each. It returns HTTP 503 instead of fabricated values on read failure. - `GET https://hookr.fun/api/pool-apr?pools=`: estimated APR for up to 50 pools. - `GET https://hookr.fun/api/discover/pools`, with `/api/discover/snapshot` and `/api/discover/volumes`: the pool lists Discover reads. - `GET https://hookr.fun/api/hooks/catalog`: unauthenticated, cross-origin JSON of Hookr's Hook Blocks with their settings and bounds, Hookr's main contracts, and deep links into the builder. - `GET https://hookr.fun/api/hooks/integrations`: unauthenticated, cached, cross-origin JSON with public external-hook manifests and listing readiness. Private contact and consent stay outside Git. - `GET https://hookr.fun/api/integrations/tracks`: unauthenticated, cached JSON for the six public technical outcome tracks introduced by the partner integration standard. - `GET https://hookr.fun/api/integrations/manifest`: unauthenticated, cached, cross-origin JSON for hook analysis, manual-review submission, and partner intake. - JSON Schemas for integrators: [external hook manifest](https://hookr.fun/schemas/external-hook.v2.json) and [integration capabilities](https://hookr.fun/schemas/integration-capabilities.v2.json). - [hookr-sdk on npm](https://www.npmjs.com/package/hookr-sdk) (`npm install hookr-sdk viem`): Hookr's contract addresses and ABIs on Robinhood Chain, Monad and Arbitrum, King of the Pool's reads, and builders for launches on Hookr's core (arbitrage recapture on each pool unless its member names `RECAPTURE_OFF`), quotes and swaps; your wallet signs. See [the SDK page](https://hookr.fun/docs/pools/sdk). - [Sitemap](https://hookr.fun/sitemap.xml): canonical public routes, the documentation and Hook Block pages dated by the day their content last changed, and registry-admitted dynamic entities. - [Robots policy](https://hookr.fun/robots.txt): public search and user-directed agent fetches are allowed; private account, authentication, operator, and non-public API surfaces are excluded. - [Security policy](https://hookr.fun/.well-known/security.txt): canonical machine-readable contact, policy, expiry, and official identity. - [Docs as Markdown](https://hookr.fun/docs.md): every docs page but the HookrBook recipes at its own address plus `.md`, the page's text without its HTML. - [MCP server](https://hookr.fun/docs/mcp): `https://hookr.fun/api/mcp`, no key; discovery at `https://hookr.fun/.well-known/mcp.json`. Monad's is `https://hookr.fun/api/mcp?network=monad` and Arbitrum's `https://hookr.fun/api/mcp?network=arbitrum`, each with its own skill file (https://hookr.fun/agents/monad/SKILL.md, https://hookr.fun/agents/arbitrum/SKILL.md), and Elysium's `https://hookr.fun/api/mcp?network=elysium` with its own skill file (https://hookr.fun/agents/elysium/SKILL.md). - [Concise product index](https://hookr.fun/llms.txt): stable links and quotable facts. ## Citation guidance - Prefer the specific product page or explainer over this aggregate document. - Pair mutable values with the protocol-stats response provenance or the linked transaction. - Preserve status words such as live, held and unavailable. - Do not imply brokerage listing, pools.trade affiliation, independent audit, guaranteed outcome, or capabilities that the manifest hookr.fun ships does not expose. ## Previous releases - [Previous releases](https://hookr.fun/docs/previous-releases): what a builder of a pool or token on earlier contracts needs, on one page.