Docs

The terminal is the product.

Hoodini is a command-line client for AI-assisted trading on the Robinhood Chain. You talk to it in plain language; it researches live markets and prepares wallet-signable trades for you to approve. It never holds your keys.

01 / Quickstart

Run it in four lines.

# from the repo root
cd backend
npm install
cp .env.example .env  # add your OPENAI_API_KEY
npm run cli

Missing keys won't crash it — Hoodini tells you exactly what to configure and keeps running. Set HOODINI_WALLET in .env to connect an address.

02 / How it works

Ask, review, sign.

1
You ask
Type a request in plain language — a price check, a thesis, a trade.
2
Hoodini works
It streams its tool calls live — ⏺ get_price(NVDA) ⎿ … — pulling real data before it answers.
3
You sign
If a trade is involved, it prints a ⚑ Prepared for your signature block. Sign it in your wallet — or don't.

03 / What you can ask

Research, trade, earn.

Research

Ask about any ticker.

Pull live prices, your portfolio, market stats, and news-driven theses. Every number comes from a live source — Hoodini never invents a price or a balance.

What's NVDA trading at right now?
Show my portfolio and flag anything risky
Compare TSLA, AAPL, and NVDA on price and liquidity

Trade

Prepare a swap in plain language.

Buy or sell 200+ tokenized stocks and ETFs, 24/7, funded from USDG or WETH. Hoodini builds the approval and swap calldata and hands it back for you to sign.

Buy $500 of NVDA with USDG
Sell half of my TSLA position
Swap 0.5 WETH into AAPL

Earn

Put idle USDG to work.

Deposit USDG into the Morpho Earn vault for onchain yield (~7% APY), or pull it back out anytime. Borrowing against stock tokens isn't available yet.

Earn yield on 1,000 USDG
How much would I make on 5k USDG?
Withdraw 500 USDG from Earn

04 / Use cases

More than a trade.

US assets, from anywhere

Tokenized stocks and USDG live on-chain and trade around the clock. Reach US equities without a US brokerage — on your schedule, from your terminal.

Set a rule, walk away

Describe a trigger in plain language — buy the dip, compound your yield, rebalance at a threshold. Hoodini watches on-chain prices and prepares the trade the moment it hits.

Liquidity without selling

Borrow against the positions you already hold. Pull cash from your portfolio without closing it out — so you keep your exposure and your upside.

05 / Commands

Everything is a keystroke.

hoodini: Launch the terminal client and connect your wallet
/help: Show the shortcut list
/wallet 0x…: Set the connected wallet address
/reset: Clear the conversation history
/clear: Redraw the welcome screen
/exit: Quit Hoodini
← →: Move the cursor · shift+tab cycles mode

06 / Good to know

The guardrails.

You sign everything

Hoodini researches and prepares transactions — it never executes, settles, or holds your keys. You approve and sign every action in your own wallet.

Robinhood Chain

An Ethereum L2 (chainId 4663) built for tokenized US stocks, ETFs, and crypto rails. The native stablecoin is USDG, not USDC.

Built-in limits

A per-trade USD cap keeps position sizing in check. Ambiguous requests get a question back, not a guess.

Ready to run your first fleet?

Back to Hoodini