robinhood-for-agents

Authenticate with Robinhood by opening Chrome to the real login page. The user logs in normally (including MFA). This is the only way to authenticate — no credentials are passed through the tool.

Check if there is a valid cached Robinhood session. Returns session status without opening a browser or requiring credentials.

List your own Robinhood watchlists (custom lists). Returns each list's metadata including its `id` (UUID) — pass that id to robinhood_get_watchlist_items, robinhood_add_to_watchlist, or robinhood_remove_from_watchlist. Does not include the lists' items. For Robinhood-curated lists, use robinhood_get_popular_watchlists.

List the items in a watchlist by list_id. Items are enriched with `symbol` and `name`; `object_type` distinguishes stocks/ETFs (instrument), market indexes (index), and crypto pairs (currency_pair). Does not return live prices — call robinhood_get_stock_quote for those. For the options watchlist use robinhood_get_option_watchlist instead. An unknown list_id returns an error.

Discover Robinhood-curated watchlists (e.g. '100 Most Popular', 'Daily Movers'). Returns each list's metadata including its `id` (UUID); pass an id to robinhood_get_watchlist_items to see its members. Paginated results are fully collected.

List the single-leg option contracts on your options watchlist. Each entry has the underlying (chain_symbol), a human name, its watchlist object_id, and the option_id you'd pass to robinhood_remove_option_from_watchlist. Multi-leg strategies (e.g. from app-side order placement) are listed with a null option_id and can't be modified here — view those in the Robinhood app. For equity/index/crypto watchlists use robinhood_get_watchlist_items instead.

Create a new (empty) watchlist for the user. Returns the created list including its new `id` (use that id with robinhood_add_to_watchlist to populate it). CONFIRM WITH THE USER before calling — this creates a list on the user's account. To add symbols, follow up with robinhood_add_to_watchlist.

Update a watchlist's own metadata — its name, description, or emoji. Provide the list_id and at least one field to change; omitted fields are left unchanged. This does NOT add or remove items (use robinhood_add_to_watchlist / robinhood_remove_from_watchlist for those). CONFIRM WITH THE USER before calling — this mutates the user's watchlist.

Add items to one of your watchlists. Provide exactly one of: symbols (stocks/ETFs), currency_pair_ids (crypto), or index_ids (market indexes) — mutually exclusive. Already-present items are no-ops. For options use robinhood_add_option_to_watchlist. CONFIRM WITH THE USER before calling — this mutates the user's watchlist.

Remove items from one of your watchlists. Provide exactly one of: symbols (stocks/ETFs), currency_pair_ids (crypto), or index_ids (market indexes) — mutually exclusive. Items not on the list are reported as not_present (not an error). CONFIRM WITH THE USER before calling — this mutates the user's watchlist.

Follow a Robinhood-curated list so it appears in your watchlists. Use only for curated lists (from robinhood_get_popular_watchlists) — you already own your custom lists. Following an already-followed list is a no-op. CONFIRM WITH THE USER before calling — this adds the list to the user's account.

Stop following a Robinhood-curated list. The list itself is unchanged — it just no longer appears in your watchlists. Unfollowing a list you don't follow is a no-op. CONFIRM WITH THE USER before calling.

Add option contracts to your options watchlist. Each option_id becomes a single-leg contract. Source option_ids from robinhood_get_options / robinhood_get_option_instruments. Already-present contracts are reported as already_present (no duplicate is created). Only position_type "long" is supported over this path (short-leg watchlist entries must be added via the Robinhood app). CONFIRM WITH THE USER before calling — this is a real write.

Remove option contracts from your options watchlist. Provide the option_ids (from robinhood_get_option_watchlist). Contracts not on the list are reported as not_present, not an error. Only position_type "long" is supported over this path. CONFIRM WITH THE USER before calling.

Get complete portfolio: positions with P&L, equity, buying power, cash.

Get raw equity positions (shares, average buy price, per-account) without holding enrichment.

Get all brokerage accounts (multi-account support).

Get account details, profile, and investment preferences.

Get options chain with greeks for a stock or index symbol (SPX, NDX, VIX, RUT, XSP supported).

Get open option positions. Per-leg by default, or grouped by strategy (spreads, condors).

