Bandit · Robinhood Chain 4663
Developer & Integration Docs
Everything an indexer, aggregator or trading terminal needs to list Bandit tokens — contracts, lifecycle events, graduation and the public API.
01What Bandit is
A fair-launch meme-coin launchpad native to Robinhood Chain. Coins are created on a bonding curve priced in WETH; once the curve raises its target the coin graduates — liquidity migrates into a canonical Uniswap V3 pool and the LP position is locked permanently.
Lifecycle
Launch → curve → graduation → Uniswap V3
Total supply
1,000,000,000 per coin, fixed
Graduation venue
Canonical Uniswap V3, 1% fee tier
LP policy
Locked forever — no claim path
02Network
| Field | Value |
|---|---|
| Chain | Robinhood Chain — chainId 4663 (Arbitrum Orbit L2) |
| Native asset | ETH |
| RPC | https://rpc.mainnet.chain.robinhood.com |
| Explorer | robinhoodchain.blockscout.com |
| WETH (quote asset) | 0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73 |
03Contracts
All deployed on Robinhood Chain mainnet and verified on Blockscout with full source.
| Contract | Address | Role |
|---|---|---|
| Bonding | 0x663394Df5BA6E0b31025BcaD6275B9c96D47EC6D | Launchpad core. Emits TokenLaunched + Graduated. Index this for new launches. |
| FRouter | 0x84b945242f64B3601D6A962200e4a631c173CB88 | Curve router. Emits Buy / Sell. Index this for pre-graduation trades. |
| UniswapV3Graduation | 0xDD0A02dd618a6c280dc6a26322A7c1c1264FbF6E | Graduation handler. Emits GraduatedToUniswapV3 with the pool address. Holds the locked LP NFT. |
| FFactory | 0xCE624C9A5D236919fdDB61429dBb621fA6B097E8 | Creates the internal curve pair for each coin. |
| AgentToken (impl) | 0xee8D7AAb373FEc95FD99a73023EA7EE033BEa853 | ERC-20 template every launched coin is cloned from. |
Graduation target — canonical Uniswap V3
| Field | Address / value |
|---|---|
| V3 Factory | 0x1f7d7550B1b028f7571E69A784071F0205FD2EfA |
| NonfungiblePositionManager | 0x73991a25c818bf1f1128deaab1492d45638de0d3 |
| Fee tier | 10000 (1%) · tickSpacing 200 |
| Pair | <token> / WETH, full-range |
Graduated coins are ordinary Uniswap V3 pools. If you already index canonical Uniswap V3 on Robinhood Chain, Bandit's graduated tokens need no special handling — they appear automatically.
04Lifecycle events
The four events that describe a coin's entire life. Signatures are exact — copy them straight into your indexer.
1 · Launch — Bonding
event TokenLaunched(
address indexed token, // the new ERC-20
address indexed creator,
address indexed pair, // internal curve pair
string name,
string ticker,
uint256 supply, // 1e9 * 1e18
uint256 initialPrice,
uint256 marketCap,
uint256 liquidity,
uint256 purchaseAmount, // creator dev-buy, in WETH
uint256 tokenIndex,
uint8 thresholdType, // 0 = 2 ETH, 1 = 4 ETH, 2 = 8 ETH raise
uint256 timestamp
);2 · Trade on the curve — FRouter
event Buy(
address indexed token, address indexed buyer, address indexed pair,
uint256 amountIn, // WETH in
uint256 amountOut, // tokens out
uint256 txFee, uint256 tokenPrice, uint256 timestamp
);
event Sell(
address indexed token, address indexed seller, address indexed pair,
uint256 amountIn, // tokens in
uint256 amountOut, // WETH out
uint256 txFee, uint256 tokenPrice, uint256 timestamp
);3 · Graduation — Bonding
event Graduated(
address indexed tokenMeme, address baseToken,
uint256 tokenBalance, uint256 assetBalance,
uint256 tradingFee, uint256 serviceFee,
uint256 creatorFee, uint256 treasuryFee, uint256 referrerFee,
uint256 timestamp
);4 · Pool created — UniswapV3Graduation
event GraduatedToUniswapV3(
address indexed token,
address indexed asset, // WETH
address pool, // <- the canonical Uniswap V3 pool
uint256 tokenId, // LP position NFT (locked in this contract)
uint128 liquidity,
uint160 sqrtPriceX96
);Tip: GraduatedToUniswapV3.pool is the cleanest way to link a Bandit coin to its Uniswap V3 pool — no need to recompute the pool address.
05Curve parameters
| thresholdType | Strategy | Raise target | Behaviour |
|---|---|---|---|
| 0 | Quick Shot | 2 ETH | Shallow curve, fast graduation |
| 1 | Power Play | 4 ETH | Balanced curve |
| 2 | Moon Mission | 8 ETH | Deepest curve |
A coin graduates when its curve token reserve falls to the graduation threshold (125,000,000 tokens remaining). The creator's dev-buy is capped at ~10% of the strategy's raise target.
06REST API
Public, unauthenticated reads. Base URL: https://bandit-backend-djm7.onrender.com
| Endpoint | Returns |
|---|---|
| GET https://bandit.fun/token-list.json | Standard Uniswap-format token list of all Bandit coins on chain 4663. CORS-open — the drop-in feed for aggregators/terminals. |
| GET /agent/all?status=all&page=1&limit=100 | All coins, paginated. The primary listing feed. |
| GET /agent/detail/:id | One coin, full detail. |
| GET /agent/top-holders | Holder distribution. |
| GET /agent/traders | Trader leaderboard. |
| GET /bonding-curve/analytics/token/:address | Curve analytics (price, mcap, raised). |
| GET /bonding-curve/dex-analytics/token/:address | Post-graduation DEX analytics. |
| GET /bonding-curve/token/transaction | Trade history. |
| GET /token/get-market-cap/:symbol | Market cap by symbol. |
| GET /token/:symbol/latest-price | Latest price by symbol. |
Response shape
Read this before you parse. Coin fields are nested under token, not at the top level of each item. contractToken at the top level is always null — a common integration mistake.
GET /agent/all?status=all&page=1&limit=100
{
"statusCode": 200,
"data": {
"total": 42, "page": 1, "limit": 100, "totalPages": 1,
"data": [
{
"id": "…", "name": "Trash Panda", "agentType": "MEME COIN",
"token": { // <- coin data lives here
"symbol": "PANDA",
"contractToken": "0x…", // the ERC-20 address
"chainId": 4663,
"marketCap": "…", "volume": "…", "totalRaised": "…",
"latestPrice": "…", "graduatedAt": null,
"threshold": "2", "totalSupply": "1000000000"
}
}
]
}
}07ABIs
Every contract is verified — pull the ABI straight from Blockscout, no repo access needed.
# Bonding ABI
curl "https://robinhoodchain.blockscout.com/api?module=contract\
&action=getabi&address=0x663394Df5BA6E0b31025BcaD6275B9c96D47EC6D"
# FRouter ABI (Buy / Sell)
curl "https://robinhoodchain.blockscout.com/api?module=contract\
&action=getabi&address=0x84b945242f64B3601D6A962200e4a631c173CB88"
# UniswapV3Graduation ABI
curl "https://robinhoodchain.blockscout.com/api?module=contract\
&action=getabi&address=0xDD0A02dd618a6c280dc6a26322A7c1c1264FbF6E"08Integration quickstart
The minimum to surface Bandit coins end-to-end.
- 1New launches — subscribe to
TokenLaunchedonBonding. Gives you the token address, creator, name, ticker and raise tier at block zero of the coin's life. - 2Pre-graduation trades & price — subscribe to
Buy/SellonFRouter.tokenPriceand the in/out amounts give you a live curve chart. - 3Curve progress — a coin graduates as its reserve approaches 125,000,000 tokens; the raise target comes from
thresholdType(2 / 4 / 8 ETH). This drives a “bonding %” or “final stretch” surface. - 4Graduation — on
GraduatedToUniswapV3, readpooland hand the token to your existing canonical Uniswap V3 indexing. Nothing bespoke needed. - 5Metadata — logos, socials and descriptions come from
GET /agent/all(see the nesting note above).
09Integrator recipes
The shortest path to listing Bandit for each kind of app. They all reduce to one rule: index the curve before graduation, then hand off to canonical Uniswap V3 after.
Trading terminals
GMGN · Sigma · MevX · Axiom · Fomo · Based
New coins from token-list.json or TokenLaunched. Live pre-graduation price and volume from Buy/Sell on FRouter (or /bonding-curve/analytics/token/:address). After graduation the coin is a canonical Uniswap V3 pool — GraduatedToUniswapV3.pool — so route it through your existing Uniswap V3 support.
AMM aggregators & routers
1inch-style routing
Only graduated coins have AMM liquidity — filter graduatedAt != null or listen for GraduatedToUniswapV3. Pools are standard Uniswap V3, 1% fee tier, token/WETH full-range. No custom pool math.
Lending & money markets
collateral listing
Gate on graduation status and liquidity health (/bonding-curve/dex-analytics/token/:address). LP is locked forever, so there is no LP-pull rug vector — but these are meme assets; treat them as high-risk collateral with a large LTV haircut.
Launchpad & data indexers
DexScreener · DefiLlama · subgraphs
Index Bonding for launches and graduations, FRouter for curve trades. token-list.json is the canonical roster; curve state comes from the analytics endpoints; graduation emits the Uniswap V3 pool address directly.
10Branding assets
List Bandit with the right name, mark and color.
Name & ticker
Product name Bandit; domain bandit.fun. Refer to coins as $TICKER.
Accent color
#ccff00