robinhood-for-agents

AI-native Robinhood trading interface. No MCP server required — this skill works standalone via the TypeScript client API and bun.

How to Use

Run Robinhood operations by executing TypeScript code with bun. The robinhood-for-agents npm package provides a full client library — just import it and call methods:

CODEBLOCK0

See client-api.md for all available methods and signatures.

MCP users: If you have the robinhood-for-agents MCP server configured, you may use MCP tools instead. See reference.md for tool parameters. MCP is optional — the client API above does everything the MCP tools do.

CRITICAL SAFETY RULES

1. 1. Always confirm before placing any order — show order preview, get explicit "yes"
2. Show current price before order confirmation so user knows the cost
3. Never place orders without user confirmation
4. Fund transfers and bank operations are BLOCKED — refuse these requests
5. Never place bulk cancel operations — cancel orders one at a time

BLOCKED Operations (never use)

• - Bulk cancel operations
• Fund transfers (withdraw/deposit)
• Bank unlinking

Routing

User Intent	Domain File	Example Triggers
Auth / login / connect	setup.md	"setup robinhood", "connect to robinhood", "robinhood login"
Portfolio / holdings / positions

portfolio.md | "show my portfolio", "my holdings", "account summary" | | Stock research / analysis | research.md | "research AAPL", "analyze TSLA", "due diligence on NVDA" | | Buy / sell / orders / cancel | trade.md | "buy 10 shares of AAPL", "sell my TSLA", "cancel my order" | | Options / calls / puts / chains | options.md | "show AAPL options", "SPX calls", "0DTE options", "covered calls" |

Read the corresponding domain file for detailed workflow instructions.

Authentication Prerequisite

Before any data-fetching or trading operation, verify the session is active:

bun -e 'import { getClient } from "robinhood-for-agents"; const rh = getClient(); await rh.restoreSession(); console.log("ok");'

If it throws, follow setup.md to authenticate.

Client Method Inventory

Method	Category	Description
INLINECODE4	Auth	Restore/validate session (throws if not authenticated)
INLINECODE5

Account | Account details and preferences | | getAccounts() | Account | All brokerage accounts | | buildHoldings(opts?) | Portfolio | Holdings with P&L, equity, buying power | | getCryptoPositions() | Crypto | Crypto holdings | | getCryptoQuote(symbol) | Crypto | Current crypto price | | getQuotes(symbols) | Research | Stock quotes (price, bid/ask, P/E) | | getFundamentals(symbols) | Research | Market cap, 52-week range, sector | | getNews(symbol) | Research | Recent news articles | | getRatings(symbol) | Research | Analyst buy/hold/sell ratings | | getEarnings(symbol) | Research | Quarterly EPS history | | getStockHistoricals(symbols, opts?) | Research | OHLCV price history | | findInstruments(query) | Research | Search stocks by keyword | | getChains(symbol) | Options | Option chain expirations | | findTradableOptions(symbol, opts?) | Options | Option instruments by expiration/strike/type | | getOptionMarketData(symbol, exp, strike, type) | Options | Greeks and pricing | | getIndexValue(symbol) | Options | Current index value (SPX, NDX, etc.) | | getMovers() | Markets | Top market movers | | orderStock(symbol, qty, side, opts?) | Trading | Place stock order | | orderOption(symbol, legs, price, qty, dir, opts?) | Trading | Place option order | | orderCrypto(symbol, side, amount, opts?) | Trading | Place crypto order | | getAllStockOrders() / getOpenStockOrders() | Trading | View stock orders | | cancelStockOrder(id) | Trading | Cancel stock order | | getStockOrder(id) | Trading | Check order fill status |

Important Notes

• - Do NOT use phoenix.robinhood.com — use api.robinhood.com endpoints only
• Multi-account is first-class: always ask which account when multiple exist
• Session tokens expire ~24h; the client auto-refreshes before requiring re-auth