hood-cli

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.

$ npm install -g hood-cli
hood — chain 4663 mainnet

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

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.