Skip to content

docs: Pools.trade API — Uniswap launchpad on Robinhood Chain - #233

Merged
buddies2705 merged 3 commits into
mainfrom
docs/pools-trade-api
Aug 6, 2026
Merged

docs: Pools.trade API — Uniswap launchpad on Robinhood Chain#233
buddies2705 merged 3 commits into
mainfrom
docs/pools-trade-api

Conversation

@buddies2705

Copy link
Copy Markdown
Contributor

Adds a dedicated API page for pools.trade, Uniswap's launchpad on Robinhood Chain (public 5 Aug 2026, ~20k launches/day), to the Robinhood section.

What's covered

  • Launch detection via both entry contracts (0x0000ffff…19c0 current, 0x00004c4c…d4e9 original — still active; filtering only one drops ~40% of 5 Aug launches) — queries, real-time subscriptions, and a rich mint-transfer stream for sniper/listings feeds
  • Full verified contract map: 2 entries, 4 launchpads (tickSpacing 25 = current path, 60 = original path — all four are pools.trade's own), token factory, CCA auction factory, initializer registry
  • Event reference: 2 decoded + 13 raw events with keccak-verified topic0s, incl. the entire Crowd Launch (continuous clearing auction) set and an AuctionCreated detection stream
  • Trading data (uniswap_v4 on Trading cube), OHLCV, top-tokens pattern, plus the measured ~2× trade-leg duplication caution (dedup reconciles to pools.trade's own numbers)
  • Realtime-only cubes for traders: DEXPoolEvents (live depth by v4 PoolId), DEXPoolSlippages, TransactionBalances
  • Holders (with the PoolManager-top-holder caveat), graduation mechanics, tRPC cross-check reference, FAQ

Site-wide fix: .theme-doc-markdown table { display: table } opts out of Docusaurus's scroll fallback, so hash-heavy tables bled under the TOC; table-cell code now gets overflow-wrap: anywhere.

All 19 GraphQL blocks verified against streaming.bitquery.io (19/19 returning live data). Related internal ticket: BIT-15168.

🤖 Generated with Claude Code

Gaurav agarwal added 3 commits August 6, 2026 11:39
pools.trade launched 5 Aug 2026 and is already minting ~7k tokens/day on
Robinhood Chain (chain ID 4663). Adds a dedicated page covering launches,
Crowd Launch (CCA) auctions, trades, OHLCV, and holders.

Key points documented, all verified against live Bitquery data:

- pools.trade has no bonding-curve contract. Each launch creates a real
  Uniswap v4 pool in the mint transaction (native ETH quote, fee 2500,
  tickSpacing 25, no hooks), so trades are queryable from block one and
  there is no graduation/migration event for curve launches.
- Contract map: entry 0x0000ffff…19c0, factory 0x000000e2…d49b,
  launchpad 0x23f82095…27f1, v4 PoolManager 0x8366a39c…0951.
- Only TokenCreated(address) is decoded; ten other events are raw and are
  documented with their topic0 so they stay queryable via SignatureHash.
  All ten signatures verified by keccak-256 preimage match.
- Caveats users need for correct results: Trading.Trades returns each leg
  ~2x on Robinhood v4 (measured 1.9x, deduped FRONG 24h volume reconciles
  to pools.trade's own $30.8M), the v4 PoolManager is the top "holder" of
  every token, SignatureHash filters are realtime-only, and there is no
  pools.trade protocol label so token-set joins are required.

Also adds the page to the Robinhood sidebar.
…s, table overflow

Corrections from adversarially re-auditing the page against live data:

- pools.trade has TWO entry contracts. The original 0x00004c4c…d4e9 has
  been live since 8 Jul (soft launch), minted FRONG and POOLS on 30 Jul,
  and still processes hundreds of launches/day. Every launch filter now
  uses in: with both addresses; 5 Aug total corrected 6,907 -> 11,437.
- Transaction.To is documented as unreliable for attribution (top tokens
  also launch via routers and contract-creation txs); the event pattern
  on LogHeader.Address is now the stated source of truth.
- Aggregations and Holders switched archive -> combined: measured fresher
  (5,265 vs 5,098 same-instant launch count; holder balances 11 min
  fresher). SignatureHash note extended: combined also unavailable.
- New "Pool liquidity, slippage, and balance changes" section covering
  DEXPoolEvents (v4 PoolId-keyed live depth), DEXPoolSlippages
  (SlippageBasisPoints per swap), TransactionBalances (pre/post balances,
  HasPreBalance caveat) — all verified live, all realtime-only.
- Token metadata section now leads with the Transfers.Currency lookup
  (name/symbol/decimals for any token in one query) before the raw
  factory event (description/image).
- Rich launch subscription added (full Transaction/TransactionStatus/
  Currency payload) for sniper/listings feeds.
- Cross-check section documenting pools.trade's own unauthenticated tRPC
  API (curve.*, cca.*, prices.*) with a not-a-data-source caution.
- UI: wide tables bled under the TOC because .theme-doc-markdown table
  { display: table } opts out of Docusaurus's scrolling fallback; cell
  code now gets overflow-wrap: anywhere so hash-heavy tables shrink to
  fit. Oversized event table restructured into a compact table + copyable
  topic0 reference block.

All 18 GraphQL blocks on the page verified against streaming.bitquery.io
(18/18 return live data; subscriptions schema-validated as queries).
… factory

Second adversarial audit pass, all findings verified against live data:

- ATTRIBUTION FIX: 0xce57498d… and 0x60d73b21… are NOT competitor
  launchpads — their tokens (GFXP, KIICHAN, STO) are listed live on
  pools.trade. All four TokenLaunched emitters are pools.trade's own:
  0x23f82095…/0xad44d55e… serve the current entry path (tickSpacing 25),
  0xce57498d…/0x60d73b21… the original path (tickSpacing 60 — FRONG's
  own pool is tickSpacing 60). The "distinguish by tickSpacing" tip is
  replaced: tickSpacing identifies the launch path, not the platform.
- Pool creation timing nuanced: usually same-tx as the mint, but
  original-path launches can create the pool in an immediate follow-up
  transaction (FRONG 30 Jul was single-tx; today's original-path
  launches are two-phase).
- New CCA infrastructure documented, all keccak-verified: auction
  factory 0x000000001f26a0… (AuctionCreated — with a new "detect new
  Crowd Launch auctions" subscription), initializer registry
  0x05d55239… (InitializerCreated), TokensReceived on auctions.
- CCA graduation target corrected: ≈$5,000-equivalent raise (was
  wrongly stated as ~5 ETH); oversubscription noted (UNIRUN ~16x).
- TokenLaunched query now filters all four launchpad emitters.
- Generality of prior claims re-verified: leg duplication reproduced on
  a second token (UNIPEG 1.93x), PoolManager is top holder on all three
  tokens checked, Holders count matches pools.trade within 0.13%
  (12,256 vs 12,240).

All 19 GraphQL blocks re-verified live (19/19).
@buddies2705
buddies2705 merged commit edbd16b into main Aug 6, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant