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:

bun -e '
import { getClient } from "robinhood-for-agents";
const rh = getClient();
await rh.restoreSession();
// call any method, print results as JSON
const holdings = await rh.buildHoldings();
console.log(JSON.stringify(holdings, null, 2));
'

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

Always confirm before placing any order — show order preview, get explicit "yes"
Show current price before order confirmation so user knows the cost
Never place orders without user confirmation
Fund transfers and bank operations are BLOCKED — refuse these requests
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
`restoreSession()`	Auth	Restore/validate session (throws if not authenticated)
`getAccountProfile()`	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

Robinhood for Agents