TokensParentsLiveDocsSearch

How PairHood works

A token's pair is a real memecoin, its parent. The token is priced in the parent, every buy buys the parent first, and every harvest burns some of it.

Parents

A parent is an existing token on Robinhood Chain with a real market: a native-ETH pool on Uniswap v4 (PONS, AI, NOTE), a WETH pool on Uniswap v3 (CASHCAT, WALLET, most Pons V1 tokens), or a pool quoted in USDG or a tokenized stock (MEME, musebook, SHROOM). PairHood lists each parent on-chain with its route: the one to three pools a trade crosses between ETH and the parent, wrapping ETH to WETH where a v3 or v2 pool needs it. Anyone can bring a new parent with a launch (the site finds the best route through its pools and the contract checks it), and the owner can list one directly. A parent can be closed to new launches, but tokens already under it keep trading and harvesting.

The parent is the quote asset. A token under PONS is priced in PONS, so its USD price is token in PONS × PONS in USD. When PONS rises 10%, every token under it rises 10% in USD without a single trade; when PONS falls, they fall. A token's own trades move it against PONS.

Tokens: one locked pool

A launch mints one billion tokens and opens one Uniswap v4 pool, TOKEN / PARENT, with the whole supply as a single-sided position owned by the PairHood contract. There is no function that can remove it. The opening price is currently 0.6 ETH for the whole supply (an owner-settable parameter, shown live on the launch page), converted to the parent at the moment of launch.

The token's address is mined so it is always currency1 and the parent currency0: one code path for every swap, and on every explorer the pair reads TICKER / PARENT.

The site's router buys with ETH inside one transaction: ETH → the parent along its route (up to three Uniswap v4, v3 or v2 pools), then parent → token in the token's pool. Selling is the reverse. Quotes come from the router itself, which runs the very swaps and reverts with the amounts, so what the box shows is what the trade does. Holders of the parent can also trade the token pool directly with the parent token. Anyone can trade the pool on Uniswap without the site.

Fees

Pool fee, per trade1%
→ the token's creator, paid in ETH70% of the fee (0.7% of the trade)
→ burned, in the parent token15% of the fee (0.15% of the trade)
→ the PairHood token, bought and burned15% of the fee (0.15% of the trade)
→ the site0
Launch fee0.0005 ETH (currently; shown live on the launch page)

A token launched without an opening buy has no trade, so its pool is not yet on DexScreener and its chart is flat. PairHood's own wallet then makes one small buy of 0.0005 ETH within the token's first minutes so the pool gets its first trade: a real trade like any other (its fee goes to the creator and the burns happen), never repeated and never sold. Fees sit in the pool until harvest(token, minOut, inParent) runs. Only the token's creator, the owner and the site's keeper can call it (the site runs it hourly with a slippage floor taken from a fresh simulation; a creator can always run it from the token page, with or without the site). If a parent's route ever dries up, the creator can harvest with inParent and receive the parent token itself (30% burned, 70% to the creator, no ETH leg). The harvest pokes the position, sells the token-side fees inside the token's own pool for the parent, sends 15% of the parent to 0x…dEaD, swaps the other 85% to ETH along the parent's route (in the router), pays 70/85 of it to the creator and spends 15/85 on the PairHood token along its own route, which it burns. Until the PairHood token is listed, that share is held in the contract as an ETH reserve that can only ever be spent on that purchase. If a payout cannot be delivered the ETH is parked in the contract for the creator to withdraw. Token fees that cannot sell yet wait for the next harvest; nothing is lost and nothing can be taken by PairHood.

What the owner can and cannot do

  • Can: list a parent with its route (a public listing may only use pools with static fees ≤ 10% or hooks the owner already vetted, supported tokens in the middle, and enough real liquidity: the ETH the route can take before the parent moves 10%), replace a parent's route only after a 24-hour public notice, extend the list of quote tokens public listings may route through, close or reopen a parent for new launches, list the PairHood token once (24-hour notice), spend the reserve on buying and burning it, name keeper addresses that may harvest, set the launch fee, set the opening market cap of future tokens, pause new launches, withdraw launch fees.
  • Cannot: touch any pool, any liquidity, any trade fee, any parked payout, or change the 1% fee and the 70 / 15 / 15 split. Those are constants in the contract.
  • The contracts are not upgradeable. Ownership is two-step, cannot be renounced, and is meant for a hardware wallet.

Contracts

  • PairHood parents, launches, the locked pool per token, harvest (70% creator / 15% parent burn / 15% PairHood token burn)0x8018…eFa1
  • HoodRouter the swap engine: ETH → the parent's route (Uniswap v4 / v3 / v2, up to three hops) → token, and back; exact quotes0x6FFf…f191
  • RouteLens read-only route math: pool existence, price, honest depth (ETH absorbed within ±10%), the listing rules0xa2b0…F556
  • HoodHook Uniswap v4 hook: 1% fee, PairHood-only liquidity0xb896…A880
  • CoinFactory mints tokens with addresses ordered above their parent0xF119…8eb9
  • Uniswap v4 PoolManager official Uniswap deployment — every token pool lives here0x8366…0951
  • Uniswap v3 Factory official Uniswap deployment — parent routes may cross its pools0x1f7d…2EfA
  • Uniswap v2 Factory official Uniswap deployment — parent routes may cross its pairs0x8bcE…937f

Public API

Read-only JSON, no key, rate-limited per IP, CORS open. Base URL https://pairhood.fun/api/v1.

  • GET /parents?sort=volume|total|tokens|burned|newest every listed parent with live numbers
  • GET /parents/{address} one parent, its tokens, recent trades and burns
  • GET /tokens?sort=trending|newest|biggest|oldest&parent=0x…&q=&limit=&offset= tokens
  • GET /tokens/{address} one token with trades, price points and harvests
  • GET /feed?limit= latest trades across all parents
  • GET /stats site totals

Risk

Tokens are memecoins. They have no rights, no backing and no relation to the teams behind their parents. Prices are set only by trading in locked pools, move with the parent, and can go to zero. Read the terms.

Contact

contact@pairhood.fun