rhood-core

Async Rust client library for the Robinhood trading API.

Powers the rhood-cli terminal app and the rhood-mcp Model Context Protocol server.

This is an unofficial, community-driven project and is not affiliated with, endorsed by, or supported by Robinhood Markets, Inc. Use at your own risk.

Features

Authenticated HTTP client (RobinhoodClient) with disk-backed token cache and OAuth refresh.
Endpoint coverage for stocks, options, futures, indices, orders, account, watchlists, recurring investments, dividends, transfers, and research.
Typed error model (RhoodError) covering challenges, rate limits, read-only mode, and API errors.
Configuration via TOML files, environment variables, or programmatic construction.

Configuration and Safety

The client defaults to read-only mode. Configuration can come from ~/.config/rhood/config.toml, environment variables, or direct RhoodConfig construction. See config.toml.example for all fields.

On Unix, configuration and secret files containing credentials must grant access only to their owner. Cached OAuth tokens are written with owner-only permissions and replaced atomically so a failed refresh does not destroy the previous session.

Example

use rhood_core::RobinhoodClient;

# async fn run() -> rhood_core::Result<()> {
let client = RobinhoodClient::new()?;
client.login_from_cache().await?;

let quotes = client.get_quotes(&["AAPL", "TSLA"]).await?;
for quote in quotes {
    println!("{:?}: {:?}", quote.symbol, quote.last_trade_price);
}
# Ok(())
# }

See the API documentation for the full reference.

Verification

cargo test -p rhood-core --all-features
cargo clippy -p rhood-core --all-targets --all-features -- -D warnings

License