balloon.club · integration guide
Build on Balloon
Balloon is a token launchpad on Robinhood Chain (chain id 4663). Every token launches directly into an official Uniswap v3 pool — visible on DEX Screener and tradable anywhere from block one. This page tells you how to detect our tokens, verify they are really ours, and index their trades.
1 · Detecting Balloon tokens
Every Balloon token address starts with 0xBA11 (CREATE2 with a mined salt) — a quick visual/heuristic filter. Address prefixes are forgeable by anyone, so treat this as a hint, never as proof.
The authoritative feed is the factory's creation event:
// subscribe to the factory address: 0xDa307CC6459B76E8f9D3F319d5aA10f7f3F21Cb8 topic0: 0xfe210c99153843bc67efa2e9a61ec1d63c505e379b9dcf05a9520e84e36e6063 // TokenCreated topic1: token address · topic2: creator address
2 · Verifying provenance (unforgeable)
The factory records every token it deploys in its own storage. One view call settles whether a token is ours — a fake with a 0xBA11 address will always return false:
// TokenFactory function isBalloonToken(address token) external view returns (bool); function getTokenMetadata(address token) external view returns (string name, string symbol, string metadataUri, address creator, uint256 createdAt); // chain-level double check (no trust in us needed): the CONTRACT CREATOR of // every Balloon token is the factory itself — visible on any explorer.
3 · Indexing trades
Pools are standard Uniswap v3(official deployment, 1% fee tier). A trade is a Balloon trade iff the pool's token passes the check above. The launch event hands you the pool directly:
// DirectLauncher 0xAb2BB81B0f967e255146565B142607E4550F8f8f topic0: 0x028fab202e5ebc70b794da237b6b10ad0de2ebceca3c12c9e23ad4410f37c0fc // TokenLaunchedDirect data: pool address, LP tokenId, pre-buy ETH // then index standard v3 Swap events on that pool. Liquidity is permanently // locked: the LP NFT is owned by V3FeeLocker 0xd09F42E65e350754eEeD44C6be1d44ADF3252949.
4 · Contract addresses (Robinhood Chain mainnet)
| Contract | Address | Role |
|---|---|---|
| TokenFactory (UUPS proxy) | 0xDa307CC6459B76E8f9D3F319d5aA10f7f3F21Cb8 | Deploys every Balloon token; on-chain registry |
| DirectLauncher | 0xAb2BB81B0f967e255146565B142607E4550F8f8f | Seeds the Uniswap v3 pool at launch |
| V3FeeLocker | 0xd09F42E65e350754eEeD44C6be1d44ADF3252949 | Holds every LP position forever (rug-proof) |
| Uniswap V3 Factory (official) | 0x1f7d7550B1b028f7571E69A784071F0205FD2EfA | Pools live here, fee tier 1% (10000) |
| Uniswap SwapRouter02 (official) | 0xCaf681a66D020601342297493863E78C959E5cb2 | Router used for trading |
| Uniswap QuoterV2 (official) | 0x33e885eD0EC9bF04ecFB19341582AadCB4C8a9E7 | Quotes |
| WETH9 | 0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73 | Wrapped native ETH |
RPC: https://rpc.mainnet.chain.robinhood.com · Explorer: robinhoodchain.blockscout.com
5 · Event reference
TokenCreated(address indexed token, address indexed creator, string name, string symbol, string metadataUri)
topic0: 0xfe210c99153843bc67efa2e9a61ec1d63c505e379b9dcf05a9520e84e36e6063
TokenFactory — fires on every creation
TokenLaunchedDirect(address indexed token, address indexed creator, address pool, uint256 tokenId, uint256 preBuyEth)
topic0: 0x028fab202e5ebc70b794da237b6b10ad0de2ebceca3c12c9e23ad4410f37c0fc
DirectLauncher — token + its v3 pool in one log
FeesClaimed(address indexed token, address indexed caller, uint256 ethTotal, uint256 creatorEth, uint256 treasuryEth, uint256 tokensSold)
topic0: 0x516597a6ca6c77527dc77b92cb675eb2502848c60254074f6a93340f3af7b739
V3FeeLocker — creator/protocol fee claims
6 · REST + WebSocket API
Indexed data is also available over HTTPS — handy for prototyping before you run your own indexer. Base URL: https://balloon.club/bridge-api-mainnet
GET /tokens?limit=48 board: newest tokens + protocol constants GET /tokens/:address/market token, pool (venue/router/fee) and recent trades GET /tokens/:address/candles?res=1S OHLCV candles GET /tokens/:address/quote?side=buy&amount=<wei> WS /board-ws every token event (created / trade / graduated)
Questions or higher-volume access: info@print.world.