Get option order history (filled, cancelled, and open multi-leg orders) — the dedicated, official-parity option order-history view: no account_number scoping, no result limit (mirrors Robinhood's own option-orders tool exactly). Prefer robinhood_get_orders when you need account_number scoping, a result limit, or a single tool that also covers stock/crypto order history.

Get historical OHLC price series for a specific option contract.

Realized profit & loss for an account over a time window — bucketed realized gain and the number of closing trades per bucket, plus window totals. COMPUTED by this server from your order history (Robinhood has no realized-P&L REST endpoint): equity uses independent economic FIFO including fees (not Robinhood's booked/tax number), crypto uses Robinhood's native gain_loss, and options are NOT included. rate_of_realized_gain and total_rate_of_return are returned as null — see the result `note`. Fetches full order history, so it can be slow on large accounts. For the per-trade list use robinhood_get_pnl_trade_history.

Per-trade realized profit & loss — a chronological list of closing trades with symbol, side, quantity, price, and realized gain/loss. COMPUTED by this server from your order history: equity uses independent economic FIFO including fees (not Robinhood's booked/tax number), crypto uses Robinhood's native gain_loss, and options are NOT included. Results are complete (next_cursor is always null). For bucketed totals use robinhood_get_realized_pnl.

Simulate a stock order WITHOUT placing it — the required 'review' step before robinhood_place_stock_order. Returns the order echoed back, the live quote (so the user sees the cost), and order_checks: a reproduction of Robinhood's price collar that flags a mis-priced limit/stop order (e.g. a buy limit far above the market). order_checks is {} only when the collar ran and found no problem — read evaluated_checks/not_evaluated_checks to see what was and wasn't checked. Nothing is placed. ALWAYS show the review to the user before placing.

Simulate a single- or multi-leg option order WITHOUT placing it — the required 'review' step before robinhood_place_option_order. Returns the order echoed back with per-leg market data (mark/bid/ask/greeks) and the collateral the order would require. Nothing is placed. The reproduced check set is intentionally thin for options (see not_evaluated_checks) — options have no simple last-trade price collar. ALWAYS show the review to the user before placing.

List the open tax lots for one equity holding in an account — each lot is a separate acquisition with its own quantity, cost basis, acquisition date, and long/short-term status (`term`). Use it for cost-basis, holding-period, or which-lots-would-sell questions. Requires a symbol (tax lots are tracked per instrument, one symbol per call). Results are complete — all lots are returned and `next_cursor` is always null.

List every valid scanner filter type and how to use it — the vocabulary for building a scan (fundamentals, price/volume, options, and technical indicators like RSI/MACD/EMA), each with its supported predicates, unit, and any supported lengths/intervals/plots. Call this before constructing scan filters; do not guess filter_type names. Note: this catalog is served from a static snapshot captured from Robinhood's official scanner service (it is account-agnostic and rarely changes), not a live per-request read — see the `note` in the result.

List your saved scanners (also called screeners) — each a saved set of filters and columns that screens the market (e.g. 'RSI > 70 and Volume > 1M'). Returns one entry per scan; empty when you have none (you create scans in Robinhood Legend). Each entry gives `scan_id`, `title`, and `column_count` derived from Robinhood's data, plus the complete raw scan under `raw`. The official fields `filter_summary`, `cortex_managed`, and `sorting` are rendered by Robinhood's own service and are returned as null here — see the result's `note`.

Get crypto price data, history, and positions.

Get a live quote plus fundamentals for one or more stock or index tickers (SPX, NDX, VIX, RUT, XSP supported). Use this when you need the current price. For fundamentals only (no live quote), use robinhood_get_fundamentals.

Get OHLCV price history for one or more stock tickers.

Get company fundamentals for one or more stocks: float, shares outstanding, market cap, P/E and P/B ratios, dividend schedule, 52-week range, and company profile (sector, industry, CEO, description). Fundamentals only — no live quote; use robinhood_get_stock_quote if you also need the current price.

Get Robinhood's daily short-interest time series for a stock: modeled shares sold short and short interest as a percent of free float, each with upper/lower confidence bounds. NOTE: this is a modeled DAILY estimate (hence the bounds), NOT the official biweekly FINRA settlement figure. `pc_freefloat` is a percent (e.g. 8.23 = 8.23%). Omitting start_date returns the full available history (RH's series began ~mid-2025).

Get news, analyst ratings, and earnings for a stock symbol.

Search stocks by keyword or browse by market category tag.

Get the Level-2 price book (aggregated bid/ask depth) for a stock. Depth is populated during market hours.

Get historical and upcoming earnings (EPS estimate vs. actual, report date/timing) for one symbol.

Get the market-wide earnings calendar for a window of days (all reporting companies).

Get tradability flags (tradeable, fractional, short-selling, per-account) for one or more symbols.

Place a stock order. Requires explicit parameters — no dangerous defaults. Always confirm with the user before calling. Short selling: use side 'sell_short' to open a short (NOT 'sell', which only closes an existing long and is rejected with 'Not enough shares to sell.'). Close a short with an ordinary 'buy'.

Place a single-leg or multi-leg option order (verticals, iron condors, straddles, etc.). Always confirm with the user before calling.

Place a crypto order. Always confirm with the user before calling.

Get order history for stocks, options, or crypto in one generic tool — supports account_number scoping, open/all status filtering, and a result limit (default 50, 0 for unlimited). Prefer robinhood_get_option_orders when you want the complete, unlimited, official-parity option order history without account scoping.

Cancel a pending order by its ID.

Get the current status of a specific order by its ID.

Get market movers and popular stocks.

Get market hours for a date: whether it is a trading day, and when the regular and extended sessions open and close (ISO timestamps). Call this before placing an order when you are unsure which session is live — robinhood_place_stock_order requires an explicit market_hours, and guessing from the local clock gets it wrong across time zones, weekends, and holidays.

Get all tradable market indexes (SPX, NDX, VIX, RUT, XSP, …).

Get current values for one or more index symbols.