Gas report

Every listed v4 hook's real gas per swap, measured on 100 live swaps and written onchain. Gas-light means under 30,000 on average.

Method

The keeper replays the last 100 swaps of a v4 Marketplace pool, the busiest pool running the hook, otherwise the busiest pool, through each hook's beforeSwap, called from the hook stack's address against live chain state. Each swap is its own eth_call, so every call starts cold as it does in a real swap. It records the average, the 95th percentile and the peak, and the swaps that failed. It runs once a day and whenever a hook is listed, and writes the results to the GasReports contract 0xd4FDFfFA0Aa24b0aE2e6401FC44Bf97c680072ce.

Reading it

The listed gas limit is a ceiling the hook stack enforces; the gas report is what the hook actually costs. gasOf(hookId) returns average, p95, peak, swaps, failed, time, report number, contract and pool; gasLight(hookId) is true under 30,000. The badge on every hook page, in Storefronts and on Gas report reads the contract.

First report

Report #1 on 2026-10-29: 11 hooks, 1,100 swaps replayed, 0 failed. 10 of 11 are gas-light. Cheapest: #7 Pool creator share at 3,183 gas per swap; the most: #4 Weekend gap guard at 31,930.

API, MCP, SDK

curl https://v4market.com/api/gas            # every hook, cheapest first
curl https://v4market.com/api/gas?hook=4     # one hook

const r = await v4market.gasReport(4);  // avg, p95, max, rank

The MCP tool is gas_report and the SDK method gasReport().