Hoodbat, documented.
The v4-aware DEX aggregator for Robinhood Chain (4663): scan any token for its true liquidity, get an honest read on whether you can exit, and execute the best route β from one terminal.
WHAT HOODBAT IS
Hoodbat is three layers on one screen:
- A depth scanner. One
pingsweeps every DEX on Robinhood Chain β Uniswap v2/v3/v4, Pons, Bankr, Ramses, Clanker and ~40 more β and aggregates the token's true liquidity, including the v4 pools other scanners can't see. - An honesty layer. Exit math (how much you can actually sell before β5%), flow verdicts calibrated on live rug history, and cross-venue arbitrage spreads.
- An aggregator. Real on-chain quotes across every route, and one-click swaps signed by your wallet through the Uniswap v4 Universal Router.
WHY IT EXISTS
Robinhood Chain launches tens of thousands of tokens a day, and each one fragments across dozens of venues. The incumbent screeners are blind to Uniswap v4 on this chain β they under-report liquidity and mis-price exits for exactly the pools where much of the real market lives.
Live examples: UBIK shows $1.09M of liquidity on DexScreener while Hoodbat aggregates $3.06M across 40 pools β 64% of the book is invisible to the incumbents. Same for BONER: DexScreener shows $4.36M while the real book is $7.0M β 38% invisible. If you size an entry or an exit off the visible number, you are trading against people who can see the whole book.
THE DEPTH TERMINAL
The interface is a real terminal: type at the prompt, output streams into scrollback,
panels draw in place. Click anywhere to focus the prompt (desktop). β/β
walk command history; typing a symbol offers autocomplete from live chain search.
Commands
| COMMAND | WHAT IT DOES |
|---|---|
| ping <0xβ¦> | Scan a token address β depth, verdict, exits, arb, swap console. |
| ping <symbol> | Search by name/symbol and scan the top match. |
| swap | Jump to the execute console of the latest scan (market / limit / twap). |
| orders | Your open limit & TWAP orders β non-custodial watch-and-fire. |
| status | Backend + pool-index status (pools indexed, backfill state). |
| clear | Wipe the scrollback. |
| help | Command reference in-terminal (F1 works too). |
READING A SCAN
A scan renders five instruments:
- The reveal β true aggregated liquidity vs what the incumbents see, with the hidden share. The sonar scope's blips are the discovered pools (bright = v4).
- Depth map β liquidity by venue as bars; v4 strata are the ones only Hoodbat prices.
- Verdict stamp β one honest word about the flow/structure (glossary below).
- Exit solver β slippage math both routed and single-DEX (details below).
- Pool ledger β every pool with liquidity, volume, β5% exit budget, price. Plus an arbitrage line when venues disagree on price by >0.4%.
Verdict glossary
Verdicts are flow-first and calibrated against live outcomes on this chain (the same engine that vets a live alert stream):
| VERDICT | TRIGGER | READ IT AS |
|---|---|---|
| ORGANIC | balanced buys/sells + liquidity β₯40% of cap | Two-sided crowd with real exit depth β the survivor shape. |
| DEEP-BOOK | liquidity several Γ the cap | Unusual but real exit room (often post-run). |
| SCALP | thin book (<40% of cap) + still climbing | Momentum on a thin book β pumps and dumps hard; scale out fast. |
| LATE-SCALP | ran β₯120%/6h but 5-min momentum decayed to <ΒΌ of it | The run is spent; the late crowd is exit liquidity. High round-trip risk. |
| LOW-FLOAT | liquidity β the whole cap (75β250%) | Deep-looking book propping a tiny float β a lure, not safety. |
| MANUF-PUMP | buys >2Γ sells on a small cap | Manufactured demand β the rug signature. Avoid. |
| DEAD | aggregate liquidity < $2k | Drained or rugged. |
| MIXED | none of the above dominates | No strong signal either way β size accordingly. |
The exit solver
Constant-product pools reprice as you sell into them: on xy=k, extracting
QΒ·(1ββ(1βp)) of the quote side moves price down by p. The solver
inverts that to answer the only question that matters when it's time to leave:
how much can I sell before β5% (or β10%)? β once against the single deepest pool,
once routed across every venue. The difference is what aggregation is worth on that token.
SWAPPING
The execute console quotes and routes for real:
- Quotes are on-chain simulations. Every candidate route is priced by an
eth_callto the Uniswap v4 Quoter β it simulates the actual swap, so the number is what the chain would give, not an estimate off reserves. - Routing. Direct pools plus 2-hop paths through dynamic hubs (WETH, USDG, and the token's own quote assets β on this chain tokens are often quoted in exotic numeraires, including tokenised stocks). Best quoted output wins.
- Execution. The server builds the Universal-Router transaction with a
slippage-guarded
minOut(default 1.5%) and a 3-minute deadline; your wallet signs and sends. Connect prompts to add/switch to chain 4663. - Any-to-any. ETHβtoken and tokenβtoken, with exact-amount Permit2 approval chains for ERC-20 inputs (never infinite).
- Limit orders & TWAP (watch-and-fire). The server watches your order against live on-chain quotes β limit triggers are quoted on your full size (price-impact-aware), TWAP splits an order into timed slices. Non-custodial: every fill is signed by your wallet in an open tab; a keeper-executed version ships with the audited executor contract.
- Scope (beta). Routing is free (0% fee); the whole path is unaudited β dust first.
THE POOL INDEX
You can't aggregate what you can't enumerate. Hoodbat maintains a persistent local
index of every v4 pool on the chain, built from the PoolManager's
Initialize events β backfilled newest-first, then following the chain head
every few seconds. Pool definitions are immutable, so the index only grows; lookups are
instant and rate-limit-immune. Current size: ~700k pools. status shows
the live count.
$FANG
Hoodbat pings the chain β the truth is what comes back. $FANG launches as a fair launch on Pons, Robinhood Chain's native launchpad β no presale, no team allocation, no vesting theater. The design is deliberately minimal:
- Free routing. 0% aggregator fee at launch β only pool LP fees and gas. (A 0.1% fee is roadmapped, post-audit, always displayed β never silent.)
- The revenue is the Pons creator fee β a cut of $FANG's own trading volume, paid in ETH to the FeeVault. Trading $FANG funds the flywheel directly.
- One burn. 50% of everything the vault receives buys $FANG on-market and goes to the dead address β volume-linked, permanent. The other 50% is operator treasury (team holds zero $FANG).
- Utility without lockups. Pro features (exit alarms, arb feed, API) are hold-gated in the app by a simple balance threshold β no staking contract.
Full design: the $FANG site and TOKENOMICS.md in the repo.
SAFETY & BETA STATUS
- Non-custodial, always. Hoodbat never holds keys or funds; every transaction
is signed by your wallet, with explicit
minOutand deadline shown. - No silent fees. The routing-fee switch stays off until the audited fee contracts are live on mainnet.
- Beta means beta. The route encoders are verified against live chain-4663 calldata, but the stack is unaudited β test with dust first.
- Verdicts are reads, not guarantees. They're calibrated on live outcomes and they will still sometimes be wrong. Not financial advice.