Developers
Docs
Production reference for integrating with Robinlaunch on Robinhood Chain — contracts, launch flows, and secured public read APIs. You do not need to stand up your own API.
On this page
Product
Overview
Robinlaunch is the fair-launch pad for Robinhood Chain. Three on-chain launch modes:
Bonding curve
Price rises with buys. Auto-graduates to Uniswap V3 at 2.5 ETH collected.
Direct Pool
Instant Uniswap V3 pool. Single-sided token LP (no seed ETH); open FDV ~3 ETH; LP locked at launch.
Boost
Same instant Uniswap V3 launch as Direct Pool. When market cap reaches 2 ETH, the Boost program buys over 5 minutes for a total of 0.5 ETH.
Start here
How to integrate
Path 1
Call the smart contracts
Connect a wallet to Robinhood Chain and use Factory / DirectFactory / BondingCurve / LpFeeCollector like any EVM dapp. Addresses and flows are below. You do not need our website or HTTP API for this.
Path 2
Use the light public HTTP APIs (optional)
A few CDN-friendly reads are public: catalog, IPFS proxy, metadata, and chain trending. Prefer on-chain + your own RPC for anything else — heavy robinlaunch.fun routes are reserved for the website.
Path 3
Product UX (users)
Creators and traders use the UI at robinlaunch.fun. For how bonding / Direct Pool / Boost / fees work for end users, see How it Works — not this page.
Network
Chain
| Name | Robinhood Chain |
| Chain ID | 4663 |
| Native asset | ETH |
| RPC | https://rpc.mainnet.chain.robinhood.com |
| Explorer | Blockscout |
The Robinlaunch UI always reads mainnet via APP_CHAIN_ID and /api/rpc(browser) — not the wallet's active chain alone.
On-chain
Contracts & flows
Launch contracts
Factory v11 (Bonding Curve)
0.0002 ETH create; 70/30 trade fees; LP → collector v2 (claim-as-ETH)
DirectFactory v8 (Direct Pool)
0.0002 ETH create; single-sided LP; optional buy; collector v2 claim-as-ETH
BoostFactory (Boost)
0.0002 ETH create; Uniswap V3; buy program when MC hits 2 ETH (0.5 ETH over 5 min)
LpFeeCollector
Holds LP NFTs; creator/protocol fees; claimCreatorFeesAsEth; liquidity never withdrawable
Uniswap / WETH
Key constants
| Constant | Value | Notes |
|---|---|---|
| APP_CHAIN_ID | 4663 | Robinhood Chain mainnet |
| createFee | 0.0002 ETH | Paid on createToken (bonding & direct) |
| GRADUATION_ETH | 2.5 ETH | Net ETH collected to graduate (v6+) |
| TOTAL_SUPPLY | 1,000,000,000 | Fixed ERC-20 supply |
| TOKENS_FOR_SALE | 800,000,000 | Sold on bonding curve |
| TOKENS_FOR_LP | 200,000,000 | Reserved for Uniswap V3 LP |
| Trade fee | 1% total | 0.3% protocol + 0.7% creator on curve trades |
| LP fees | 70/30 · 90/10 | Bonding / Direct creator↔protocol via LpFeeCollector after graduation / launch |
| Active launch targets | Factory 0x700D… / Direct 0xF3b3… | UI createToken always targets these |
Create (bonding)
Factory.createToken(name, symbol, metadataURI) payable — createFee + optional initial buy ETH. Deploys Token + BondingCurve; sale supply moves to the curve.
Trade (bonding)
BondingCurve.buy(minTokensOut) / sell(tokensIn, minEthOut). Virtual x·y=k; 1% fee split; may trigger graduation.
Graduate
When net ETH ≥ GRADUATION_ETH (or sale tokens exhausted): wrap to WETH, create Uniswap V3 pool (1% fee tier), mint full-range LP. NFT → LpFeeCollector.
Create (direct pool)
DirectFactory.createToken — payable createFee (+ optional buy ETH); single-sided token LP at ~3 ETH open FDV; surplus buys tokens for creator; LP locked via LpFeeCollector.
Fees
Protocol: Factory/DirectFactory.withdrawFees (owner). Creator curve fees: claim on-chain from the curve. Post-grad LP: LpFeeCollector.collectFees + claim (bonding 70/30, direct 90/10).
HTTP
Public APIs
Base URL https://robinlaunch.fun. Optional helpers for catalog / trades / charts. Pure on-chain integrations can skip these entirely.
curl -s "https://robinlaunch.fun/api/curves" | head
# → { "total": "…", "curves": [ … ] }| Route | Purpose |
|---|---|
| GET /api/curves | Aggregated token catalog (all launch eras indexed for the UI) |
| GET /api/ipfs/… | Same-origin IPFS gateway proxy (long CDN cache) |
| GET /api/token-meta | Fetch/parse token metadata URI (IPFS) |
| GET /api/external-trending | GeckoTerminal trending / new / movers / volume on Robinhood Chain |
Site-only (not for third-party apps): /api/rpc, /api/upload, PnL & wallet helpers, search, charts/OHLCV, pool helpers, Uniswap quote, swap-resolve, token-image, and similar. Use your own RPC + on-chain reads instead.
API security
Rate limiting
Every /api route is rate-limited per IP. A global middleware cap applies on top of per-route limits. Exceeding limits returns HTTP 429.
Same-site by default
Public APIs do not send Access-Control-Allow-Origin: *. Browser apps on other domains cannot call them via CORS. Prefer on-chain reads for third-party dapps.
App vs external limits
Traffic from robinlaunch.fun (or localhost) gets high rate limits. A few light read APIs stay open to third parties with a tiny budget. Heavy routes (RPC, PnL, search, charts, upload, quotes) are site-only.
RPC method denylist
POST /api/rpc is site-only. When used by the app it forwards eth_*/net_*/web3_* reads. eth_sendRawTransaction, signing, filters, subscribe, and debug_* are rejected. Third parties should use their own Robinhood RPC.
Upload hardening
Images are sniff-validated (PNG/JPEG/GIF/WEBP only), size-capped, and https:// is required for any social URL fields.
Trust
Protocol boundaries
- No LP rug path — locked liquidity cannot be withdrawn; only fee claims apply.
- Protocol fees only — owner withdraws accrued protocol fees, never user pool principal.
- Metadata — social links must be full
https://URLs; images are content-sniffed. - Secrets — never commit
.env, Pinata JWT, or deploy keys.
Product UX → How it Works · Roadmap → /roadmap