Integrations — Wallets, Terminals & Bots
For wallets, terminals, trading bots and scanners. Five steps, end to end.
1. Connect
Robinhood Chain, chain id 4663, RPC https://rpc.mainnet.chain.robinhood.com. Addresses: Deployed contract addresses.
2. Discover agents
Watch one event on the Orbofi factories:
event AgentCoinLaunched(
address indexed asset, address indexed creator,
address pool, address numeraire, uint256 initialSupply
);It carries the token, creator, numeraire and supply in a single log. See Index agent launches.
3. Resolve the pool
Take the V4 pool id from the PoolManager's Initialize event in the same transaction. Every Orbofi pool has the same key shape — fee 8388608, tickSpacing 200, hooks 0x4e3468…a544 — with only the currencies differing. See Liquidity layer.
4. Price it
sqrtPriceX96 from Initialize, kept current from each Swap, converted through the numeraire's Chainlink feed. Market cap is price × total supply. See Inspect an agent token.
5. Trade
Quote with quoteExactInputSingle, then execute through the Universal Router with Permit2. The fee is dynamic — always quote. See Trade agent tokens.
What to know before you start
No bonding curve. Tokens are in a Uniswap V4 pool from block one — no pre-DEX phase to model. (A gated migration path exists but has never fired; see the FAQ.)
The token is a plain ERC-20 with no transfer tax. All fees are pool-side.
The first 10 seconds are expensive by design. An 80% anti-snipe fee decays linearly to the standing rate. Quote, never hardcode.
The numeraire is not always WETH. Stock-paired agents (NVDA, AAPL) are common.
Verify your integration
Three commands that exercise the whole path. Run them against a public RPC before wiring anything up — if these work, your addresses and pool-key shape are right.
1. Discovery — are launches visible?
Each hit is one agent. topics[1] is the token, topics[2] the creator.
2. Quoting — is your pool key correct?
Buying an agent with 0.001 WETH:
Returns amountOut and a gas estimate. A revert here almost always means the pool key is wrong — most often a hardcoded fee (it must be 8388608, the dynamic sentinel) or currencies in the wrong order.
3. Pricing — does your maths agree with the pool?
Quote the same pool in both directions. The buy and sell prices should straddle the price you derive from sqrtPriceX96, with a round-trip gap of roughly 3–4% — that is the swap fee each way plus slippage. If your derived price sits outside that bracket, the usual cause is inverting tokenIsCurrency0.
A worked run of all three, on 2026-08-19: discovery returned 5 launches; the quote returned 463,453 agent tokens for 0.001 WETH; the reverse returned 2.07e-6 WETH for 1,000 tokens; and sqrtPriceX96 gave 2.267e-9 WETH/token against quoted 2.158e-9 buy and 2.072e-9 sell. Consistent in both directions.
Last updated
Was this helpful?