Connect your wallet
Use WalletConnect or an injected browser wallet, then switch to Robinhood Chain.
HOODFLOW DOCUMENTATION
Understand every step
before you sign.
Connect a self-custody wallet, inspect a protected quote and trade execution-enabled Stock Tokens on Robinhood Chain. Start with Direct Buy or Sell; automation remains a separate beta feature.
01 / START HERE
What you need
HoodFlow is a wallet-first interface. There is no HoodFlow account and HoodFlow never asks for a seed phrase or private key.
NETWORKRobinhood ChainChain ID 4663
PAY WITHUSDGUsed for supported buy routes
NETWORK GASETHKeep a small balance for fees
Never share recovery words.
Wallet connection only exposes your public address. Every permission and transaction must still be confirmed inside your wallet.
02 / DIRECT BUY
Buy a Stock Token with USDG
Choose an execution-enabled market
A green full-fill status means HoodFlow has a reviewed route for the complete input amount. Watch-only assets cannot be submitted.
Enter the USDG amount
HoodFlow checks your balance and requests a fresh route quote for that exact input.
Review the protection
Confirm the route, estimated output, minimum received, slippage setting and quote age before signing.
Approve and execute
The wallet signs a short-lived Permit2 permission, then the router transaction. The received token settles directly to your wallet.
03 / SELL
Sell a Stock Token back to USDG
Open an execution-enabled market, choose Sell to USDG, enter the token amount and request a fresh quote. The same output floor and expiry rules apply. Selling is unavailable when the route, oracle or token state fails a safety check.
IMPORTANT
The displayed oracle value is not a guaranteed exit price. The wallet confirmation uses the executable DEX quote and its protected minimum.
04 / PRICING
Reference price versus execution quote
Market context
Chainlink rounds provide the onchain reference shown on market pages. References may remain unchanged while the underlying market is closed.
What the router can fill
HoodFlow requests a fresh Uniswap V3 or V4 quote for your exact amount. This quote, not the chart price, determines estimated and minimum output.
05 / PERMISSIONS
What your wallet signs
HoodFlow uses Permit2 for an exact token amount with a short expiry. Always verify the token, spender, amount and deadline in the wallet. The interface does not need custody of your assets or access to your recovery phrase.
06 / STATUS GLOSSARY
Why a trade may be disabled
A reviewed route is configured and a fresh executable quote can be requested.
The canonical token is indexed, but no route has passed HoodFlow's complete-input checks.
The reference feed is paused, stale or invalid. Trading remains blocked until verification recovers.
The requested amount cannot currently receive a valid complete fill within the configured route policy.
07 / AGENT API
Structured preflight, human-controlled execution
HoodFlow exposes a public read-only market resource and a bounded preflight action for AI agents. A successful response verifies the configured DEX route, the current Chainlink reference, the token's oracle-pause state and maximum DEX-to-oracle deviation. It is indicative rather than execution-bound: HoodFlow requotes before the wallet signs.
Discover reviewed routes
GET /api/agents/markets returns the currently exposed route-reviewed Stock Token markets, addresses, settlement asset and execution policy.
Carry intent, then requote
POST /api/agents/quote accepts the asset, side, exact amount and slippage. The handoff preserves those inputs, then requests a fresh execution-bound quote for final wallet confirmation.
Virtuals ACP status
Open the live JSON manifest →The API surface is structured for provider onboarding, but HoodFlow is not claiming a live Virtuals ACP registry listing yet. Registry publication, commercial terms and any future scoped signer are separate release gates.
08 / MEME + CRYPTO
Discover tokens by contract address
The Token Terminal combines Virtuals' official Robinhood Chain launch feed, top-volume, trending and newest DEX pools, and HoodFlow's canonical RWA registry. Rank the indexed markets by volume, 24-hour change, liquidity or age. Provider-derived categories remain discovery metadata; interactive category filters are not live yet.
Paste any standard ERC-20 contract address on Robinhood Chain. HoodFlow reads bytecode and metadata, detects the token's lifecycle and quote asset, then probes Uniswap V2, V3 and hookless V4 liquidity only when a DEX route should exist. You can pay or receive USDG, VIRTUAL or WETH; when a direct pair is unavailable, an eligible V2 order can route through the market's native quote token in the same transaction.
Trade at the source
The token has not graduated. HoodFlow shows official Virtuals metadata and links to its source market instead of treating an empty pre-created DEX pair as executable.
Verify live liquidity
HoodFlow probes the active token and quote asset onchain. Embedded execution appears only after a fresh route returns non-zero output.
UNREVIEWED MODE
Contract discovery is not an endorsement or safety review. Trading is enabled only when a fresh executable route exists, but route availability does not rule out malicious transfer logic, issuer risk or liquidity withdrawal.
09 / REWARDS
How HF Points qualify
A wallet creates a shareable referral link with one message signature. The invited wallet receives 100 HF Points and its referrer receives 500 only after the invited wallet's first eligible Universal Router trade is confirmed on Robinhood Chain. Clicks, repeat trades and raw volume earn no points. Verified points are recorded now; the public Season 0 leaderboard remains Coming Soon until rankings open.
No guaranteed token allocation.
HF Points are planned to inform future $HFLOW eligibility, but have no present monetary value. Conversion rate, launch, eligibility, jurisdiction and anti-sybil terms remain subject to a future announcement.
10 / AUTOMATION BETA
DCA is separate from Direct Buy
The recurring engine is an advanced beta feature. Only prepare a schedule when the application reports that the deployed engine and keeper are live. A DCA defines its asset, amount, cadence, total budget, expiry and slippage boundary; keepers cannot execute outside those limits.
View recurring engine contract →11 / TROUBLESHOOTING
Common messages
Wallet is on the wrong network
Approve the network switch to Robinhood Chain. If your wallet does not add it automatically, use chain ID 4663 and the official network configuration.
Waiting for oracle
The reference feed is unavailable, stale or still being verified. Trading stays disabled rather than using an unverified value.
No live full-fill route
Liquidity for the selected asset or amount cannot pass the current route policy. Reduce the amount or try again later; never bypass the warning with a blind transaction.
Why does a Virtuals token open an external market?
The token is still on the Virtuals bonding curve. The official public SDK does not currently publish Robinhood Chain write constants, so HoodFlow fails closed instead of asking your wallet to trust an inferred upgradeable router.
Transaction reverted
The executable output may have moved below your protected minimum, the permission may have expired or the wallet balance may be insufficient. Request a new quote before retrying.
Chart history is unavailable
The historical oracle endpoint may not have enough valid rounds. This does not create an execution price; a fresh DEX quote is still required.
READY TO START?
Begin with a quote.
Signing comes later.
They may be restricted in your jurisdiction and do not provide shareholder rights.