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.
On this page
A creator turns King of the Pool on at launch, and the pool keeps its settings for good. Each round the largest buys take the places on the podium, and the first place is credited its share of the pot arbitrage recapture fills.
What it needs
- Arbitrage recapture on the pool. King of the Pool runs inside it, so it opens when arbitrage recapture opens.
- LP Rewards or Auto Burn. The prize is bounded by Hookr's share of them on the winning buy, so a pool with neither pays no prize and its pot carries.
- Wallet Cap can run beside it, but a cap below the least buy leaves a round with no places until the launch guard ends.
Settings
| Setting | Range | Default |
|---|---|---|
| Round length | 1 hour to 30 days | 1 day |
| Pot share, of what the pool keeps from each arbitrage recapture | Above zero; the launch flow offers up to 50% | 25% |
| Podium | One winner; top two, paid 70% and 30%; or top three, paid 50%, 30% and 20% | One winner on hookr.fun |
| Pot released to LPs at each round's close | 25% to 100% | 50% |
| Least buy that counts, in the pool's quote | Any amount above zero | 0.01 ETH, 0.01 WETH, 25 USDG, 1,000 HOOKR, and 0.1% of the pool's quote depth on any other quote |
The pot takes its share of the rest of each arbitrage recapture, and the LPs what is left. The first place's prize is its share of the pot, and at most 50% of the Hookr fee its winning buy paid through LP Rewards and Auto Burn, after the pool's integrator's part, so a crown pays at most part of what the buy that won it cost. A place below the first is paid at most at the first place's rate per unit of quote bought. The same bound holds on a hook you deploy.
Who takes the crown
A buy of at least the least buy places its payer by its gross spend, the quote paid plus fees; a partial fill counts only what it spent. A payer holds one place, its largest buy. A buy must beat a place to pass it, so an equal later buy ranks below, and a bigger buy by a place's holder raises its own lead.
Only a wallet holds a place: an account held by a key, or one whose code is an EIP-7702 delegation to such a key. A buy a contract sends, such as an aggregator, a vault or a smart account that calls the router itself, places nothing and displaces nobody. At the close each place is checked again, and a holder that is no longer a wallet is paid nothing; its share carries.
| Buy through | Who holds the place and the prize |
|---|---|
| Hookr's router | The wallet that called it |
| A signed swap relayed through Hookr's forwarder | The signer |
| Uniswap's Universal Router at the address Hookr pins | The account the router names as its sender |
| A Multi-pool trade through the family router | The trader the router vouches for |
| Hookr's Limit orders book filling an order | Nobody, since the book is a contract. On a hook that admits the book as a gate, the order's owner |
A buy from any other router never leads, because the hook cannot tell who paid. Neither do the arbitrage recapture executor's own legs or the legs it trades through a launch's other pools.
In one transaction
- A buy in a transaction that already sold on the pool cannot lead.
- A buy whose path crosses liquidity added earlier in the same transaction cannot lead once that liquidity is more than 0.1% of the pool's active liquidity. Past 8 positions changed in one transaction, no later buy in it leads.
- A sell on the pool later in the same transaction, by anyone, voids every place taken earlier in it, and the podium goes back to what it was when the transaction began.
A king who sells in a later transaction keeps the crown. The King of the Pool page marks kings who sold or moved their tokens.
Closing a round
On the core, rounds run on the clock: a one-day round starts at 00:00 UTC and a one-hour round on the hour, and a pool joins the round in progress only when at least half of it remains. On the whole-pot core rounds count from the pool's own launch instead, so ETH/HOOKR's one-day round closes at 17:20 UTC.
There is no keeper. The first swap or arbitrage recapture after a round ends closes it, a limit order fill included, and anyone can close it with settleEpoch. A quiet pool's round can sit past its end until someone trades or closes it.
- At the close each taken place is credited its share of the pot, in the pool's quote, the first place's up to the bound above and the others' up to the first place's rate.
- A prize is credited, not paid: the king claims it with everything else it is owed in that quote, or as PoolManager claims with
claimAsClaimswhen the quote no longer transfers exact amounts. The pool's page shows a connected winner the rounds it won and a Claim beside the round. - Every closed round, won or not, then releases its share of what the pot still carries to LPs. A round with no king credits nothing and releases its share. A king crowned with an empty pot is crowned with a prize of 0.
- The swap that closes a round counts in the next one, so a closing buy can lead the new round.
- Rounds that ended without a trade close together. Only the first of them can have a podium. Each releases its share of the pot, and from 256 rounds closed at once, all of it goes.
The pot
Only arbitrage recapture pays into the pot. Of each arbitrage recapture's profit the executor keeps up to 25% and Hookr takes 15%; of the rest the pot takes the pool's pot share and the LPs what is left. That holds when the arbitrage recapture pays in the pool's quote. One paid in the other currency adds nothing to the pot and goes to LPs.
What a round's close releases goes to LPs: donated gradually to the liquidity in range, or, when none is in range, credited to the pool's liquidity owner. On a pool launched through Hookr that owner is the launcher, which holds the launch position: the launch's owner moves the credit with the launcher's claimRecapture, every withdraw or fee collection moves it too, and on a locked launch the beneficiary moves it with the lock's claimRecapture. LPs also earn the pool's base fee, and LP Rewards where the pool has them.
The core it runs on
King of the Pool is one of the eight Hook Block keys on Hookr's core, the HookrRules admitted on Hookr's root (both addresses are on Contracts and addresses). A pool that turns it on binds that core, where LP Rewards, Auto Burn, Wallet Cap, Exit Clock, Storm Fee, Swap Cut and Buy/Sell Block run beside it. A pool that follows a saved hook, or opens on a hook you deploy, runs King of the Pool on that hook's own core under the same bound.
King of the Pool runs on ETH/HOOKR, where the king takes the whole pot, with one-day rounds and a least buy of 0.01 ETH. Its rounds, and the past rounds of WTH/HOOKR before it, are on the King of the Pool page.
Referral rebates
A referral campaign hands back part of the Hookr fee a trader paid, so on a King of the Pool pool every campaign together pays a trader at most 50% of the Hookr fee on a buy, instead of 99.99%. Campaigns on the creator royalty keep the usual cap.
The cap limits what a rebate adds to a crown. It does not stop a creator who owns all of a pool's liquidity from outbidding an honest king by the least amount and denying that king's prize. The cap also cannot see a second referral contract or cash from Programs.
When arbitrage recapture is paused
If arbitrage recapture stops, the pot stops growing. Rounds still close and pay from what the pot holds. Nothing stops claims, exits or closing a round.