Connect your wallet
Use WalletConnect or an injected browser wallet, then switch to Robinhood Chain.
POOLSBROKER 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
PoolsBroker is a wallet-first interface. There is no PoolsBroker account and PoolsBroker 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 PoolsBroker has a reviewed route for the complete input amount. Watch-only assets cannot be submitted.
Enter the USDG amount
PoolsBroker 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
PoolsBroker 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
PoolsBroker 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 PoolsBroker'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
Connect once, keep execution human-controlled
PoolsBroker exposes the same bounded capabilities through REST, OpenAPI 3.1.2 and a stateless Streamable HTTP MCP endpoint. A successful preflight verifies the configured DEX route, current Chainlink reference, oracle-pause state and maximum DEX-to-oracle deviation. It remains indicative: PoolsBroker requotes before every wallet signature.
Drop PoolsBroker into an agent
POST /api/mcp exposes market discovery, quote preflight and basket planning as tools. GET /openapi.json publishes the equivalent REST contract. Neither connector receives a signer, private key or transaction permission.
One budget, explicit legs
POST /api/agents/basket allocates one USDG budget across two to six unique markets and checks every leg. A basket is non-atomic: each accepted leg gets a fresh quote and a separate trade confirmation; token approval and Permit2 signing can add wallet prompts.
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.
BASKET FAILURE POLICY
all-or-nothing returns no plan if any leg cannot pass. Explicit omit-unsafe can keep the safe legs without redistributing rejected budget; the user must acknowledge the partial plan before opening an order.
Virtuals ACP status
Open the live JSON manifest →The API surface is structured for provider onboarding, but PoolsBroker 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 PoolsBroker'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. PoolsBroker 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. PoolsBroker shows official Virtuals metadata and links to its source market instead of treating an empty pre-created DEX pair as executable.
Verify live liquidity
PoolsBroker 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 PoolsBroker 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.