Robinhood Chain · chain 4663 · npm i -g hood-cli
Type a command.
Get a real answer.
hood-cli is the command-line toolkit for Robinhood Chain: Stock Token prices, portfolios,
launchpad feeds, swaps, transfers, transaction decoding. This page isn't a description of a
terminal — it is one. Every reply below is either a real mainnet session captured on
, or the CLI's own real
--help text. Nothing on this page is invented.
hood-cli interactive docs — real mainnet output only, nothing invented.
Try: price AAPL · stocks --sort premium --dex --limit 6 · launches --lookback 2000000 --limit 5 --names
portfolio 0x9701fb0aDe1E269c8f64Ec0C7b3cfADB31A13A52 · swap --sell USDG --buy WETH --amount 250
tx 0x870a3bee3070f10e3c4f34271cfde70fd5aa0dc2eade6f07d01ae6c9a00285bd
Any other command name shows its real --help. Type help for the full list.
Press Tab, or tap a suggestion above, to autocomplete a command — there's no
navigation bar to click through, discovering what hood can do is
typing into it, same as the real CLI. ↑/↓ replay your own history.
JavaScript off? The same real data is below as static HTML: jump to the reference.
Install
Node ≥ 20. Reads work with zero setup — no wallet, no API key. Writes need a wallet and always stop for confirmation.
# install globally — ships two equivalent binaries: hood and hoodc
npm install -g hood-cli
# or run without installing
npx hood-cli price AAPL
# instant read — no config, no wallet
hood price AAPL
# set up a wallet (encrypted keystore, password-protected)
hood config set wallet
# quote a swap (default: dry run, nothing is sent)
hood swap --sell USDG --buy WETH --amount 100
# sign and send — always confirms first
hood swap --sell USDG --buy WETH --amount 100 --execute
# one-command setup wizard: wallet + LLM trading key + Telegram/X alerts
hood init
Full command reference
Every block below is the real, unedited output of hood <command> --help,
generated on straight from the
CLI's own commander definitions. This is static HTML — it is fully present with JavaScript
disabled. The terminal above is enhancement on top of it, never a replacement.
- hood
- hood price
- hood stocks
- hood coins
- hood launches
- hood portfolio
- hood tx
- hood token
- hood watch
- hood swap
- hood transfer
- hood faucet
- hood deploy-token
- hood config
- hood init
hood
top-level usage & global flags
Usage: hood [options] [command]
The command-line toolkit for Robinhood Chain (4663) — instant reads, guarded
writes.
Options:
-v, --version output the version number
--json machine-readable JSON output
--network <net> mainnet | testnet (default: "mainnet")
--rpc <url> override the RPC endpoint
--verbose show raw error causes
--yes skip interactive confirmation on writes (still
requires --execute)
--acknowledge-eligibility affirm Stock Token acquisition eligibility
(non-US/CA/UK/CH)
--no-color disable ANSI colour
-h, --help display help for command
Commands:
price [options] <symbol> Chainlink oracle price + DEX price + premium
for a Stock Token
stocks [options] The full Stock Token board with live Chainlink
prices
coins [options] Memecoin screener — newest or trending
launches
launches [options] Recent memecoin launches from NOXA and The
Odyssey
portfolio [options] <address> Multiplier-correct Stock Token positions + USD
totals for an address
tx <hash> Decode a transaction: status, transfers, gas,
method
token <address> Inspect a token: metadata, supply, multiplier,
price
watch [options] <addrOrToken> Live activity stream for an address or a token
(ERC-20 transfers + native ETH)
swap [options] Quote (default) or execute a Uniswap v3 swap
between two tokens
transfer [options] Send ETH or an ERC-20 token to an address
faucet Print testnet faucet instructions + current
testnet balances
deploy-token [options] Deploy a fixed-supply ERC-20 from a JSON
config (direct-rail, no launchpad)
config Manage hood-cli settings (rpc, wallet,
network)
init [options] interactive setup wizard: wallet, LLM key
(hood-traders), and Telegram/X (hood-alerts)
help [command] display help for command
hood price
Chainlink oracle price + DEX price + premium for a Stock Token
Usage: hood price [options] <symbol> Chainlink oracle price + DEX price + premium for a Stock Token Arguments: symbol ticker (AAPL) or token address Options: --watch live-updating view (repaints in place) (default: false) --interval <ms> refresh interval for --watch (default: "4000") --max-age <seconds> max acceptable Chainlink answer age --no-dex skip the Uniswap price probe (oracle only) -h, --help display help for command
hood stocks
The full Stock Token board with live Chainlink prices
Usage: hood stocks [options]
The full Stock Token board with live Chainlink prices
Options:
--sort <key> sort by symbol | price | premium (premium implies --dex)
(default: "symbol")
--dex also probe Uniswap for DEX price + premium (slower) (default:
false)
--priced only tokens with a live Chainlink feed (default: false)
--limit <n> show at most n rows
-h, --help display help for command
hood coins
Memecoin screener — newest or trending launches
Usage: hood coins [options] Memecoin screener — newest or trending launches Options: --new newest launches (default) (default: false) --trending rank by bonding-curve trade activity (default: false) --lookback <blocks> blocks to scan (default: "50000") --limit <n> rows to show (default: "20") --names resolve token symbols on-chain (default: false) -h, --help display help for command
hood launches
Recent memecoin launches from NOXA and The Odyssey
Usage: hood launches [options] Recent memecoin launches from NOXA and The Odyssey Options: --follow stream new launches live (default: false) --launchpad <name> noxa | odyssey (default: both) --lookback <blocks> blocks to scan for the snapshot (default: "30000") --limit <n> max rows in the snapshot (default: "25") --names resolve each token symbol on-chain (default: false) -h, --help display help for command
hood portfolio
Multiplier-correct Stock Token positions + USD totals for an address
Usage: hood portfolio [options] <address> Multiplier-correct Stock Token positions + USD totals for an address Arguments: address wallet address to inspect Options: --max-age <seconds> max acceptable Chainlink answer age -h, --help display help for command
hood tx
Decode a transaction: status, transfers, gas, method
Usage: hood tx [options] <hash> Decode a transaction: status, transfers, gas, method Arguments: hash transaction hash Options: -h, --help display help for command
hood token
Inspect a token: metadata, supply, multiplier, price
Usage: hood token [options] <address> Inspect a token: metadata, supply, multiplier, price Arguments: address token address or ticker Options: -h, --help display help for command
hood watch
Live activity stream for an address or a token (ERC-20 transfers + native ETH)
Usage: hood watch [options] <addrOrToken>
Live activity stream for an address or a token (ERC-20 transfers + native ETH)
Arguments:
addrOrToken wallet address, token address, or ticker to watch
Options:
--token treat the argument as a token (stream ALL transfers of it)
(default: false)
-h, --help display help for command
hood swap
Quote (default) or execute a Uniswap v3 swap between two tokens
Usage: hood swap [options] Quote (default) or execute a Uniswap v3 swap between two tokens Options: --sell <token> ticker or address to sell (e.g. USDG) --buy <token> ticker or address to buy --amount <amount> amount of --sell to spend, in whole tokens --slippage <bps> slippage tolerance in basis points (default: "50") --execute sign and send (default: quote only) (default: false) -h, --help display help for command
hood transfer
Send ETH or an ERC-20 token to an address
Usage: hood transfer [options] Send ETH or an ERC-20 token to an address Options: --to <address> recipient address --amount <amount> amount to send, in whole tokens --token <token> ticker or address to send (default: native ETH) -h, --help display help for command
hood faucet
Print testnet faucet instructions + current testnet balances
Usage: hood faucet [options] Print testnet faucet instructions + current testnet balances Options: -h, --help display help for command
hood deploy-token
Deploy a fixed-supply ERC-20 from a JSON config (direct-rail, no launchpad)
Usage: hood deploy-token [options]
Deploy a fixed-supply ERC-20 from a JSON config (direct-rail, no launchpad)
Options:
--config <path> path to a JSON file: { name, symbol, decimals?,
initialSupply }
--execute sign and send (default: print the plan only) (default:
false)
-h, --help display help for command
hood config
Manage hood-cli settings (rpc, wallet, network)
Usage: hood config [options] [command]
Manage hood-cli settings (rpc, wallet, network)
Options:
-h, --help display help for command
Commands:
set <key> [value] set a config value (network, rpc, testnetRpc, alchemyKey,
maxSpendUsd, wallet)
get <key> print one config value
list print the full config (secrets masked)
help [command] display help for command
hood init
interactive setup wizard: wallet, LLM key (hood-traders), and Telegram/X
Usage: hood init [options]
interactive setup wizard: wallet, LLM key (hood-traders), and Telegram/X
(hood-alerts)
Options:
--out <dir> directory to write hood-traders.env / hood-alerts.env into
(default: ".")
-h, --help display help for command
Guard rails
Every write defaults to a dry run. Nothing signs without an explicit gate.
--execute required
Swaps, transfers, and deploys print a plan by default. Nothing is sent until you pass --execute.
Interactive confirm
Even with --execute, a yes/no prompt renders the recipient, amount, and network before signing — skip it only with --yes.
Stock Token eligibility
Stock Tokens are tokenized securities. Acquiring one requires --acknowledge-eligibility — an explicit operator affirmation, never assumed.
Spend cap
hood config set maxSpendUsd <n> refuses any swap or transfer whose estimated USD value exceeds your cap.
Encrypted keystore
Wallet keys are AES-256-GCM encrypted under a scrypt-derived password — never plaintext on disk.
Meaningful exit codes
Scriptable: 2 = bad usage, 3 = network, 4 = guard refused, 5 = not found, 6 = wallet needed.